OpenClaw 🦞

OpenClaw

“EXFOLIATE! EXFOLIATE!” — 某只太空龙虾，大概是

全平台 AI agent 网关，连接 WhatsApp、Telegram、Discord、iMessage 等聊天应用。
发条消息，就能从口袋里拿到 agent 的回复。通过插件还能接入 Mattermost 等更多平台。

  • 快速上手 — 安装 OpenClaw，几分钟内启动 Gateway。
  • 运行向导 — 通过 openclaw onboard 和配对流程完成引导式配置。
  • 打开控制面板 — 启动浏览器仪表盘，管理聊天、配置和会话。

什么是 OpenClaw？

OpenClaw 是一个自托管网关，把你常用的聊天应用——WhatsApp、Telegram、Discord、iMessage 等——连接到 AI 编程 agent（如 Pi）。你只需在自己的机器（或服务器）上运行一个 Gateway 进程，它就成为你的聊天应用与随时在线的 AI 助手之间的桥梁。

适合谁用？ 希望拥有一个可以随时随地发消息的个人 AI 助手，同时不想交出数据控制权、也不依赖托管服务的开发者和高级用户。

和别的方案有什么不同？

  • 自托管：运行在你自己的硬件上，规则你来定
  • 多渠道：一个 Gateway 同时服务 WhatsApp、Telegram、Discord 等多个平台
  • Agent 原生：为编程 agent 而生，支持工具调用、会话管理、记忆和多 agent 路由
  • 开源：MIT 许可，社区驱动

需要准备什么？ Node 24（推荐）或 Node 22 LTS（22.16+）用于兼容、一个你选择的提供商的 API 密钥，以及 5 分钟的时间。为了最佳质量和安全性，建议使用最新一代最强的模型。

工作原理

flowchart LR
  A["聊天应用 + 插件"] --> B["Gateway"]
  B --> C["Pi agent"]
  B --> D["CLI"]
  B --> E["Web 控制面板"]
  B --> F["macOS 应用"]
  B --> G["iOS 和 Android 节点"]

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

核心能力

  • 多渠道网关 — 单个 Gateway 进程即可连接 WhatsApp、Telegram、Discord 和 iMessage。
  • 插件渠道 — 通过扩展包添加 Mattermost 等更多渠道。
  • 多 agent 路由 — 按 agent、工作区或发送者隔离会话。
  • 媒体支持 — 收发图片、音频和文档。
  • Web 控制面板 — 浏览器仪表盘，管理聊天、配置、会话和节点。
  • 移动节点 — 配对 iOS 和 Android 节点，支持 Canvas、相机和语音工作流。

快速开始

第一步：安装 OpenClaw

```bash
npm install -g openclaw@latest
```

第二步：引导安装并注册服务

```bash
openclaw onboard --install-daemon
```

第三步：配对 WhatsApp 并启动 Gateway

```bash
openclaw channels login
openclaw gateway --port 18789
```

完整的安装和开发环境搭建请参阅快速开始。

仪表盘

Gateway 启动后，打开浏览器控制面板。

OpenClaw

配置（可选）

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

  • 如果你什么都不改，OpenClaw 会使用内置的 Pi 二进制文件以 RPC 模式运行，并按发送者隔离会话。
  • 如果想收紧权限，从 channels.whatsapp.allowFrom 和（对于群聊的）提及规则开始配置。

示例：

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

从这里开始

  • 文档中心 — 所有文档和指南，按用途分类。
  • 配置 — Gateway 核心设置、token 和提供商配置。
  • 远程访问 — SSH 和 tailnet 访问方式。
  • 渠道 — WhatsApp、Telegram、Discord 等渠道的专项配置。
  • 节点 — iOS 和 Android 节点的配对、Canvas、相机和设备操作。
  • 帮助 — 常见问题修复和故障排查入口。

深入了解

下一页
Showcase
arrow_forward