GitHub - KingGunFish/OpenChatBot: OpenClaw自搭建聊天插件

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. 启动

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

[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 配对

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

架构

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

开发

构建

测试连接

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

安全提示

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

License

MIT