OpenClaw 🦞

"去壳！去壳！" — 大概是一只太空龙虾说的

适用于任何操作系统的 AI 智能体 Gateway 网关，支持 WhatsApp、Telegram、Discord、iMessage 等。
发送消息，随时随地获取智能体响应。通过插件可添加 Mattermost 等更多渠道。

• 入门指南 — 安装 OpenClaw 并在几分钟内启动 Gateway 网关
• 运行向导 — 通过 openclaw onboard 和配对流程进行引导式设置
• 打开控制界面 — 启动浏览器仪表板，管理聊天、配置和会话

OpenClaw 通过单个 Gateway 网关进程将聊天应用连接到 Pi 等编程智能体。它为 OpenClaw 助手提供支持，并支持本地或远程部署。

工作原理

flowchart LR
  A["Chat apps + plugins"] --> B["Gateway"]
  B --> C["Pi agent"]
  B --> D["CLI"]
  B --> E["Web Control UI"]
  B --> F["macOS app"]
  B --> G["iOS and Android nodes"]

Gateway 网关是会话、路由和渠道连接的唯一事实来源。

核心功能

功能	说明
多渠道 Gateway 网关	通过单个 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

需要完整的安装和开发环境设置？请参阅快速开始。

仪表板

Gateway 网关启动后，打开浏览器控制界面。

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

配置（可选）

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

• 如果你不做任何修改，OpenClaw 将使用内置的 Pi 二进制文件以 RPC 模式运行，并按发送者创建独立会话。
• 如果你想要限制访问，可以从 channels.whatsapp.allowFrom 和（针对群组的）提及规则开始配置。

示例：

{
  channels: {
    whatsapp: {
      allowFrom: ["+15555550123"],
      groups: { "*": { requireMention: true } },
    },
  },
  messages: { groupChat: { mentionPatterns: ["@openclaw"] } },
}

从这里开始

• 文档中心 — 所有文档和指南，按用例分类。
• 配置 — 核心 Gateway 网关设置、令牌和提供商配置。
• 远程访问 — SSH 和 tailnet 访问模式。
• 渠道 — WhatsApp、Telegram、Discord 等渠道的具体设置。
• 节点 — iOS 和 Android 节点的配对与 Canvas 功能。
• 帮助 — 常见修复方法和故障排除入口。

了解更多

• 完整功能列表 — 全部渠道、路由和媒体功能。
• 多智能体路由 — 工作区隔离和按智能体的会话管理。
• 安全 — 令牌、白名单和安全控制。
• 故障排除 — Gateway 网关诊断和常见错误。
• 关于与致谢 — 项目起源、贡献者和许可证。