OpenClaw 官方 Wiki 精华指南 (2026-02-01)

1. 什么是 OpenClaw？

> “EXFOLIATE! EXFOLIATE!” — 可能是一只太空龙虾说的

OpenClaw 是一个跨平台的 AI 代理网关 (Gateway)，它将你的 AI Agent（如 Pi）与 WhatsApp、Telegram、Discord 和 iMessage 等通讯软件无缝连接。简而言之，它让你能从口袋里随时随地指挥你的私人 AI 助手。

核心特性

  • 📱 多渠道整合：支持 WhatsApp (Web协议), Telegram, Discord, iMessage, Mattermost。
  • 🤖 Agent 桥接：内置 Pi 编码代理 (RPC模式)，支持工具流式传输。
  • 🧠 多代理路由：支持将不同账号或对话路由到独立的 Agent 会话中。
  • 🔒 订阅鉴权：支持 Anthropic (Claude Pro/Max) 和 OpenAI (ChatGPT/Codex) 的 OAuth 认证。
  • 🗣️ 语音与媒体：支持发送接收图片、音频、文档，甚至语音转文字。

2. 快速开始 (Quick Start)

OpenClaw 需要 Node.js ≥ 22 环境。

2.1 安装与启动

推荐使用 npm 全局安装：

  1. # 全局安装
  2. npm install -g openclaw@latest
  4. # 引导设置 + 安装守护进程 (推荐)
  5. openclaw onboard --install-daemon
  7. # 登录 WhatsApp (扫码)
  8. openclaw channels login

安装完成后，Gateway 服务会自动后台运行。你可以访问本地仪表盘： 👉 http://127.0.0.1:18789/

2.2 发送测试消息

确保 Gateway 正在运行，然后尝试发送一条消息：

  1. openclaw message send --target +15555550123 --message "Hello from OpenClaw"

3. 架构原理

OpenClaw 的核心是一个单例的长运行进程 —— Gateway。

  1. WhatsApp / Telegram / Discord / iMessage
  2.         │
  3.         ▼
  4.   ┌─────────────┐
  5.   │   Gateway   │  <-- 核心中枢
  6.   └──────┬──────┘
  7.          │
  8.          ├─ Pi Agent (你的AI大脑)
  9.          ├─ CLI 命令行工具
  10.          ├─ macOS App / Web UI
  11.          └─ iOS/Android 节点
  • Gateway：负责持有所有聊天连接（如 WhatsApp Session），并通过 WebSocket 分发指令。
  • Nodes (节点)：你的手机（iOS/Android）可以作为“节点”配对到 Gateway，提供摄像头、定位等硬件能力。

4. 核心概念

4.1 会话 (Sessions)

  • Main Session：默认情况下，私聊消息会汇聚到共享的 main 会话中。
  • Group Isolation：群聊消息默认是隔离的，不会污染你的主记忆。

4.2 触发机制

在群聊中，你可以配置触发规则：

  • Mention：仅在被 @ 时响应（默认）。
  • Always：响应所有消息（需谨慎开启）。

配置示例 (~/.openclaw/openclaw.json)：

  1. {
  2.   channels: {
  3.     whatsapp: {
  4.       groups: { "*": { requireMention: true } }
  5.     }
  6.   }
  7. }

5. 高级功能

5.1 技能 (Skills)

OpenClaw 支持丰富的插件系统。你可以安装第三方技能来扩展能力，如：

  • Bird：推特客户端
  • Weather：天气查询
  • Brave Search：网络搜索

5.2 自动化 (Automation)

  • Cron Jobs：支持设置定时任务（如“每天早上8点播报新闻”）。
  • Webhooks：支持外部系统通过 HTTP 请求触发 Agent 动作。

💡 总结：OpenClaw 不仅仅是一个聊天机器人框架，它是一个连接了 “通讯工具” 与 “AI 生产力” 的操作系统。通过它，你的微信/Telegram 变成了最强大的命令行终端。