← 返回 Skills 市场
291
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install hotel-manager
功能描述
酒店管家 Skill - 管理酒店 OTA 基础信息、房价库存及订单同步。
使用说明 (SKILL.md)
Hotel Manager Skill
本 Skill 为酒店管理人员提供多平台(OTA)统一管理方案,支持 API 自动化 与 浏览器自动化 双模式。
[!IMPORTANT] 本仓库目前提供的是 集成架构模板。在使用前,您需要根据特定平台的 API 文档完善
scripts/ota_client.js中的协议细节。
安全与隐私 (Security)
为了保护您的 API 密钥,本 Skill 采用以下安全策略:
- 环境变量优先:强烈建议通过环境变量配置凭证。
- 浏览器沙箱:UI 自动化模式利用 Agent 已有的浏览器会话,不需本地存储明文密码。
- 安全传输:脚本强制使用 HTTPS 请求。
配置指南
方法 A: 环境变量 (推荐 API 模式)
设置 OTA_CTRIP_API_KEY 等变量。详细列表见上方元数据。
方法 B: UI 自动化模式 (无 API 时)
无需特殊 API 配置,Agent 将直接操作浏览器。参考 scripts/browser_controller.js 了解 SOP。
核心功能
- OTA 基础信息管理:同步酒店描述、设施等。
- 日常价库调整:支持批量 API 更新及智能体 直接改价(浏览器模拟)。
- 房态控制:快速开关特定房型,支持跨平台同步。
- 自动接单同步:一键开启订单抓取并推送到内部系统。
操作模式
1. API 模式
高速执行,适用于大型酒店连锁。逻辑位于 scripts/ota_client.js。
2. 浏览器直接改价 (Visual Mode)
适用于无法获取 API 权限的小型客栈或特殊 OTA 平台。
- Agent 执行逻辑:打开对应的 OTA 后台网页 -> 自动定位改价区 -> 执行修改并截图存证。
- 详见:
scripts/browser_controller.js。
权限说明
- 网络访问:访问 OTA 后台及内部 API。
- 浏览器权限:需要读写及点击操作权限。
最佳实践
- 操作留痕:UI 模式下建议 Agent 在每次改价后提供页面截图。
- 速率限制:避免过快操作导致封禁,脚本预留了休眠策略。
安全使用建议
This skill appears to implement the advertised OTA management features, but review these before installing:
- Metadata mismatch: The registry entry claims no required env vars, but SKILL.md and config.js expect several secrets (OTA_CTRIP_API_KEY, OTA_MEITUAN_API_KEY, INTERNAL_PMS_URL, INTERNAL_PMS_TOKEN). Treat those env vars as required unless the author fixes the metadata.
- Config file: By default the code will try to read a local config file at resources/ota_config.json (or a path via HOTEL_MANAGER_CONFIG_PATH). Make sure any config files do not contain real secrets in a shared repo, or set env vars instead.
- Browser automation: UI mode will instruct an agent-controlled browser to log in, click, edit fields and take screenshots. If you enable that mode, ensure the agent or environment is trusted and that screenshots won't be stored or transmitted to unintended locations.
- Network endpoints: The OTA client will make HTTPS calls to platform endpoints and (if configured) to your internal PMS URL. Verify those endpoints are correct and that you trust the skill source before providing credentials.
If you are not able to verify the author/source, run the skill in an isolated environment, remove sensitive credentials from repository files, and consider providing only the minimum-permission credentials required by the OTAs/PMS. If you want higher assurance, ask the publisher to correct the registry metadata and to document HOTEL_MANAGER_CONFIG_PATH and the exact set of env vars used.
功能分析
Type: OpenClaw Skill
Name: hotel-manager
Version: 1.0.1
The hotel-manager skill is a legitimate integration tool for managing hotel data across OTA platforms like Ctrip and Meituan. It uses standard Node.js practices for API interaction (ota_client.js) and provides structured SOPs for browser-based automation (browser_controller.js). Sensitive credentials are appropriately handled via environment variables or local configuration files (config.js), and no evidence of malicious intent, data exfiltration, or unauthorized execution was found.
能力评估
Purpose & Capability
Name/description, SKILL.md, and the included scripts (OTA client, price manager, order sync, browser controller) are coherent for an OTA hotel manager. However the registry metadata at the top claims 'Required env vars: none' while SKILL.md + scripts expect several environment variables (OTA_CTRIP_API_KEY, OTA_MEITUAN_API_KEY, INTERNAL_PMS_URL, etc.). This metadata mismatch is inconsistent and should be corrected.
Instruction Scope
SKILL.md instructs the agent to use either API mode (via env vars) or UI/browser automation. The browser automation mode explicitly directs the agent to open OTA backend pages, click, edit fields, and take screenshots — which is within the stated purpose but grants the agent broad UI privileges and access to sensitive pages/screens. The instructions also assume a local config file (resources/ota_config.json) may be read if env vars are not set; SKILL.md mentions configuration but does not document the HOTEl_MANAGER_CONFIG_PATH env var used by the code.
Install Mechanism
No install spec is present (instruction-only + shipped scripts). Nothing in the manifest downloads or executes external installers; risk from the install mechanism is low. The code is included in the skill bundle and would run as-is when invoked.
Credentials
The scripts legitimately need OTA API keys and an internal PMS URL/token for their functions, and SKILL.md lists these env vars. But registry metadata does not declare them as required, and the code also reads HOTEL_MANAGER_CONFIG_PATH and a default local config file (resources/ota_config.json) which were not declared as required config paths. That mismatch increases the chance a user will overlook where secrets might be loaded from. Also, UI mode may capture screenshots or page contents that could contain sensitive guest data — this is expected for the feature but a sensitive capability that should be explicitly acknowledged.
Persistence & Privilege
The skill does not request 'always: true' or other elevated persistent privileges. It can be invoked autonomously (default) which is normal for skills but note that running order_sync.js can start a periodic sync loop if executed. The skill does not modify other skills or system-wide settings.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install hotel-manager - 安装完成后,直接呼叫该 Skill 的名称或使用
/hotel-manager触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.1
Version 1.0.1
- Switched configuration to use environment variables for OTA credentials, enhancing security.
- Added example/template files for configuration (`resources/ota_config.example.json`), and scripts for browser automation (`scripts/browser_controller.js`) and config management (`scripts/config.js`).
- Removed plaintext default configuration file (`resources/ota_config.json`).
- Updated documentation to reflect dual operation modes (API and browser automation) and improved security practices.
v1.0.0
Hotel Manager Skill 1.0.0 初始发布,助力酒店高效多平台运营:
- 支持 OTA 基础信息统一管理与同步。
- 实现房价、库存批量调整及全局调价规则。
- 一键房态控制及售卖限制设置。
- 自动化订单接收、同步至 PMS/ERP。
- 提供详细使用说明与操作脚本示例。
- 强调数据备份、并发控制、同步校验等最佳实践。
元数据
常见问题
酒店管家 是什么?
酒店管家 Skill - 管理酒店 OTA 基础信息、房价库存及订单同步。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 291 次。
如何安装 酒店管家?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install hotel-manager」即可一键安装,无需额外配置。
酒店管家 是免费的吗?
是的,酒店管家 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
酒店管家 支持哪些平台?
酒店管家 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 酒店管家?
由 wolful(@wolful)开发并维护,当前版本 v1.0.1。
推荐 Skills