帮助文档
置顶
OpenClaw 是什么？
作者：一杯小咖啡
发布时间：2026年04月21日
浏览：4 次
OpenClaw 是什么？
OpenClaw 是一个自托管 Gateway 网关，可将你喜爱的聊天应用和渠道表面——包括内置渠道，以及内置或外部渠道插件（如 Discord、Google Chat、iMessage、Matrix、Microsoft Teams、Signal、Slack、Telegram、WhatsApp、Zalo 等）——连接到像 Pi 这样的 AI 编码智能体。你只需在自己的机器（或服务器）上运行一个 Gateway 网关进程，它就会成为你的消息应用与始终可用的 AI 助手之间的桥梁。
它适合谁？ 适合开发者和高级用户，他们希望拥有一个可以随时随地发消息的个人 AI 助手——同时又不放弃对自己数据的控制，也不依赖托管服务。
它有什么不同？
自托管：运行在你的硬件上，遵循你的规则
多渠道：一个 Gateway 网关可同时服务内置渠道以及内置或外部渠道插件
智能体原生：专为支持工具使用、会话、记忆和多智能体路由的编码智能体打造
开源：采用 MIT 许可证，由社区驱动
你需要什么？ Node 24（推荐），或为了兼容性使用 Node 22 LTS（22.14+），你所选提供商的一个 API key，以及 5 分钟时间。为了获得最佳质量与安全性，请使用最新一代中能力最强的模型。
工作原理
关键能力
Multi-channel gateway
通过单个 Gateway 网关进程连接 Discord、iMessage、Signal、Slack、Telegram、WhatsApp、WebChat 等更多渠道。
Plugin channels
内置插件可在当前常规版本中添加 Matrix、Nostr、Twitch、Zalo 等更多渠道。
Multi-agent routing
按智能体、工作区或发送者实现隔离会话。
Media support
发送和接收图片、音频和文档。
Web Control UI
用于聊天、配置、会话和节点的浏览器仪表板。
Mobile nodes
配对 iOS 和 Android 节点，支持 Canvas、相机和语音工作流。
快速开始
Install OpenClaw
npm install -g openclaw@latest
Onboard and install the service
openclaw onboard --install-daemon
Chat
在浏览器中打开 Control UI 并发送一条消息：
openclaw dashboard
或连接一个渠道（Telegram 最快），然后通过手机聊天。
需要完整安装和开发环境设置？请参阅入门指南。
仪表板
在 Gateway 网关启动后打开浏览器中的 Control UI。
本地默认地址：http://127.0.0.1:18789/
远程访问：Web 表面 和 Tailscale
OpenClaw
配置（可选）
配置位于 ~/.openclaw/openclaw.json。
如果你什么都不做，OpenClaw 会使用内置的 Pi 二进制文件，以 RPC 模式运行，并为每个发送者创建独立会话。
如果你想更严格地收紧权限，请从 channels.whatsapp.allowFrom 和（针对群组）提及规则开始。
示例：
{
channels: {
whatsapp: {
allowFrom: ["+15555550123"],
groups: { "*": { requireMention: true } },
},
},
messages: { groupChat: { mentionPatterns: ["@openclaw"] } },
}
从这里开始
OpenClaw 是一个自托管 Gateway 网关，可将你喜爱的聊天应用和渠道表面——包括内置渠道，以及内置或外部渠道插件（如 Discord、Google Chat、iMessage、Matrix、Microsoft Teams、Signal、Slack、Telegram、WhatsApp、Zalo 等）——连接到像 Pi 这样的 AI 编码智能体。你只需在自己的机器（或服务器）上运行一个 Gateway 网关进程，它就会成为你的消息应用与始终可用的 AI 助手之间的桥梁。
它适合谁？ 适合开发者和高级用户，他们希望拥有一个可以随时随地发消息的个人 AI 助手——同时又不放弃对自己数据的控制，也不依赖托管服务。
它有什么不同？
自托管：运行在你的硬件上，遵循你的规则
多渠道：一个 Gateway 网关可同时服务内置渠道以及内置或外部渠道插件
智能体原生：专为支持工具使用、会话、记忆和多智能体路由的编码智能体打造
开源：采用 MIT 许可证，由社区驱动
你需要什么？ Node 24（推荐），或为了兼容性使用 Node 22 LTS（22.14+），你所选提供商的一个 API key，以及 5 分钟时间。为了获得最佳质量与安全性，请使用最新一代中能力最强的模型。
工作原理
关键能力
Multi-channel gateway
通过单个 Gateway 网关进程连接 Discord、iMessage、Signal、Slack、Telegram、WhatsApp、WebChat 等更多渠道。
Plugin channels
内置插件可在当前常规版本中添加 Matrix、Nostr、Twitch、Zalo 等更多渠道。
Multi-agent routing
按智能体、工作区或发送者实现隔离会话。
Media support
发送和接收图片、音频和文档。
Web Control UI
用于聊天、配置、会话和节点的浏览器仪表板。
Mobile nodes
配对 iOS 和 Android 节点，支持 Canvas、相机和语音工作流。
快速开始
Install OpenClaw
npm install -g openclaw@latest
Onboard and install the service
openclaw onboard --install-daemon
Chat
在浏览器中打开 Control UI 并发送一条消息：
openclaw dashboard
或连接一个渠道（Telegram 最快），然后通过手机聊天。
需要完整安装和开发环境设置？请参阅入门指南。
仪表板
在 Gateway 网关启动后打开浏览器中的 Control UI。
本地默认地址：http://127.0.0.1:18789/
远程访问：Web 表面 和 Tailscale
OpenClaw
配置（可选）
配置位于 ~/.openclaw/openclaw.json。
如果你什么都不做，OpenClaw 会使用内置的 Pi 二进制文件，以 RPC 模式运行，并为每个发送者创建独立会话。
如果你想更严格地收紧权限，请从 channels.whatsapp.allowFrom 和（针对群组）提及规则开始。
示例：
{
channels: {
whatsapp: {
allowFrom: ["+15555550123"],
groups: { "*": { requireMention: true } },
},
},
messages: { groupChat: { mentionPatterns: ["@openclaw"] } },
}
从这里开始