核心用法
ChatClaw 是一个后台常驻桥接组件,用于将本地 OpenClaw 智能体安全连接到 ChatClaw 云端仪表盘。启用后,用户可在任意浏览器或移动设备上与代理实时对话、监控 Token 消耗并管理任务,全程无需开放端口或配置防火墙。
工作机制
- 云端中继: 通过
wss://api.sumeralabs.com建立纯出站 WebSocket 连接,实现双向实时消息流转 - 本地网关: 经
ws://localhost:18789完成 Ed25519 认证握手,再通过 HTTP SSE 流式传输聊天内容 - 零配置接入: 首次启用时自动修改
openclaw.json开启/v1/chat/completions端点,禁用时智能回滚
显著优点
1. 网络零暴露: 纯出站连接设计,彻底消除端口转发和防火墙配置负担
2. 实时流式体验: Token 级实时回传, Dashboard 呈现打字机效果
3. 跨平台兼容: 支持 Docker/VPS/macOS 等多环境,自动适配路径差异
4. 高可用重连: 指数退避自动重连(5s→60s),连接中断不退出
5. 极简部署: 支持 OpenClaw Control UI 一键安装,或代理辅助全自动配置
潜在局限与风险
- 供应商锁定: 依赖 SumeraLabs 运营的中继基础设施,自托管需额外配置
- 版本耦合: v0.3.0+ 强制要求 OpenClaw v2026.3.28+,旧版本需降级使用
- 本地文件修改: 运行时读写
openclaw.json及身份凭证文件,需确保文件权限安全 - 数据留存: 消息历史由 ChatClaw 后端(Supabase)持久化,非完全本地优先
适合人群
- 需要远程管理本地 AI 代理的开发者与运维人员
- 追求零配置、免防火墙方案的个人用户
- 希望实时监控 Token 消耗以控制成本的技术团队
常规风险
- API 密钥泄露将导致云端会话被劫持
- 网关认证失败可能源于过期的 Operator Token
- 首次使用需发送一条消息后才能显示 Token 计数
- 网络不稳定时可能经历最多 60 秒重连等待期