OpenClaw 中文文档

Appearance

OpenClaw 🦞 中文文档 ​

"EXFOLIATE! EXFOLIATE!" — 一只太空龙虾，大概

OpenClaw 是一个自托管的 AI 代理网关，可以连接你最喜欢的聊天应用 —— WhatsApp、Telegram、Discord、iMessage、飞书等，连接到 AI 编码代理。你只需要在自己的机器（或服务器）上运行一个 Gateway 进程，它就成为消息应用和随时可用 AI 助手之间的桥梁。

什么是 OpenClaw？ ​

OpenClaw 让你在任何聊天应用中都能拥有一个 24/7 在线的个人 AI 助手：

  • 完全自托管：运行在你自己的硬件上，数据由你掌控
  • 多通道支持：一个 Gateway 同时支持 WhatsApp、Telegram、Discord、飞书等多个平台
  • 代理原生：为编码代理构建，支持工具使用、会话管理和多代理路由
  • 开源免费：MIT 许可证，社区驱动开发

适合谁？ 开发人员和高级用户，想要一个可以在任何地方发消息的个人 AI 助手，同时不想放弃数据控制权或依赖托管服务。

核心特性 ​

特性说明
多通道网关WhatsApp、Telegram、Discord、iMessage、飞书等，一个进程搞定
插件通道通过扩展包添加 Mattermost 等更多通道
多代理路由每个代理/工作区/发送者隔离会话
媒体支持发送和接收图片、音频、文档
Web 控制界面浏览器仪表板，用于聊天、配置、会话管理
移动节点配对 iOS 和 Android 节点，支持 Canvas、相机和语音工作流
定时任务支持 cron 作业和心跳检查，实现自动化
持久化记忆完整的记忆系统，跨会话保持上下文

快速开始 ​

1. 安装 OpenClaw ​

OpenClaw 需要 Node.js 24（推荐）或 Node 22 LTS（22.16+）。

bash
npm install -g openclaw@latest

2. 初始化并安装服务 ​

bash
openclaw onboard --install-daemon

3. 配对聊天通道并启动网关 ​

bash
openclaw channels login
openclaw gateway --port 18789

4. 打开控制面板 ​

启动 Gateway 后，在浏览器打开控制面板：

工作原理 ​

mermaid
flowchart LR
  A["聊天应用 + 插件"] --> B["Gateway"]
  B --> C["Pi 代理"]
  B --> D["CLI"]
  B --> E["Web 控制界面"]
  B --> F["macOS 应用"]
  B --> G["iOS 和 Android 节点"]

Gateway 是会话、路由和通道连接的唯一真相来源。

开始使用 ​

配置文件 ​

配置文件位于 ~/.openclaw/openclaw.json。

如果你什么都不做，OpenClaw 使用捆绑的 Pi 二进制文件，采用 RPC 模式，每个发送者独立会话。

如果你想锁定访问，可以从 allowFrom 配置开始：

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

社区 ​

许可证 ​

MIT License，开源免费使用。