OpenClaw 文档
官方文档中文重制版
GitHub Releases
🦞 “蜕壳!蜕壳!”—— 一只太空龙虾,大概会这么说

OpenClaw

一个可运行在任意操作系统上的 AI 代理网关,把 WhatsApp、Telegram、Discord、iMessage 等聊天应用与智能代理连接起来。你发出一条消息,就能随时从口袋里收到代理响应。插件还能扩展 Mattermost 以及更多渠道。

什么是 OpenClaw

OpenClaw 是一个自托管网关,用来把你最常用的聊天应用——例如 WhatsApp、Telegram、Discord、iMessage 等——连接到 AI 编码代理(如 Pi)。你只需在自己的电脑或服务器上运行一个 Gateway 进程,它就会成为消息应用与常驻 AI 助手之间的桥梁。

它主要面向开发者与高级用户,适合那些希望随时随地通过聊天与个人 AI 助手交流、又不愿放弃数据控制权或完全依赖托管服务的人。

它与普通 AI 助手有什么不同
  • 自托管:运行在你的硬件上,规则由你决定。
  • 多渠道:一个 Gateway 同时服务 WhatsApp、Telegram、Discord 等多个聊天入口。
  • 原生面向代理:为具备工具调用、会话、记忆、多代理路由能力的智能代理而设计。
  • 开源:采用 MIT 许可证,由社区共同推进。

你需要准备的内容并不复杂:Node 22 及以上版本、所选模型服务提供商的 API Key,以及大约 5 分钟时间。若希望获得更好的质量与安全性,建议使用较新的强模型。

工作原理

Gateway 是会话管理、消息路由与渠道连接的唯一事实来源。所有接入的聊天渠道都会经过它统一转发,代理、节点与控制界面也都围绕这个中心运行。

聊天渠道

WhatsApp、Telegram、Discord、iMessage 等把消息发送给 Gateway。

Gateway

负责连接、会话、权限、路由、代理分发与消息编排。

AI 代理

调用模型与工具,保留记忆,输出结果,并把响应回传到聊天应用。

关键能力

💬

多渠道网关

一个 Gateway 进程即可同时承载 WhatsApp、Telegram、Discord 与 iMessage。

🧩

插件式渠道扩展

通过扩展包增加 Mattermost 等接入方式,并继续向更多平台延伸。

🧠

多代理路由

可按代理、工作区或发送者进行隔离会话与独立路由。

🖼️

多媒体支持

支持图片、音频与文档的发送与接收,不局限于纯文本交互。

🖥️

Web 控制界面

通过浏览器仪表盘管理聊天、配置、会话与节点状态。

📱

移动节点

可配对 iOS 与 Android 节点,接入 Canvas、相机与语音工作流。

快速开始

1

安装 OpenClaw

命令
npm install -g openclaw@latest
2

执行引导并安装服务

命令
openclaw onboard --install-daemon
3

配对 WhatsApp 并启动 Gateway

命令
openclaw channels login
openclaw gateway --port 18789

如果你需要完整安装说明与开发环境配置,可以继续查看官方 Quick start 页面。

控制台界面

Gateway 启动后,可以打开浏览器中的控制界面。默认本地地址为 http://127.0.0.1:18789/。如果需要远程访问,可结合 Web surfaces 与 Tailscale 等方式。

OpenClaw Control UI
聊天会话
Gateway 配置
节点管理
代理路由
系统日志
帮我检查今天的频道连接状态,并整理出异常项。
正在检查 WhatsApp、Telegram 与 Discord 通道。已发现 1 个节点离线,2 条消息待重试。
请生成一个简短的排查建议。
建议先检查离线节点的配对状态与 API Key 配置,然后查看 Gateway 日志中的重试原因。

配置(可选)

配置文件位于 ~/.openclaw/openclaw.json

  • 如果你不做任何额外配置,OpenClaw 会默认使用内置的 Pi 二进制,以 RPC 模式运行,并按照发送者维持独立会话。
  • 如果你想更严格地控制来源,可以优先配置 channels.whatsapp.allowFrom,并为群聊启用提及规则。
配置示例
{
  channels: {
    whatsapp: {
      allowFrom: ["+15555550123"],
      groups: { "*": { requireMention: true } },
    },
  },
  messages: { groupChat: { mentionPatterns: ["@openclaw"] } },
}

从这里继续

继续了解