OpenClaw 🦞

"EXFOLIATE! EXFOLIATE!" — 一只太空龙虾，大概是这么说的

跨平台 AI 代理网关，支持 WhatsApp、Telegram、Discord、iMessage 等更多渠道。
发一条消息，随时随地从手机获取 AI 代理响应。通过插件还可接入 Mattermost 等更多应用。

快速上手

几分钟内安装 OpenClaw 并启动 Gateway。

运行引导向导

通过 openclaw onboard 进行引导式配置和配对流程。

打开 Control UI

在浏览器中启动控制台进行对话、配置和会话管理。

什么是 OpenClaw？

OpenClaw 是一个自托管网关，把你喜欢的聊天应用——WhatsApp、Telegram、Discord、iMessage 等——与 Pi 等 AI 编程代理连接起来。你在自己的机器（或服务器）上运行一个 Gateway 进程，它就成为消息应用与随时可用的 AI 助手之间的桥梁。

适合谁用？ 开发者和高级用户，想要一个随时可以消息联系的个人 AI 助手，同时不放弃数据控制权，不依赖托管服务。

有什么不同？

• 自托管：运行在你的硬件上，你说了算
• 多渠道：一个 Gateway 同时为 WhatsApp、Telegram、Discord 等提供服务
• 代理原生：专为有工具调用、会话、记忆和多代理路由的编程代理设计
• 开源：MIT 协议，社区驱动

需要什么？ Node 24（推荐），或 Node 22 LTS（22.14+），你选择的 provider 的 API key，以及 5 分钟时间。为获得最佳质量和安全性，建议使用最强的最新一代模型。

工作原理

flowchart LR
  A["聊天应用 + 插件"] --> B["Gateway"]
  B --> C["Pi 代理"]
  B --> D["CLI"]
  B --> E["Web Control UI"]
  B --> F["macOS App"]
  B --> G["iOS 和 Android 节点"]

Gateway 是会话、路由和频道连接的单一控制中心。

核心能力

多渠道网关

单个 Gateway 进程同时支持 WhatsApp、Telegram、Discord 和 iMessage。

插件频道

通过扩展包添加 Mattermost 等更多频道。

多代理路由

按代理、工作区或发送方进行会话隔离。

媒体支持

收发图片、音频和文档。

Web Control UI

浏览器控制台，用于对话、配置、会话和节点管理。

移动节点

配对 iOS 和 Android 节点，支持 Canvas、摄像头和语音工作流。

快速开始

安装 OpenClaw（开始养龙虾）

npm install -g openclaw@latest

引导配置并安装服务

openclaw onboard --install-daemon

开始对话

在浏览器中打开 Control UI 发送消息：

openclaw dashboard

或者连接一个频道（Telegram 最快）从手机开始对话。

需要完整安装和开发配置？参见快速上手。

控制台

Gateway 启动后打开浏览器 Control UI。

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

配置（可选）

配置文件在 ~/.openclaw/openclaw.json。

• 什么都不做时，OpenClaw 使用内置的 Pi 二进制文件以 RPC 模式按发送方独立建立会话。
• 如果想收紧权限，从 channels.whatsapp.allowFrom 开始配置，群组还需配置 mention 规则。

示例：

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

从这里出发

文档导航

所有文档和指南，按使用场景分类。

配置参考

Gateway 核心配置、令牌和 Provider 配置。

远程访问

SSH 和 tailnet 访问模式。

频道配置

WhatsApp、Telegram、Discord 等频道专项配置。

节点管理

iOS 和 Android 节点配对、Canvas、摄像头和设备操作。

帮助与排查

常见问题修复和故障排查入口。

深入了解

完整功能列表

完整的频道、路由和媒体能力说明。

多代理路由

工作区隔离和按代理独立会话。

安全机制

令牌、白名单和安全控制。

故障排查

Gateway 诊断和常见错误。

关于与致谢

项目起源、贡献者和许可证。