openclaw 🦞

"蜕皮！蜕皮！" — 这可能是一只太空龙虾

适用于任何操作系统（Pi）的 WhatsApp/Telegram/Discord/iMessage 人工智能代理网关。
插件支持 Mattermost 等更多功能。发送消息，即可从口袋中获取代理回复。

openclaw 将 WhatsApp（通过 WhatsApp Web / Baileys）、Telegram（Bot API / grammY）、Discord（Bot API / channels.discord.js）和 iMessage（imsg CLI）连接到编码智能体，如 [Pi](https://github.com/badlogic/pi-mono)。插件添加 Mattermost（Bot API + WebSocket）等更多功能。 openclaw 还为太空龙虾助手 [Clawd](https://clawd.me) 提供支持。

OpenClaw 可通过 WhatsApp Web / Baileys、Telegram（Bot API / grammY）、Discord（Bot API / channels.discord.js）以及 iMessage（imsg CLI）与诸如 Pi 这样的编码工具进行连接。此外，还添加了 Mattermost（Bot API + WebSocket）等插件。还为 OpenClaw 助手提供了支持。

从这里开始

从零开始全新安装： 入门指南
引导式设置（推荐）： 向导 (openclaw onboard)
打开仪表板（本地网关）： http://127.0.0.1:18789/ （或 http://localhost:18789/ ）

如果网关在同一台计算机上运行，该链接会立即打开浏览器控制界面。如果失败，请先启动网关：openclaw gateway。

仪表板（浏览器控制界面）

仪表板是用于聊天、配置、节点、会话等的浏览器控制界面。本地默认：http://127.0.0.1:18789/ 远程访问：Web 界面和 Tailscale

工作原理

WhatsApp / Telegram / Discord / iMessage (+ 插件)
        │
        ▼
  ┌───────────────────────────┐
  │          网关             │  ws://127.0.0.1:18789（仅回环）
  │    （单一来源）           │
  │                           │  http://<网关主机>:18793
  │                           │    /__openclaw__/canvas/（画布主机）
  └───────────┬───────────────┘
              │
              ├─ Pi 智能体（RPC）
              ├─ CLI（openclaw …）
              ├─ 聊天界面（SwiftUI）
              ├─ macOS 应用（openclaw.app）
              ├─ iOS 节点通过网关 WebSocket + 配对
              └─ Android 节点通过网关 WebSocket + 配对

大多数操作都通过网关（openclaw gateway）来完成，该网关是一个持续运行的单一进程，负责管理通道连接以及 WebSocket 控制面板。

网络模型

每个主机一个网关（推荐）：这是唯一允许拥有 WhatsApp Web 会话的进程。如果您需要一个救援机器人或严格的隔离功能，请运行多个具有独立配置文件和端口的网关；请参阅多个网关。
回环优先：网关 WebSocket 默认为 ws://127.0.0.1:18789。
- 向导现在默认生成网关令牌（即使对于回环）。
- 对于 Tailnet 访问，运行 openclaw gateway --bind tailnet --token ...（非回环绑定需要令牌）。
节点：连接到网关 WebSocket（根据需要 LAN/tailnet/SSH）；传统的 TCP 桥接已弃用/移除。
画布主机：在 canvasHost.port（默认 18793）上的 HTTP 文件服务器，为节点 WebViews 提供 /__openclaw__/canvas/；请参阅网关配置（canvasHost）。
远程使用：SSH 隧道或 tailnet/VPN；请参阅远程访问和发现。

功能（高级）

📱 WhatsApp 集成 — 使用 Baileys 实现 WhatsApp Web 协议
✈️ Telegram 机器人 — 通过 grammY 实现私信 + 群组
🎮 Discord 机器人 — 通过 channels.discord.js 实现私信 + 公会频道
🧩 Mattermost 机器人（插件） — 机器人令牌 + WebSocket 事件
💬 iMessage — 本地 imsg CLI 集成（macOS）
🤖 智能体桥接 — Pi（RPC 模式）带工具流式传输
⏱️ 流式传输 + 分块 — 块流式传输 + Telegram 草稿流式传输详情（/concepts/streaming）
🧠 多智能体路由 — 将提供商账户/对等方路由到隔离的智能体（工作空间 + 每个智能体会话）
🔐 订阅认证 — Anthropic（Claude Pro/Max）+ OpenAI（ChatGPT/Codex）通过 OAuth
💬 会话 — 直接聊天折叠到共享的 main（默认）；群组是隔离的
👥 群组聊天支持 — 默认基于提及；所有者可以切换 /activation always|mention
📎 媒体支持 — 发送和接收图像、音频、文档
🎤 语音笔记 — 可选的转录钩子
🖥️ WebChat + macOS 应用 — 本地界面 + 菜单栏伴侣用于操作和语音唤醒
📱 iOS 节点 — 作为节点配对并暴露画布界面
📱 Android 节点 — 作为节点配对并暴露画布 + 聊天 + 摄像头

注意：传统的 Claude/Codex/Gemini/Opencode 路径已被移除；Pi 是唯一的编码智能体路径。

快速开始

运行时要求：Node ≥ 22。

bash

# 推荐：全局安装（npm/pnpm）
npm install -g openclaw@latest
# 或：pnpm add -g openclaw@latest

# 入门 + 安装服务（launchd/systemd 用户服务）
openclaw onboard --install-daemon

# 配对 WhatsApp Web（显示二维码）
openclaw channels login

# 入门后网关通过服务运行；仍然可以手动运行：
openclaw gateway --port 18789

稍后在 npm 和 git 安装之间切换很容易：安装另一种方式并运行 openclaw doctor 来更新网关服务入口点。

从源代码（开发）：

bash

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build # 首次运行时自动安装 UI 依赖
pnpm build
openclaw onboard --install-daemon

如果您还没有全局安装，请通过仓库中的 pnpm openclaw ... 运行入门步骤。

多实例快速开始（可选）：

bash

CLAWDBOT_CONFIG_PATH=~/.clawdbot/a.json \
CLAWDBOT_STATE_DIR=~/.clawdbot-a \
openclaw gateway --port 19001

发送测试消息（需要运行中的网关）：

bash

openclaw message send --target +15555550123 --message "Hello from openclaw"

配置（可选）

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

如果您什么都不做，openclaw 使用捆绑的 Pi 二进制文件在 RPC 模式下，每个发送者都有独立的会话。
如果您想锁定它，请从 channels.whatsapp.allowFrom 开始，以及（对于群组）提及规则。

示例：

json5

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

文档

名称由来

openclaw = CLAW + TARDIS — 因为每只太空龙虾都需要一个时空机器。

致谢

Peter Steinberger (@steipete) — 创建者，龙虾耳语者
Mario Zechner (@badlogicc) — Pi 创建者，安全渗透测试者
Clawd — 要求更好名字的太空龙虾

核心贡献者

Maxim Vovshin (@Hyaxia, 36747317+Hyaxia@users.noreply.github.com) — Blogwatcher 技能
Nacho Iacovino (@nachoiacovino, nacho.iacovino@gmail.com) — 位置解析（Telegram + WhatsApp）

许可证

MIT — 像海洋中的龙虾一样自由 🦞

"我们都只是在玩自己的提示词。" — 一个可能因令牌而兴奋的 AI

openclaw 🦞 ​

从这里开始 ​

仪表板（浏览器控制界面） ​

工作原理 ​

网络模型 ​

功能（高级） ​

快速开始 ​

配置（可选） ​

文档 ​

名称由来 ​

致谢 ​

核心贡献者 ​

许可证 ​

openclaw 🦞

从这里开始

仪表板（浏览器控制界面）

工作原理

网络模型

功能（高级）

快速开始

配置（可选）

文档

名称由来

致谢

核心贡献者

许可证