[

{

"source": "OpenClaw",

"target": "OpenClaw"

},

{

"source": "Gateway",

"target": "Gateway"

},

{

"source": "Pi",

"target": "Pi"

},

{

"source": "agent",

"target": "智能体"

},

{

"source": "channel",

"target": "渠道"

},

{

"source": "session",

"target": "会话"

},

{

"source": "provider",

"target": "提供商"

},

{

"source": "model",

"target": "模型"

},

{

"source": "tool",

"target": "工具"

},

{

"source": "CLI",

"target": "CLI"

},

{

"source": "install sanity",

"target": "安装完整性检查"

},

{

"source": "get unstuck",

"target": "快速排障"

},

{

"source": "troubleshooting",

"target": "故障排除"

},

{

"source": "FAQ",

"target": "常见问题"

},

{

"source": "onboarding",

"target": "上手引导"

},

{

"source": "wizard",

"target": "向导"

},

{

"source": "environment variables",

"target": "环境变量"

},

{

"source": "environment variable",

"target": "环境变量"

},

{

"source": "env vars",

"target": "环境变量"

},

{

"source": "env var",

"target": "环境变量"

}

]

{

"name": "中文",

"url": "/zh-CN"

},

read_when:

- 向新用户介绍 OpenClaw

summary: OpenClaw 的顶层概述、功能特性与用途

x-i18n:

generated_at: "2026-02-01T13:34:09Z"

model: claude-opus-4-5

provider: pi

source_hash: 92462177964ac72c344d3e8613a3756bc8e06eb7844cda20a38cd43e7cadd3b2

source_path: index.md

workflow: 9

<p align="center">

<img

src="/assets/openclaw-logo-text-dark.png"

alt="OpenClaw"

width="500"

class="dark:hidden"

/>

<img

src="/assets/openclaw-logo-text.png"

alt="OpenClaw"

width="500"

class="hidden dark:block"

/>

</p>

<p align="center">

<strong>适用于任意操作系统，通过 WhatsApp/Telegram/Discord/iMessage Gateway 连接 AI 智能体 (Pi)。</strong><br />

插件可添加 Mattermost 等更多渠道支持。

发送一条消息，即可获得智能体回复——随时随地，触手可及。

</p>

<p align="center">

<a href="https://github.com/openclaw/openclaw">GitHub</a> ·

<a href="https://github.com/openclaw/openclaw/releases">版本发布</a> ·

<a href="/">文档</a> ·

<a href="/start/openclaw">OpenClaw 助手设置</a>

</p>

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 同时也驱动着 OpenClaw 助手。

- **从零开始全新安装：** [快速入门](/start/getting-started)

- **引导式设置（推荐）：** [向导](/start/wizard) （`openclaw onboard`）

- **打开仪表盘（本地 Gateway）：** http://127.0.0.1:18789/（或 http://localhost:18789/）

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

仪表盘是用于聊天、配置、节点、会话等功能的浏览器控制界面。

本地默认地址：http://127.0.0.1:18789/

远程访问： [Web 界面](/web) 和 [Tailscale](/gateway/tailscale)

<p align="center">

<img src="whatsapp-openclaw.jpg" alt="OpenClaw" width="420" />

</p>

大多数操作通过 **Gateway** （`openclaw gateway`进行，它是一个长期运行的单进程，负责管理渠道连接和 WebSocket 控制面。

- **每台主机一个 Gateway（推荐）**：它是唯一允许持有 WhatsApp Web 会话的进程。如果需要备用机器人或严格隔离，可使用独立配置文件和端口运行多个 Gateway；请参阅 [多 Gateway 部署](/gateway/multiple-gateways).

- **优先回环**：Gateway WS 默认监听 `ws://127.0.0.1:18789`.

- 向导现在默认会生成一个 Gateway 令牌（即使在回环模式下也是如此）。

- 如需 Tailnet 访问，请运行 `openclaw gateway --bind tailnet --token ...` （非回环绑定时必须提供令牌）。

- **节点**：通过 WebSocket 连接到 Gateway（根据需要使用局域网/Tailnet/SSH）；旧版 TCP 桥接已弃用/移除。

- **Canvas 主机**：HTTP 文件服务器运行在 `canvasHost.port` （默认 `18793`），提供 `/__openclaw__/canvas/` 用于节点 WebView；请参阅 [Gateway 配置](/gateway/configuration) （`canvasHost`）。

- **远程使用**：SSH 隧道或 Tailnet/VPN；请参阅 [远程访问](/gateway/remote) 和 [发现机制](/gateway/discovery).

- 📱 **WhatsApp 集成** — 使用 Baileys 实现 WhatsApp Web 协议

- ✈️ **Telegram 机器人** — 通过 grammY 支持私聊和群组

- 🎮 **Discord 机器人** — 通过 channels.discord.js 支持私聊和服务器频道

- 🧩 **Mattermost 机器人（插件）** — Bot 令牌 + WebSocket 事件

- 💬 **iMessage** — 本地 imsg CLI 集成（macOS）

- 🤖 **智能体桥接** — Pi（RPC 模式），支持工具流式传输

- ⏱️ **流式传输与分块** — 块流式传输 + Telegram 草稿流式传输详情（[/concepts/streaming](/concepts/streaming)）

- 🧠 **多智能体路由** — 将提供商账户/对等方路由到隔离的智能体（工作区 + 每智能体会话）

- 🔐 **订阅认证** — 通过 OAuth 支持 Anthropic（Claude Pro/Max）+ OpenAI（ChatGPT/Codex）

- 💬 **会话** — 私聊折叠为共享 `main` （默认）；群组为隔离

- 👥 **群聊支持** — 默认基于提及触发；所有者可切换 `/activation always|mention`

- 📎 **媒体支持** — 收发图片、音频、文档

- 🎤 **语音消息** — 可选的转录钩子

- 🖥️ **网页聊天 + macOS 应用** — 本地界面 + 菜单栏辅助工具，支持操作和语音唤醒

- 📱 **iOS 节点** — 作为节点配对并提供 Canvas 界面

- 📱 **Android 节点** — 作为节点配对并提供 Canvas + 聊天 + 相机

注意：旧版 Claude/Codex/Gemini/Opencode 路径已移除；Pi 是唯一的编程智能体路径。

运行时要求： **Node ≥ 22**.

npm install -g openclaw@latest

openclaw onboard --install-daemon

openclaw channels login

openclaw gateway --port 18789

之后在 npm 安装和 git 安装之间切换很简单：安装另一种方式并运行 `openclaw doctor` 以更新 Gateway 服务入口点。

从源码安装（开发）：

git clone https://github.com/openclaw/openclaw.git

cd openclaw

pnpm install

pnpm ui:build # auto-installs UI deps on first run

pnpm build

openclaw onboard --install-daemon

如果尚未进行全局安装，请通过以下方式运行上手引导步骤 `pnpm openclaw ...` （在仓库目录中执行）。

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

OPENCLAW_CONFIG_PATH=~/.openclaw/a.json \

OPENCLAW_STATE_DIR=~/.openclaw-a \

openclaw gateway --port 19001

发送测试消息（需要 Gateway 正在运行）：

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

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

- 如果你 **不做任何操作**，OpenClaw 将使用内置的 Pi 二进制文件以 RPC 模式运行，并采用按发送者区分的会话。

- 如果你想锁定访问权限，请从以下内容开始 `channels.whatsapp.allowFrom` 以及（针对群组的）提及规则。

示例：

{

channels: {

whatsapp: {

allowFrom: ["+15555550123"],

groups: { "*": { requireMention: true } },

},

},

messages: { groupChat: { mentionPatterns: ["@openclaw"] } },

}

- 从这里开始：

- [文档中心（所有页面链接）](/start/hubs)

- [帮助](/help) ← _常见修复方案 + 故障排除_

- [配置](/gateway/configuration)

- [配置示例](/gateway/configuration-examples)

- [斜杠命令](/tools/slash-commands)

- [多智能体路由](/concepts/multi-agent)

- [更新 / 回滚](/install/updating)

- [配对（私聊 + 节点）](/start/pairing)

- [Nix 模式](/install/nix)

- [OpenClaw 助手设置](/start/openclaw)

- [技能](/tools/skills)

- [技能配置](/tools/skills-config)

- [工作区模板](/reference/templates/AGENTS)

- [RPC 适配器](/reference/rpc)

- [Gateway 运维手册](/gateway)

- [节点（iOS/Android）](/nodes)

- [Web 界面（控制界面）](/web)

- [发现机制 + 传输方式](/gateway/discovery)

- [远程访问](/gateway/remote)

- 提供商与用户体验：

- [网页聊天](/web/webchat)

- [控制界面（浏览器）](/web/control-ui)

- [Telegram](/channels/telegram)

- [Discord](/channels/discord)

- [Mattermost（插件）](/channels/mattermost)

- [iMessage](/channels/imessage)

- [群组](/concepts/groups)

- [WhatsApp 群组消息](/concepts/group-messages)

- [媒体：图片](/nodes/images)

- [媒体：音频](/nodes/audio)

- 伴侣应用：

- [macOS 应用](/platforms/macos)

- [iOS 应用](/platforms/ios)

- [Android 应用](/platforms/android)

- [Windows (WSL2)](/platforms/windows)

- [Linux 应用](/platforms/linux)

- 运维与安全：

- [会话](/concepts/session)

- [定时任务](/automation/cron-jobs)

- [Webhooks](/automation/webhook)

- [Gmail 钩子（Pub/Sub）](/automation/gmail-pubsub)

- [安全](/gateway/security)

- [故障排除](/gateway/troubleshooting)

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

_"我们都只是在玩弄自己的提示词罢了。"_ — 大概是一个嗑多了 token 的 AI 说的

- **Peter Steinberger** （[@steipete](https://twitter.com/steipete)）— 创作者，龙虾低语者

- **Mario Zechner** （[@badlogicc](https://twitter.com/badlogicgames)）— Pi 创作者，安全渗透测试员

- **Clawd** — 那只要求取个更好名字的太空龙虾

- **Maxim Vovshin** (@Hyaxia, [email protected]）— Blogwatcher 技能

- **Nacho Iacovino** (@nachoiacovino, [email protected]）— 位置解析（Telegram + WhatsApp）

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

_"我们都只是在玩弄自己的提示词罢了。"_ — 大概是一个嗑多了 token 的 AI 说的