OpenChatBot

OpenChatBot 是 OpenClaw 的云端消息通道插件，让 AI Agent 可以通过云端 Bridge 与 HarmonyOS OpenClawApp 通信。

特性

• 无需固定公网 IP，主动连接云端 Bridge
• 自动重连和消息队列
• HMAC-SHA256 认证
• 基于机器硬件 ID 生成稳定设备标识

安装

1. 克隆仓库

git clone https://github.com/KingGunFish/OpenChatCloudBridge.git
cd OpenChatBot

2. 安装依赖

npm install
npm run build

3. 配置 OpenClaw

编辑 ~/.openclaw/config.yaml，添加以下配置：

channels:
  openchatbot:
    enabled: true
    cloudBridge:
      endpoint: "ws://YOUR_SERVER_IP:18789"  # 替换为你的服务器 IP
      appId: "your_app_id"                    # 应用 ID
      appSecret: "your_app_secret"            # 密钥 SHA-256 哈希
      deviceName: "My-MacBook"                # 设备显示名称

4. 启动

openclaw

连接成功后，日志会输出：

[OpenChatBot] 已连接云端，Device ID: ocl_xxxxxx

配置说明

配置项	类型	必填	说明
endpoint	string	是	WebSocket 端点地址，如 ws://192.168.1.100:18789
appId	string	是	应用 ID，必须与 App 配置一致
appSecret	string	是	密钥 SHA-256 哈希，必须与 App 配置一致
deviceName	string	是	设备显示名称，在 App 设备列表中显示

与 App 配对

1. 启动 OpenClaw 后，会生成 Device ID（如 ocl_xxxxxx）
2. 在 HarmonyOS OpenClawApp 中：
   • 进入设置 - 设备绑定页面
   • 搜索在线设备
   • 点击绑定设备

架构

OpenClaw (本地)  <--WebSocket-->  Cloud Bridge (服务器)  <--WebSocket-->  OpenClawApp (HarmonyOS)

开发

构建

npm run build

测试连接

node start-bot.cjs

注意：使用前需要修改 start-bot.cjs 中的配置。

安全提示

1. 不要将 appSecret 硬编码在代码中
2. 不要将敏感信息提交到代码仓库
3. 定期更换密钥并更新配置
4. 使用防火墙限制服务器端口访问

License

MIT