ChatClaw — Dashboard — ChatClaw — 仪表盘
v1将您的 OpenClaw 机器人连接到 ChatClaw 云控制台 — 远程聊天、token 跟踪、任务管理、代理工作空间文件浏览(只读)和技能管理(列表、启用/禁用、重新安装)
运行时依赖
版本
v0.3.0 (2026-03-30)
安装命令
点击复制技能文档
ChatClaw ChatClaw 是一个持续运行在后台的桥接器,连接您的本地 OpenClaw 代理到 ChatClaw 云控制面板。一旦安装并启用,它会自动运行与 OpenClaw 并允许您与代理聊天,监控令牌使用情况,并从任何浏览器或移动设备管理任务 —— 无需暴露任何端口或配置防火墙。
它的作用 透明度说明:云中继端点(api.sumeralabs.com)由 SumeraLabs 运营,SumeraLabs 是 ChatClaw 的公司。chatclaw.sumeralabs.com 是产品域;sumeralabs.com 是基础设施域。两者都由同一个团队拥有和运营。 启用 ChatClaw 时,会打开两个连接: 云中继 —— 到 wss://api.sumeralabs.com/ws/agent/{api_key} 的出站 WebSocket 连接。这是控制面板与技能通信的方式。它是一个纯粹的出站连接,无需入站端口转发。 本地网关 —— 一个到 ws://localhost:18789 的 WebSocket 连接,用于 Ed25519 身份验证,以及到 http://localhost:18789/v1/chat/completions 的 HTTP SSE 调用,用于所有聊天流量。HTTP 端点在首次启动时自动在 openclaw.json 中启用。 消息双向实时流动。从控制面板发送的用户消息通过 HTTP SSE 流式传输转发到 OpenClaw 代理。代理的每个响应令牌都会实时转发回控制面板,产生实时打字效果。
权限和功能 本节完全披露技能在响应云中继消息时可以执行的每个操作。所有操作都需要有效的 ChatClaw API 密钥;中继在任何消息到达技能之前拒绝未经身份验证的连接。 功能 触发消息 范围 备注 聊天中继 任何包含文本/内容字段的消息 将文本发送到 OpenClaw 代理通过 HTTP SSE,流式传输响应回控制面板 核心功能 文件列表 files.list 只读;返回代理工作空间的文件元数据通过网关 RPC(agents.files.list) 不返回文件内容 文件读取 files.get 只读;返回命名工作空间文件的内容通过网关 RPC(agents.files.get);作用域为 agentId: "main" 工作空间 每个请求都记录了文件名 技能列表 skills.list 运行 openclaw skills list --json 本地;返回技能元数据 只读 启用/禁用技能 skills.set_enabled 运行 openclaw config set skills.entries..enabled true/false;影响本地 OpenClaw 配置 每次调用都记录了技能名称和新状态 重新安装技能 skills.reinstall 运行 clawhub install --force;从 ClawHub 注册表替换技能文件 每次调用都记录了技能名称
为什么需要操作员级别的凭据: 网关使用 Ed25519 设备身份验证和操作员作用域(operator.admin、operator.approvals、operator.pairing)。这需要 OpenClaw 网关握手协议来建立身份验证连接 —— 没有更低权限的连接模式用于技能桥接。操作员令牌从 device-auth.json 中读取,并仅用于初始 WebSocket 握手;它永远不会传输到云中继。
安全缓解措施: 所有功能都需要在云中继层验证有效的 API 密钥,然后才能到达技能 文件访问是只读的,并通过网关 RPC(agentId: "main")作用域为代理工作空间 启用/禁用技能和重新安装在每次调用时都记录在本地 没有执行带有用户控制参数的 shell 命令 —— 技能名称和文件名称作为位置参数传递给受控子进程调用,而不是插入到 shell 字符串中 禁用此技能会还原 openclaw.json 中它所做的任何更改
架构 ChatClaw 控制面板(浏览器/移动)↕ wss://api.sumeralabs.com ChatClaw 云中继(FastAPI)↕ wss://api.sumeralabs.com/ws/agent/{api_key} ChatClaw 技能 ←— 本包 ↕ ws://localhost:18789(身份验证握手,Ed25519)↕ http://localhost:18789/v1/chat/completions(SSE 流式传输) OpenClaw 网关 ↕ OpenClaw 代理(LLM)
要求 OpenClaw:v2026.3.28 或更高版本 Python:3.8+ 依赖项:websockets、cryptography、aiohttp 重要:ChatClaw v0.3.0+ 需要 OpenClaw v2026.3.28 或更高版本,因为身份验证发生了变化。如果您使用的是旧版本的 OpenClaw,请升级 OpenClaw 或使用 ChatClaw v0.2.9(遗产)。
安装 通过 OpenClaw 控制 UI(推荐) 打开控制 UI tại http://localhost:18789 转到技能 → 市场 搜索 ChatClaw 点击安装,输入 API 密钥,点击启用 注意:在首次启用时,技能会自动在 openclaw.json 中设置 gateway.http.endpoints.chatCompletions.enabled = true。如果技能进行了此更改,禁用它将自动还原。如果 chatCompletions 在安装之前已经启用,技能在禁用时将保持配置不变。 技能会立即启动,并在每次后续启动时自动启动 OpenClaw。
通过 OpenClaw CLI npx clawhub install