← Back to Skills Marketplace
wolful

酒店管家

by wolful · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ⚠ suspicious
291
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install hotel-manager
Description
酒店管家 Skill - 管理酒店 OTA 基础信息、房价库存及订单同步。
README (SKILL.md)

Hotel Manager Skill

本 Skill 为酒店管理人员提供多平台(OTA)统一管理方案,支持 API 自动化浏览器自动化 双模式。

[!IMPORTANT] 本仓库目前提供的是 集成架构模板。在使用前,您需要根据特定平台的 API 文档完善 scripts/ota_client.js 中的协议细节。

安全与隐私 (Security)

为了保护您的 API 密钥,本 Skill 采用以下安全策略:

  1. 环境变量优先:强烈建议通过环境变量配置凭证。
  2. 浏览器沙箱:UI 自动化模式利用 Agent 已有的浏览器会话,不需本地存储明文密码。
  3. 安全传输:脚本强制使用 HTTPS 请求。

配置指南

方法 A: 环境变量 (推荐 API 模式)

设置 OTA_CTRIP_API_KEY 等变量。详细列表见上方元数据。

方法 B: UI 自动化模式 (无 API 时)

无需特殊 API 配置,Agent 将直接操作浏览器。参考 scripts/browser_controller.js 了解 SOP。

核心功能

  1. OTA 基础信息管理:同步酒店描述、设施等。
  2. 日常价库调整:支持批量 API 更新及智能体 直接改价(浏览器模拟)
  3. 房态控制:快速开关特定房型,支持跨平台同步。
  4. 自动接单同步:一键开启订单抓取并推送到内部系统。

操作模式

1. API 模式

高速执行,适用于大型酒店连锁。逻辑位于 scripts/ota_client.js

2. 浏览器直接改价 (Visual Mode)

适用于无法获取 API 权限的小型客栈或特殊 OTA 平台。

  • Agent 执行逻辑:打开对应的 OTA 后台网页 -> 自动定位改价区 -> 执行修改并截图存证。
  • 详见scripts/browser_controller.js

权限说明

  • 网络访问:访问 OTA 后台及内部 API。
  • 浏览器权限:需要读写及点击操作权限。

最佳实践

  • 操作留痕:UI 模式下建议 Agent 在每次改价后提供页面截图。
  • 速率限制:避免过快操作导致封禁,脚本预留了休眠策略。
Usage Guidance
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.
Capability Analysis
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.
Capability Assessment
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.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install hotel-manager
  3. After installation, invoke the skill by name or use /hotel-manager
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
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。 - 提供详细使用说明与操作脚本示例。 - 强调数据备份、并发控制、同步校验等最佳实践。
Metadata
Slug hotel-manager
Version 1.0.1
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 2
Frequently Asked Questions

What is 酒店管家?

酒店管家 Skill - 管理酒店 OTA 基础信息、房价库存及订单同步。 It is an AI Agent Skill for Claude Code / OpenClaw, with 291 downloads so far.

How do I install 酒店管家?

Run "/install hotel-manager" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is 酒店管家 free?

Yes, 酒店管家 is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does 酒店管家 support?

酒店管家 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created 酒店管家?

It is built and maintained by wolful (@wolful); the current version is v1.0.1.

💬 Comments