> ## 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!"* — 一只太空龙虾，大概吧
Any OS gateway for AI agents across Discord, Google Chat, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp, Zalo, and more.
Send a message, get an agent response from your pocket. Run one Gateway across channel plugins, WebChat, and mobile nodes.
Developed in the open by the OpenClaw Foundation, a non-profit.
安装 OpenClaw，并在几分钟内启动网关。
使用 `openclaw onboard` 和配对流程进行引导式设置。
连接 Discord、Signal、Telegram、WhatsApp 等，即可随时随地聊天。
启动用于聊天、配置和会话的浏览器仪表盘。
## 浏览文档
移动浏览器可能会显示章节菜单，而不会显示完整的桌面端标签栏。请使用
这些中心链接，从页面正文进入相同的顶级文档区域。
概览、展示、第一步和设置指南。
安装路径、更新、容器、托管和高级设置。
消息频道、配对、路由、访问组和频道 QA。
架构、会话、上下文、记忆和多代理路由。
工具、技能、cron、webhook 和自动化功能。
插件市场、发布、精选与信任指南。
提供商、模型配置、故障切换和本地模型服务。
macOS、Windows、iOS、Android、节点和 Web 界面。
网关配置、安全性、诊断和运维。
CLI 参考、模式、RPC、发行说明和模板。
故障排查、常见问题、测试、诊断和环境检查。
## 什么是 OpenClaw？
OpenClaw 是一个**自托管网关**，可通过频道插件将你最喜欢的聊天应用——Discord、Google Chat、iMessage、Matrix、Microsoft Teams、Signal、Slack、Telegram、WhatsApp、Zalo 等更多应用——连接到 AI 编码代理。你只需在自己的机器（或服务器）上运行一个 Gateway 进程，它就会成为你的消息应用与一个始终可用的 AI 助手之间的桥梁。
**它适合谁？** 适合希望拥有一个可以随时发消息的个人 AI 助手的开发者和高级用户——而且不必放弃对数据的控制，也不依赖托管服务。
**它有何不同？**
* **自托管**：在你的硬件上运行，按你的规则办
* **多频道**：一个 Gateway 可同时为所有已配置的频道插件提供服务
* **面向代理**：为支持工具使用、会话、记忆和多代理路由的编码代理而构建
* **开源**：MIT 许可，社区驱动
**What do you need?** Node 26 (recommended), or another supported release: Node 22.22.3+, Node 24.15+, or Node 25.9+. You also need an API key from your chosen provider and 5 minutes. For best quality and security, use the strongest latest-generation model available.
## 它是如何工作的
```mermaid theme={"theme":{"light":"min-light","dark":"min-dark"}}
flowchart LR
A["聊天应用 + 插件"] --> B["网关"]
B --> C["OpenClaw agent"]
B --> D["CLI"]
B --> E["Web 控制 UI"]
B --> F["macOS 应用"]
B --> G["iOS 和 Android 节点"]
```
网关是会话、路由和通道连接的唯一事实来源。
## 核心能力
使用单个网关进程即可支持 Discord、iMessage、Signal、Slack、Telegram、WhatsApp、WebChat 等。
通道插件可添加 Matrix、Nostr、Twitch、Zalo 等；官方插件可按需安装。
为每个代理、工作区或发送者隔离会话。
发送和接收图像、音频和文档。
用于聊天、配置、会话和节点的浏览器仪表板。
配对 iOS 和 Android 节点，以支持 Canvas、摄像头和语音启用的工作流。
## 快速开始
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
npm install -g openclaw@latest
```
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --install-daemon
```
在浏览器中打开控制 UI 并发送消息：
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw dashboard
```
或者连接一个通道（[Telegram](/channels/telegram) 是最快的），然后在手机上聊天。
需要完整的安装和开发设置？请参见 [Getting Started](/start/getting-started)。
## 仪表板
网关启动后，打开浏览器控制 UI。
* 本地默认地址：[http://127.0.0.1:18789/](http://127.0.0.1:18789/)
* 远程访问：[Web 界面](/web) 和 [Tailscale](/gateway/tailscale)
## 配置（可选）
配置位于 `~/.openclaw/openclaw.json`。
* 如果你**什么都不做**，OpenClaw 会使用内置的 OpenClaw 代理运行时；私信会共享代理的主会话，而每个群聊都会获得自己的会话。
* 如果你想加强限制，可以从 `channels.whatsapp.allowFrom` 和（对于群组）提及规则开始。
示例：
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
channels: {
whatsapp: {
allowFrom: ["+15555550123"],
groups: { "*": { requireMention: true } },
},
},
messages: { groupChat: { mentionPatterns: ["@openclaw"] } },
}
```
## 从这里开始
按使用场景组织的全部文档和指南。
核心网关设置、令牌和提供商配置。
SSH 和 tailnet 访问模式。
针对 Discord、飞书、Microsoft Teams、Telegram、WhatsApp 等的频道专属设置。
带有配对、Canvas、摄像头和设备操作的 iOS 和 Android 节点。
常见修复和故障排查入口。
## 了解更多
完整的通道、路由和媒体能力。
工作区隔离和按代理划分的会话。
令牌、允许列表和安全控制。
网关诊断和常见错误。
项目起源、贡献者和许可证。