OpenClaw文档

作者：具身机器人曾小健
OpenClaw

“去角质！去角质！” ——一只太空龙虾，大概会这么说。

适用于 WhatsApp、Telegram、Discord、iMessage 等平台的任何操作系统网关，支持 AI 代理。
随时随地发送消息，即可获得代理回复。插件支持 Mattermost 等更多功能。
开始使用

安装 OpenClaw 并几分钟内即可启动网关。


运行向导

引导式设置openclaw onboard和配对流程。


打开控制界面

启动浏览器控制面板，用于聊天、配置和会话。





​
OpenClaw是什么？OpenClaw 是一个自托管网关，可将您喜爱的聊天应用（例如 WhatsApp、Telegram、Discord、iMessage 等）连接到像 Pi 这样的 AI 编码代理。您只需在自己的机器（或服务器）上运行一个网关进程，它就会成为您的消息应用和始终可用的 AI 助手之间的桥梁。它的目标用户是谁？开发者和高级用户，他们想要一个可以随时随地发送消息的个人 AI 助手，而无需放弃对自身数据的控制权或依赖托管服务。它有何不同之处？

自托管：运行在您的硬件上，遵循您的规则多渠道：一个网关可同时服务于 WhatsApp、Telegram、Discord 等多个平台。Agent-native：专为编码代理而构建，支持工具使用、会话、内存和多代理路由。开源：采用 MIT 许可证，由社区驱动

你需要什么？ Node 22+、API 密钥（推荐使用 Anthropic 密钥）和 5 分钟时间。

​
工作原理

Chat apps + plugins

Gateway

Pi agent

CLI

Web Control UI

macOS app

iOS and Android nodes

网关是会话、路由和通道连接的唯一真实来源。

​
主要能力多通道网关

通过单个网关进程连接 WhatsApp、Telegram、Discord 和 iMessage。



插件通道

通过扩展包添加 Mattermost 等更多功能。



多代理路由

每个代理、工作区或发送者都有独立的会话。



媒体支持

发送和接收图像、音频和文档。



Web 控制用户界面

浏览器控制面板，用于显示聊天、配置、会话和节点。



移动节点

支持 Canvas 的 iOS 和 Android 节点配对。






​
快速入门1


安装 OpenClaw
npm install -g openclaw@latest





2


服务上线和安装
openclaw onboard --install-daemon





3


将 WhatsApp 与网关配对并启动网关。
openclaw channels loginopenclaw gateway --port 18789






需要完整的安装和开发设置？请参阅快速入门指南。

​
仪表板网关启动后，打开浏览器控制界面。

本地默认地址：http://127.0.0.1:18789/远程访问：Web 界面和Tailscale

​
配置（可选）配置位于~/.openclaw/openclaw.json。

如果什么都不做，OpenClaw 将在 RPC 模式下使用捆绑的 Pi 二进制文件，并为每个发送者创建一个会话。如果你想加强控制，首先要channels.whatsapp.allowFrom明确规则（对于群组来说），然后提及规则。

例子：<span style="color:#464140"><span style="background-color:initial"><span style="color:#110c0b"><span style="background-color:#ffffff"><span style="background-color:initial !important"><span style="background-color:#ffffff"><span style="color:#24292e"><code><span style="color:#24292e">{</span><span style="color:#2b5581">  channels</span><span style="color:#212121">:</span><span style="color:#24292e"> {</span><span style="color:#2b5581">    whatsapp</span><span style="color:#212121">:</span><span style="color:#24292e"> {</span><span style="color:#2b5581">      allowFrom</span><span style="color:#212121">:</span><span style="color:#24292e"> [</span><span style="color:#22863a">"+15555550123"</span><span style="color:#24292e">]</span><span style="color:#212121">,</span><span style="color:#2b5581">      groups</span><span style="color:#212121">:</span><span style="color:#24292e"> { </span><span style="color:#22863a">"*"</span><span style="color:#212121">:</span><span style="color:#24292e"> { </span><span style="color:#2b5581">requireMention</span><span style="color:#212121">:</span><span style="color:#1976d2"> true</span><span style="color:#24292e"> } }</span><span style="color:#212121">,</span><span style="color:#24292e">    }</span><span style="color:#212121">,</span><span style="color:#24292e">  }</span><span style="color:#212121">,</span><span style="color:#2b5581">  messages</span><span style="color:#212121">:</span><span style="color:#24292e"> { </span><span style="color:#2b5581">groupChat</span><span style="color:#212121">:</span><span style="color:#24292e"> { </span><span style="color:#2b5581">mentionPatterns</span><span style="color:#212121">:</span><span style="color:#24292e"> [</span><span style="color:#22863a">"@openclaw"</span><span style="color:#24292e">] } }</span><span style="color:#212121">,</span><span style="color:#24292e">}</span></code></span></span></span></span></span></span></span>




​
从这里开始文档中心

所有文档和指南，按用例分类。


配置

核心网关设置、令牌和提供商配置。


远程访问

SSH 和尾网访问模式。


频道

针对 WhatsApp、Telegram、Discord 等平台的频道专属设置。


节点

iOS 和 Android 节点，支持配对和 Canvas。


帮助

常见故障修复和故障排除切入点。





​




原文地址：https://blog.csdn.net/sinat_37574187/article/details/158417708