OpenClaw 🦞
"去角质！去角质！" — 某只太空龙虾如是说
适用于任何操作系统的 AI 代理网关，支持 WhatsApp、Telegram、Discord、iMessage 等多个平台。 发送消息，即可从口袋里获得代理响应。插件支持 Mattermost 等更多平台。
什么是 OpenClaw？
OpenClaw 是一个自托管网关（self-hosted gateway），它将你喜爱的聊天应用——WhatsApp、Telegram、Discord、iMessage 等——连接到像 Pi 这样的 AI 编程代理。你只需在自己的机器（或服务器）上运行一个网关进程，它就会成为你的消息应用和始终可用的 AI 助手之间的桥梁。
适合谁使用？ 开发者和高级用户，他们希望拥有一个可以随时随地发送消息的个人 AI 助手——而无需放弃对数据的控制或依赖托管服务。
有什么不同？
- ▹自托管：运行在你的硬件上，你说了算
- ▹多渠道：一个网关同时服务 WhatsApp、Telegram、Discord 等多个平台
- ▹原生代理：专为编程代理构建，支持工具使用、会话、内存和多代理路由
- ▹开源：MIT 许可证，社区驱动
需要什么？ Node 22+（点击安装 Node.js）、一个 API 密钥（推荐 Anthropic）和 5 分钟时间。
工作原理
mermaidgraph LR A[WhatsApp/Telegram/Discord] --> B[Gateway] B --> C[AI Agent] C --> B B --> A
网关是会话、路由和渠道连接的唯一真实来源。
核心功能
多渠道网关
使用单个网关进程支持 WhatsApp、Telegram、Discord 和 iMessage。
插件渠道
通过扩展包添加 Mattermost 等更多平台。
多代理路由
每个代理、工作区或发送者的隔离会话。
媒体支持
发送和接收图片、音频和文档。
Web 控制界面
用于聊天、配置、会话和节点的浏览器仪表板。
移动节点
配对 iOS 和 Android 节点，支持 Canvas。
快速开始
1. 安装 OpenClaw
bashnpm install -g openclaw@latest
2. 入门并安装服务
bashopenclaw onboard --install-daemon
3. 配对 WhatsApp 并启动网关
bashopenclaw channels login openclaw gateway --port 18789
需要完整的安装和开发设置？请参阅快速开始。
仪表板
网关启动后打开浏览器控制界面。
- ▹本地默认：http://127.0.0.1:18789/
- ▹远程访问：Web 界面 和 Tailscale
配置（可选）
配置文件位于 ~/.openclaw/openclaw.json。
如果你什么都不做，OpenClaw 会在 RPC 模式下使用捆绑的 Pi 二进制文件，并为每个发送者创建会话。
如果你想锁定它，从 channels.whatsapp.allowFrom 和（对于群组）提及规则开始。
示例：
json{ "channels": { "whatsapp": { "allowFrom": ["+15555550123"], "groups": { "*": { "requireMention": true } } } }, "messages": { "groupChat": { "mentionPatterns": ["@openclaw"] } } }
从这里开始
- ▹文档中心 - 所有文档和指南，按用例组织
- ▹配置 - 核心网关设置、令牌和提供商配置
- ▹远程访问 - SSH 和 tailnet 访问模式
- ▹渠道 - WhatsApp、Telegram、Discord 等的渠道特定设置
- ▹节点 - 带配对和 Canvas 的 iOS 和 Android 节点
- ▹帮助 - 常见修复和故障排除入口