跳转到主要内容

​
OpenClaw 🦞

OpenClaw

“蜕皮！蜕皮！” — 大概是一只太空龙虾

适用于 AI 智能体的任意操作系统 Gateway 网关，覆盖 Discord、Google Chat、iMessage、Matrix、Microsoft Teams、Signal、Slack、Telegram、WhatsApp、Zalo 等渠道。
发一条消息，就能随时随地收到智能体回复。通过一个 Gateway 网关即可运行内置渠道、内置渠道插件、WebChat 和移动节点。

入门指南

安装 OpenClaw，几分钟内启动 Gateway 网关。

运行新手引导

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

打开控制 UI

启动浏览器仪表板，用于聊天、配置和会话。

​
OpenClaw 是什么？

OpenClaw 是一个自托管 Gateway 网关，可将你常用的聊天应用和渠道界面——包括内置渠道，以及 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 分钟时间。为了获得最佳质量与安全性，请使用当前可用的最新一代最强模型。

​
工作原理

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

​
关键能力

多渠道 Gateway 网关

通过单个 Gateway 网关进程接入 Discord、iMessage、Signal、Slack、Telegram、WhatsApp、WebChat 等更多渠道。

插件渠道

内置插件可在当前正式版本中添加 Matrix、Nostr、Twitch、Zalo 等更多渠道。

多智能体路由

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

媒体支持

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

Web 控制 UI

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

移动节点

配对 iOS 和 Android 节点，用于 Canvas、相机和支持语音的工作流。

​
快速开始

1

安装 OpenClaw

npm install -g openclaw@latest
2

执行新手引导并安装服务

openclaw onboard --install-daemon
3

开始聊天

在浏览器中打开控制 UI 并发送一条消息：
openclaw dashboard
或连接一个渠道（Telegram 最快），然后直接用手机聊天。
需要完整的安装和开发设置？请参阅入门指南。

​
仪表板

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

OpenClaw

​
配置（可选）

配置文件位于 ~/.openclaw/openclaw.json。
  • 如果你什么都不做，OpenClaw 会使用内置的 Pi 二进制并以 RPC 模式运行，同时为每个发送者创建独立会话。
  • 如果你想进一步收紧权限，建议从 channels.whatsapp.allowFrom 和（针对群组的）提及规则开始。
示例： 
{
  channels: {
    whatsapp: {
      allowFrom: ["+15555550123"],
      groups: { "*": { requireMention: true } },
    },
  },
  messages: { groupChat: { mentionPatterns: ["@openclaw"] } },
}

​
从这里开始

文档中心

按使用场景组织的所有文档和指南。

配置

核心 Gateway 网关设置、令牌和提供商配置。

远程访问

SSH 和 tailnet 访问模式。

渠道

针对 Feishu、Microsoft Teams、WhatsApp、Telegram、Discord 等渠道的专属设置说明。

节点

iOS 和 Android 节点，支持配对、Canvas、相机和设备操作。

帮助

常见修复方法和故障排除入口。

​
了解更多

完整功能列表

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

多智能体路由

工作区隔离和按智能体划分的会话。

安全

令牌、允许列表和安全控制。

故障排除

Gateway 网关诊断和常见错误。

关于与致谢

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