OpenClaw

OpenClaw 🦞

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

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

Get Started

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

运行新手引导

使用 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.19+API) 以确保兼容性，来自您选择的提供商的 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(网关) 是会话、路由和渠道连接的唯一事实来源。

核心功能

多渠道网关

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

Plugin channels

捆绑插件在常规当前版本中添加了 Matrix、Nostr、Twitch、Zalo 等支持。

Multi-agent routing

针对每个代理、工作区或发送者的隔离会话。

Media support

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

Web Control UI

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

Mobile nodes

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

快速开始

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

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

仪表板

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

本地默认值：http://127.0.0.1:18789/
远程访问：Web surfaces 和 Tailscale

配置（可选）

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

如果您什么都不做，OpenClaw 将在 RPC 模式下使用随附的 Pi 二进制文件，并按发件人划分会话。
如果您想锁定它，请从 channels.whatsapp.allowFrom 和（针对群组）提及规则开始。

示例：

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