跳转到主要内容

OpenClaw 🦞

OpenClaw

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

适用于任意 OS 的 Gateway 网关,让 AI 智能体跨 Discord、Google Chat、iMessage、Matrix、Microsoft Teams、Signal、Slack、Telegram、WhatsApp、Zalo 等平台工作。
发送一条消息,就能从口袋里收到智能体回复。用一个 Gateway 网关运行频道插件、WebChat 和移动节点。

开始使用

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

运行新手引导

通过 openclaw onboard 和配对流程进行引导式设置。

打开 Control UI

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

OpenClaw 是什么?

OpenClaw 是一个自托管 Gateway 网关,可通过频道插件把你常用的聊天应用 — Discord、Google Chat、iMessage、Matrix、Microsoft Teams、Signal、Slack、Telegram、WhatsApp、Zalo 等 — 连接到 AI 编码智能体。你在自己的机器(或服务器)上运行一个 Gateway 网关进程,它就会成为你的消息应用和始终可用的 AI 助手之间的桥梁。 它适合谁? 适合希望拥有可从任何地方发消息访问的个人 AI 助手,同时不放弃数据控制权、也不依赖托管服务的开发者和高级用户。 它有什么不同?
  • 自托管:运行在你的硬件上,遵循你的规则
  • 多渠道:一个 Gateway 网关可同时服务每个已配置的频道插件
  • 智能体原生:为支持工具使用、会话、记忆和多智能体路由的编码智能体而构建
  • 开源:MIT 许可,社区驱动
你需要什么? Node 24(推荐),或用于兼容性的 Node 22 LTS (22.19+)、所选提供商的 API key,以及 5 分钟。为获得最佳质量和安全性,请使用可用的最强最新一代模型。

工作原理

Gateway 网关是会话、路由和频道连接的唯一可信来源。

核心能力

多渠道 Gateway 网关

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

插件渠道

频道插件可添加 Matrix、Nostr、Twitch、Zalo 等;官方插件按需安装。

多智能体路由

按智能体、工作区或发送者隔离会话。

媒体支持

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

Web Control UI

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

移动节点

配对 iOS 和 Android 节点,用于 Canvas、相机和语音工作流。

快速开始

1

安装 OpenClaw

npm install -g openclaw@latest
2

新手引导并安装服务

openclaw onboard --install-daemon
3

聊天

在浏览器中打开 Control UI 并发送消息:
openclaw dashboard
或连接一个渠道(Telegram 最快),然后从手机聊天。
需要完整安装和开发设置?请参阅入门指南

仪表板

Gateway 网关启动后,打开浏览器 Control UI。

OpenClaw

配置(可选)

配置位于 ~/.openclaw/openclaw.json
  • 如果你什么都不做,OpenClaw 会使用内置的 OpenClaw agent runtime;私信共享智能体的主会话,每个群聊都有自己的会话。
  • 如果你想收紧访问控制,请从 channels.whatsapp.allowFrom 和(针对群组的)提及规则开始。
示例:
{
  channels: {
    whatsapp: {
      allowFrom: ["+15555550123"],
      groups: { "*": { requireMention: true } },
    },
  },
  messages: { groupChat: { mentionPatterns: ["@openclaw"] } },
}

从这里开始

文档中心

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

配置

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

远程访问

SSH 和 tailnet 访问模式。

Channels

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

节点

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

帮助

常见修复和故障排查入口。

了解更多

完整功能列表

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

多智能体路由

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

安全

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

故障排查

Gateway 网关诊断和常见错误。

关于与致谢

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