README.md

metadata

title: OpenClaw AI Gateway
emoji: 🦞
colorFrom: blue
colorTo: indigo
sdk: docker
app_port: 18888
pinned: false

OpenClaw HF Deployment

HF部署OpenClaw，持久化、多Agent、飞书/微信集成

架构概览

组件	功能
Dockerfile	系统依赖、Python包、OpenClaw安装（全部固化）
backup-manager.py	WebDAV + HF Dataset 双备份、增量备份、调度器
config-generator.py	配置生成、Agent管理、飞书通道
start-openclaw.sh	11阶段启动编排（无运行时安装）
scripts/	辅助脚本集合

启动优化

所有程序已固化在Docker镜像中，重启容器无需重新安装：

• 系统依赖（git, jq, vim, wget等）
• Python包（huggingface_hub, requests, pyyaml等）
• OpenClaw CLI（npm全局安装）
• CC-Switch-Web（预编译二进制）

启动时仅做：验证安装 → 恢复备份 → 生成配置 → 启动服务

11阶段启动流程

1. 创建持久化目录
2. 验证已安装程序（不重新安装）
3. 恢复备份
4. 生成配置
5. 微信激活（默认启用）
6. 飞书设置
7. 创建5个Agent + 绑定飞书
8. 启用Skills
9. CC-Switch-Web启动 (端口3000)
10. 启动备份守护进程
11. 启动OpenClaw Gateway (端口18888)

环境变量

必需

• HF_TOKEN - HuggingFace API Token

可选 - LLM配置

• LLM_PROVIDER - 提供商 (openai/anthropic/azure)
• LLM_MODEL - 模型名称
• LLM_API_KEY - API密钥
• LLM_BASE_URL - 基础URL

可选 - 备份配置

• WEBDAV_URL - WebDAV服务器URL
• WEBDAV_USERNAME - WebDAV用户名
• WEBDAV_PASSWORD - WebDAV密码
• HF_BACKUP_REPO - HF Dataset仓库名

可选 - 飞书配置 (支持5个机器人)

• FEISHU_APP_ID_1 ~ FEISHU_APP_ID_5 - 飞书App ID
• FEISHU_SECRET_1 ~ FEISHU_SECRET_5 - 飞书App Secret

可选 - Agent配置 (支持5个Agent)

• AGENT_1_NAME ~ AGENT_5_NAME - Agent名称
• AGENT_1_DESCRIPTION ~ AGENT_5_DESCRIPTION - Agent描述
• AGENT_1_PROMPT ~ AGENT_5_PROMPT - 系统提示词

可选 - 功能开关

• WEIXIN_ENABLED - 微信集成 (默认: true)
• SKILLS_ENABLED - Skills功能 (默认: true)
• CCSWITCH_ENABLED - CC-Switch集成 (默认: true)

可选 - CC-Switch-Web 认证配置

• CCSWITCH_USERNAME - CC-Switch-Web 用户名 (默认: admin)
• CCSWITCH_PASSWORD - CC-Switch-Web 密码 (重要：必须设置！)

注意：CC-Switch-Web 需要设置密码才能访问。请在 HF Space Settings 的 Secrets 中添加 CCSWITCH_PASSWORD。

可选 - 微信配置

• WECHAT_TOKEN - 微信Token（快速激活模式）
• WECHAT_APPID - 微信AppID（完整安装模式）
• WECHAT_SECRET - 微信AppSecret（完整安装模式）

注意：微信默认启用。首次配置时需要扫描二维码进行登录绑定。

访问地址

• 主入口: https://sharween-xiaoxiaxia.hf.space/ (OpenClaw Gateway)
• CC-Switch-Web: https://sharween-xiaoxiaxia.hf.space/ccswitch/ (需要认证)

端口

• 18888 - OpenClaw Gateway (主入口)
• 3000 - CC-Switch-Web (内部)
• 18889 - OpenClaw 直接端口 (内部)

部署

1. 在HF创建Docker类型的Space
2. 设置所有必需的Secrets
3. 在Secrets中添加 CCSWITCH_PASSWORD 设置访问密码
4. 如需微信，设置 WECHAT_TOKEN 或 WECHAT_APPID + WECHAT_SECRET
5. 构建并启动

备份策略

• 每小时 - 增量备份 (SHA256对比)
• 每天02:00 - 全量备份
• 双存储 - WebDAV + HF Dataset