# OpenClaw

> OpenClaw 是一个可在任何操作系统上运行的多渠道 AI 智能体 Gateway 网关。

- 网址：https://funcoding.ai/agents/openclaw/overview/
- 来源：OpenClaw 官方文档原文（中文），MIT 许可，同步于 2026-10-11
- 官方原文：https://docs.openclaw.ai/zh-CN/

---
<p align="center">
    <img
        src="/official-assets/openclaw/docs/assets/openclaw-hero-light.webp"
        alt="OpenClaw"
        width="500"
        class="dark:hidden"
    />
    <img
        src="/official-assets/openclaw/docs/assets/openclaw-hero-dark.webp"
        alt="OpenClaw"
        width="500"
        class="hidden dark:block"
    />
</p>

> _“去角质！去角质！”_ — 大概是一只太空龙虾

<p align="center">
  <strong>一款适用于任何操作系统的 AI 智能体 Gateway 网关，支持 Discord、Google Chat、iMessage、Matrix、Microsoft Teams、Signal、Slack、Telegram、WhatsApp、Zalo 等。</strong><br />
  发送消息，即可随时随地获得智能体响应。只需运行一个 Gateway 网关，即可连接渠道插件、WebChat 和移动节点。<br />
  由非营利组织 <a href="https://openclaw.org">OpenClaw 基金会</a>以开放方式开发。
</p>

- [快速开始](https://funcoding.ai/agents/openclaw/start/getting-started/)：安装 OpenClaw，几分钟内启动 Gateway 网关。
- [运行新手引导](https://funcoding.ai/agents/openclaw/start/wizard/)：通过 `openclaw onboard` 和配对流程完成引导式设置。
- [连接渠道](https://funcoding.ai/agents/openclaw/channels/)：连接 Discord、Signal、Telegram、WhatsApp 等服务，随时随地聊天。
- [打开 Control UI](https://funcoding.ai/agents/openclaw/web/control-ui/)：启动用于聊天、配置和会话的浏览器仪表板。

## 浏览文档

移动浏览器可能会显示章节菜单，但不显示完整的桌面端标签栏。可以使用
以下中心链接，从页面正文访问相同的顶级文档区域。

- [入门指南](https://funcoding.ai/agents/openclaw/overview/)：概览、展示、初始步骤和设置指南。
- [安装](https://funcoding.ai/agents/openclaw/install/)：安装方式、更新、容器、托管和高级设置。
- [渠道](https://funcoding.ai/agents/openclaw/channels/)：消息渠道、配对、路由、访问组和渠道 QA。
- [智能体](https://funcoding.ai/agents/openclaw/concepts/architecture/)：架构、会话、上下文、记忆和多智能体路由。
- [能力](https://funcoding.ai/agents/openclaw/tools/)：工具、技能、定时任务、Webhooks 和自动化能力。
- [ClawHub](https://docs.openclaw.ai/clawhub)：插件市场、发布、策展和信任指南。
- [Models](https://funcoding.ai/agents/openclaw/providers/)：提供商、模型配置、故障转移和本地模型服务。
- [平台](https://funcoding.ai/agents/openclaw/platforms/)：macOS、Windows、iOS、Android、节点和 Web 界面。
- [Gateway 网关与运维](https://funcoding.ai/agents/openclaw/gateway/)：Gateway 配置、安全、诊断和运维。
- [参考](https://funcoding.ai/agents/openclaw/cli/)：CLI 参考、模式、RPC、发布说明和模板。
- [帮助](https://funcoding.ai/agents/openclaw/help/)：故障排除、常见问题、测试、诊断和环境检查。

## 什么是 OpenClaw？

OpenClaw 是一个**自托管 Gateway 网关**，通过渠道插件将你常用的聊天应用（Discord、Google Chat、iMessage、Matrix、Microsoft Teams、Signal、Slack、Telegram、WhatsApp、Zalo 等）连接到 AI 编码智能体。你可以在自己的计算机（或服务器）上运行单个 Gateway 网关进程，使其成为消息应用与始终在线的 AI 助手之间的桥梁。

**它适合谁？** 希望能从任何地方向个人 AI 助手发送消息，同时不放弃数据控制权，也不依赖托管服务的开发者和高级用户。

**它有何不同？**

- **自托管**：在你的硬件上按你的规则运行
- **多渠道**：一个 Gateway 网关同时服务所有已配置的渠道插件
- **智能体原生**：专为具备工具使用、会话、记忆和多智能体路由能力的编码智能体构建
- **开源**：采用 MIT 许可证，由社区驱动

**需要什么？** Node 24.15+（推荐）、用于兼容的 Node 22 LTS（`22.22.3+`）或 Node 25.9+、所选提供商的 API 密钥，以及 5 分钟时间。为获得最佳质量和安全性，请使用当前可用的最强新一代模型。

## 工作原理

```mermaid
flowchart LR
  A["聊天应用 + 插件"] --> B["Gateway 网关"]
  B --> C["OpenClaw 智能体"]
  B --> D["CLI"]
  B --> E["Web Control UI"]
  B --> F["macOS 应用"]
  B --> G["iOS 和 Android 节点"]
```

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

## 主要能力

- [多渠道 Gateway 网关](https://funcoding.ai/agents/openclaw/channels/)：通过单个 Gateway 网关进程支持 Discord、iMessage、Signal、Slack、Telegram、WhatsApp、WebChat 等。
- [插件渠道](https://funcoding.ai/agents/openclaw/tools/plugin/)：渠道插件可添加 Matrix、Nostr、Twitch、Zalo 等服务；官方插件按需安装。
- [多智能体路由](https://funcoding.ai/agents/openclaw/concepts/multi-agent/)：按智能体、工作区或发送者隔离会话。
- [媒体支持](https://funcoding.ai/agents/openclaw/nodes/images/)：发送和接收图像、音频及文档。
- [Web Control UI](https://funcoding.ai/agents/openclaw/web/control-ui/)：用于聊天、配置、会话和节点的浏览器仪表板。
- [移动节点](https://funcoding.ai/agents/openclaw/nodes/)：配对 iOS 和 Android 节点，以支持 Canvas、相机和语音工作流。

## 快速开始

**安装 OpenClaw**

```bash
npm install -g openclaw@latest
```

**完成新手引导并安装服务**

```bash
openclaw onboard --install-daemon
```

**聊天**

在浏览器中打开 Control UI 并发送消息：

```bash
openclaw dashboard
```

或连接一个渠道（[Telegram](https://funcoding.ai/agents/openclaw/channels/telegram/) 最快），然后通过手机聊天。

需要完整的安装和开发环境设置说明？请参阅[入门指南](https://funcoding.ai/agents/openclaw/start/getting-started/)。

## 仪表板

Gateway 网关启动后，打开浏览器中的 Control UI。

- 本地默认地址：[http://127.0.0.1:18789/](http://127.0.0.1:18789/)
- 远程访问：[Web 界面](https://funcoding.ai/agents/openclaw/web/)和 [Tailscale](https://funcoding.ai/agents/openclaw/gateway/tailscale/)

<p align="center">
  <img src="/official-assets/openclaw/docs/whatsapp-openclaw.webp" alt="OpenClaw" width="420" />
</p>

## 配置（可选）

配置位于 `~/.openclaw/openclaw.json`。

- 如果你**什么都不做**，OpenClaw 将使用内置的 OpenClaw 智能体运行时；私信共享智能体的主会话，每个群聊则拥有自己的会话。
- 如果要限制访问，请从 `channels.whatsapp.allowFrom` 和（对于群组）提及规则开始。

示例：

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

## 从这里开始

- [文档中心](https://funcoding.ai/agents/openclaw/start/hubs/)：按使用场景组织的所有文档和指南。
- [配置](https://funcoding.ai/agents/openclaw/gateway/configuration/)：Gateway 网关核心设置、令牌和提供商配置。
- [远程访问](https://funcoding.ai/agents/openclaw/gateway/remote/)：SSH 和 tailnet 访问模式。
- [渠道](https://funcoding.ai/agents/openclaw/channels/telegram/)：Discord、Feishu、Microsoft Teams、Telegram、WhatsApp 等服务的渠道专属设置。
- [节点](https://funcoding.ai/agents/openclaw/nodes/)：支持配对、Canvas、相机和设备操作的 iOS 与 Android 节点。
- [帮助](https://funcoding.ai/agents/openclaw/help/)：常见修复方法和故障排除入口。

## 了解更多

- [完整功能列表](https://funcoding.ai/agents/openclaw/concepts/features/)：完整的渠道、路由和媒体能力。
- [多智能体路由](https://funcoding.ai/agents/openclaw/concepts/multi-agent/)：工作区隔离和按智能体划分的会话。
- [安全](https://funcoding.ai/agents/openclaw/gateway/security/)：令牌、允许列表和安全控制。
- [故障排查](https://funcoding.ai/agents/openclaw/gateway/troubleshooting/)：Gateway 网关诊断和常见错误。
- [关于与致谢](https://funcoding.ai/agents/openclaw/reference/credits/)：项目起源、贡献者和许可证。