Skip to main content

Documentation Index

Fetch the complete documentation index at: https://openclaw.zhcndoc.com/llms.txt

Use this file to discover all available pages before exploring further.

​
OpenClaw 🦞

OpenClaw

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

适用于 Discord、Google Chat、iMessage、Matrix、Microsoft Teams、Signal、Slack、Telegram、WhatsApp、Zalo 等平台的任何操作系统网关，面向 AI 代理。
发送消息，随时从你的口袋里获取代理回复。通过内置通道、捆绑的通道插件、WebChat 和移动节点运行一个网关。

开始使用

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

运行引导

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

打开控制 UI

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

​
什么是 OpenClaw？

OpenClaw 是一个自托管网关，将你最喜欢的聊天应用和通道接入点——包括内置通道以及捆绑或外部通道插件，例如 Discord、Google Chat、iMessage、Matrix、Microsoft Teams、Signal、Slack、Telegram、WhatsApp、Zalo 等——连接到像 Pi 这样的 AI 编码代理。你在自己的机器（或服务器）上运行单个网关进程，它就会成为你的消息应用与始终在线的 AI 助手之间的桥梁。 它适合谁？ 适合希望拥有一个可以随时发消息的个人 AI 助手的开发者和高级用户——而且不必放弃对数据的控制，也不依赖托管服务。 它有何不同？
  • 自托管：运行在你的硬件上，按你的规则来
  • 多通道：一个网关可同时服务内置通道以及捆绑或外部通道插件
  • 原生面向代理：为具备工具使用、会话、记忆和多代理路由能力的编码代理而构建
  • 开源：MIT 许可证，社区驱动
你需要什么？ Node 24（推荐），或用于兼容性的 Node 22 LTS（22.14+），以及你所选提供商的 API 密钥，再加上 5 分钟时间。为了获得最佳质量和安全性，请使用可用的最强最新一代模型。

​
它是如何工作的

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

​
核心能力

多通道网关

使用单个网关进程即可支持 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 是最快的），然后在手机上聊天。
需要完整的安装和开发设置？请参见 Getting Started。

​
仪表板

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

OpenClaw

​
配置（可选）

配置位于 ~/.openclaw/openclaw.json。
  • 如果你什么都不做，OpenClaw 会在 RPC 模式下使用捆绑的 Pi 二进制文件，并为每个发送者维护会话。
  • 如果你想加强限制，请从 channels.whatsapp.allowFrom 开始设置，并且（对于群组）设置提及规则。
示例： 
{
  channels: {
    whatsapp: {
      allowFrom: ["+15555550123"],
      groups: { "*": { requireMention: true } },
    },
  },
  messages: { groupChat: { mentionPatterns: ["@openclaw"] } },
}

​
从这里开始

文档中心

按使用场景组织的全部文档和指南。

配置

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

远程访问

SSH 和 tailnet 访问模式。

通道

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

节点

带有配对、Canvas、摄像头和设备操作的 iOS 和 Android 节点。

帮助

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

​
了解更多

完整功能列表

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

多代理路由

工作区隔离和按代理划分的会话。

安全性

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

故障排查

网关诊断和常见错误。

关于与致谢

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