OpenClaw 白皮书

首页

OpenClaw

​
OpenClaw 🦞
OpenClaw
“蜕壳！蜕壳！” — 也许是一只太空龙虾说的
这是一个能跨越 WhatsApp、Telegram、Discord、iMessage 等平台的全栖 AI 代理网关。
发送一条消息，就能马上从你口袋里的各个 App 获得 AI 的响应。你还可以通过插件扩展 Mattermost 等更多平台。
[

快速上手

安装 OpenClaw，只需几分钟内就能将网关服务跑起来。
](/start/quickstart)[

运行向导

使用 openclaw onboard 体验向导式的配置及账号配对流程。
](/start/wizard)[

打开交互面板

启动 Web 浏览器中的控制面板，即可进行在线聊天、配置参数并管理所有连接会话。
](/web/control-ui)

​
究竟什么是 OpenClaw？
OpenClaw 是一个完全支持私有化部署的网关中枢，它能将你深爱的聊天软件（如 WhatsApp、Telegram、Discord、iMessage 等）桥接到诸如 Pi 这样的极客版 AI 编程代理上。你只需在个人电脑（或云端服务器）上跑这么一个单一网关，它就能成为聊天应用与 AI 助手之间一座不掉线的桥梁。
适用人群？ 针对那些想要随时随地通过消息召唤私人 AI 助手，同时坚决不想出让自身数据隐私，或是不甘受制于托管商平台的硬核开发者及极客玩家。
它真的够独特么？
  • ✦私有化托管: 完全运行在你个人的硬件架构上，由你设定一切规则。
  • ✦多渠道并发: 同一个网关底层能支持同时运转 WhatsApp、Telegram、Discord。
  • ✦原生代理生态: 专为编程型 AI 代理构建，天生支持函数工具调用、长效记忆会话分离，以及多智能体路由。
  • ✦开源信仰: 基于最彻底的 MIT 开源协议，纯社区化驱动。
它对系统的要求是什么？ 极简，你只需要 Node 24（推荐）或是带 LTS 后限的 Node 22 (22.16+)；外加来自你钟情的 AI 服务商那里申请到的一枚 API Key，及 5 分钟耐心。如果你想体验到最强安全与效能比，建议接驳目前你能拿到的一线最强大航海模型。

​
工作原理及架构
网关，它是统管你全局节点会话、智能路由决策，乃至全渠道连接的“唯一真相源” (Single Source of Truth)。

​
核心武库

全栖多渠道接驳

无论是 WhatsApp、Telegram 还是 Discord 乃至于苹果原生 iMessage，所有通道合并在一个进程内管控。

插件热插拔系统

只要你想得到，直接利用第三方扩展插件无缝对接至类似 Mattermost 等独立协作平台。

多智能体矩阵路由

它能为不同的代理、不同的项目工作区乃至不同的群组分发独立会话进程，保持上下文绝对隔离。

全媒体协议支持

它不光是个文本引擎——接收并解析图片、音频乃至文件，都是基操。

Web 自主控制看板

我们在浏览器里做了一套超能总控看板 (Web Control UI)，聊天、配置、节点状态尽收眼底。

移动端分布式节点

你甚至能把 iOS 或 Android 当成节点挂载上来，直接调用它们的画板流、相机流和原生麦克风权限。

​
快速上手指南
1
安装 OpenClaw
bash
npm install -g openclaw@latest
2
配置引导并驻留守护进程
bash
openclaw onboard --install-daemon
3
登录并配对跨平台应用，拉升网关
bash
openclaw channels login
openclaw gateway --port 18789
如果这就满足不了你？详见完整的极客化开发搭建：快速上手 (Quick start)。

​
Dashboard 全息控制面
一旦你将网关成功挂起，就可以在浏览器直接冲进控制台了。

​
参数化配置 (高阶选项)
网关的心脏配置被妥善放置于 ~/.openclaw/openclaw.json。
  • ✦默认情况下，如果你什么都不做，OpenClaw 会调用内部自带的 Pi 核心文件，运行于基于 RPC 管道的模式，替每一位发信者启动一个独立的沙盒会话。
  • ✦而在生产环境中，如果你想锁死你的私人通道大门免受骚扰，可以使用诸如 channels.whatsapp.allowFrom 的白名单字段；若是微信/QQ这种群聊模式下为了防静噪，建议配置针对群组必须唤醒 @ 提及才生效的硬性规则。
感受下这配置代码有多优雅：
json
{
  "channels": {
    "whatsapp": {
      "allowFrom": ["+15555550123"],
      "groups": { "*": { "requireMention": true } }
    }
  },
  "messages": { "groupChat": { "mentionPatterns": ["@openclaw"] } }
}

​
从这里启航
[

文档中枢概貌

囊括所有协议指引和案例指南的中心入口。
](/start/hubs)[

配置文件手册

核心网关底层设定，密钥库管理，甚至 LLM 服务商接驳细则全公开。
](/gateway/configuration)[

远端连接指南

解析基于 SSH 以及 Tailnet (纯局域网穿透模式) 的高难度组网方案。
](/gateway/remote)[

对接各大渠道

手把手教你在 WhatsApp、Telegram、Discord 及更多平台上开疆辟土。
](/channels)[

手机节点解析

如何把 iPhone 和 Android 设备桥接为原生功能节点。
](/nodes)