OpenClaw

OpenClaw 🦞

“去壳! 去壳!” — A space lobster, probably

适用于跨 Discord、Google Chat、iMessage、Matrix、Microsoft Teams、Signal、Slack、Telegram、WhatsApp、Zalo 等平台的 AI 代理的任意操作系统网关。
发送一条消息，即可从您的口袋中获得代理的响应。运行一个网关即可覆盖内置渠道、打包的渠道插件、Gateway(网关) 和移动节点。

Get Started

安装 OpenClaw 并在几分钟内启动 Gateway(网关)。

Run 新手引导

使用 openclaw onboard 和配对流程进行引导式设置。

Open the Control UI

启动浏览器仪表板，进行聊天、配置和会话管理。

什么是 OpenClaw？

OpenClaw 是一个自托管网关，它将您喜爱的聊天应用和渠道表面（包括内置渠道以及打包或外部的渠道插件，例如 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 密钥，以及 5 分钟时间。为了获得最佳质量和安全性，请使用可用的最强大的最新一代模型。

工作原理

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(网关) 是会话、路由和渠道连接的唯一事实来源。

核心功能

Multi-渠道 gateway

通过单个 Discord 进程支持 iMessage、Signal、Slack、Telegram、WhatsApp、WebChat、Gateway(网关) 等。

Plugin channels

打包的插件在常规当前版本中增加了 Matrix、Nostr、Twitch、Zalo 等。

多智能体路由

针对每个智能体、工作区或发送者的隔离会话。

媒体支持

发送和接收图片、音频和文档。

Web 控制界面

用于聊天、配置、会话和节点的浏览器仪表板。

移动节点

配对 iOS 和 Android 节点，用于 Canvas、摄像头和启用语音的工作流。

快速开始

Install OpenClaw
Terminal window
```
npm install -g openclaw@latest
```
Onboard and install the service
Terminal window
```
openclaw onboard --install-daemon
```
聊天
在浏览器中打开控制 UI 并发送一条消息：
Terminal window
```
openclaw dashboard
```
或者连接一个渠道（Telegram 最快）并通过手机聊天。

需要完整的安装和开发设置？请参阅入门指南。

仪表板

在 Gateway(网关) 启动后，打开浏览器控制 UI。

本地默认： 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"] } },
}