OpenClaw

OpenClaw 是一款可部署在个人设备上的本地优先个人 AI 助手，支持对接 WhatsApp、Telegram 等十余种主流通信渠道，兼顾隐私安全与使用便捷性，无需依赖第三方服务器，数据与控制权完全由你掌控。

核心亮点速览

先快速了解 OpenClaw 的核心价值，判断是否符合你的需求：

1. 本地优先网关：单一控制平面管理会话、渠道、工具与事件，响应快速，隐私可控。
2. 多渠道全覆盖：支持 WhatsApp、Telegram、Slack、Discord、Signal、iMessage 等 10+ 通信渠道，无缝对接你已在使用的工具。
3. 丰富交互能力：语音唤醒+通话模式（集成 ElevenLabs）、实时可视化画布（A2UI 驱动）、一流自动化工具（浏览器、cron 任务等）。
4. 多端配套支持：macOS 菜单栏应用、iOS/Android 节点应用，满足多设备使用需求。
5. 安全默认配置：默认开启 DM 配对验证，防止未授权访问，降低使用风险。
6. 易上手易扩展：向导驱动式安装配置，支持捆绑/自定义技能，社区生态持续丰富。

前置准备

必备运行环境

• Node.js ≥ 22（必须满足版本要求，否则可能出现运行异常）
• 包管理工具：npm、pnpm 或 bun（推荐 pnpm，源码构建更稳定）
• 可选（进阶使用）：WSL2（Windows 系统用户，强烈推荐，保障兼容性）

可选订阅（AI 模型支持）

OpenClaw 支持多种 AI 模型，推荐以下付费订阅以获得更佳体验：

• Anthropic（Claude Pro/Max）：推荐 Opus 4.5 模型，长上下文能力强，对提示词注入的抵抗力更优。
• OpenAI（ChatGPT/Codex）：经典模型，生态完善，适合各类常规场景。

安装与快速上手

方法 1：官方包安装（推荐，适合普通用户）

这是最简便的安装方式，直接通过包管理工具全局安装即可。

# 方式 1：使用 npm 安装
npm install -g openclaw@latest

# 方式 2：使用 pnpm 安装（推荐，更稳定）
pnpm add -g openclaw@latest

关键步骤：运行入门向导（必做）

入门向导会引导你完成网关、工作空间、渠道和技能的配置，还能安装守护进程确保 OpenClaw 持续运行。

# 运行入门向导，并安装守护进程（launchd/macOS 或 systemd/Linux）
openclaw onboard --install-daemon

快速启动与基础使用

# 启动网关，指定端口 18789，开启详细日志（方便排错）
openclaw gateway --port 18789 --verbose

# 发送测试消息（替换 +1234567890 为目标联系人/渠道账号）
openclaw message send --to +1234567890 --message "Hello from OpenClaw"

# 与 AI 助手对话（指定消息内容，设置高等级思考模式）
# 可通过已连接的任意渠道（WhatsApp/Telegram 等）接收回复
openclaw agent --message "Ship checklist" --thinking high

方法 2：从源码运行（适合开发者/进阶用户）

适合需要二次开发、调试功能的用户，推荐使用 pnpm 进行构建。

# 1. 克隆仓库
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# 2. 安装依赖
pnpm install

# 3. 构建 UI（首次运行需自动安装 UI 依赖，耐心等待）
pnpm ui:build

# 4. 构建项目源码
pnpm build

# 5. 运行入门向导并安装守护进程
pnpm openclaw onboard --install-daemon

# 6. 开发循环（TS 代码更改时自动重载，方便调试）
pnpm gateway:watch

注意：pnpm openclaw ... 会通过 tsx 直接运行 TypeScript 代码，pnpm build 会生成 dist/ 目录，用于通过 Node 或打包后的二进制文件运行。

版本升级与渠道切换

普通升级

# 检查并升级到最新稳定版
openclaw doctor # 先检查配置与环境问题
openclaw update

切换开发渠道

OpenClaw 提供 3 种开发渠道，可根据需求切换：

1. stable（稳定版）：带正式标签的发布版本，npm 标签为 latest，适合日常使用。
2. beta（测试版）：预发布版本，npm 标签为 beta，可能缺失 macOS 应用，适合尝鲜新功能。
3. dev（开发版）：main 分支最新提交，npm 标签为 dev，功能最新但稳定性最差，适合开发者。

# 切换渠道（示例：切换到 beta 版）
openclaw update --channel beta

核心配置与安全须知

安全默认设置：DM 访问控制（重中之重）

OpenClaw 对接真实通信渠道，入站私信（DM）默认被视为「不可信输入」，需重视访问控制。

默认行为：DM 配对验证（dmPolicy="pairing"）

未知发件人发送消息时，不会得到 AI 助手的处理，只会收到一个简短配对码。只有通过管理员批准后，才能正常交互：

# 批准配对（替换 <channel> 为渠道名称，<code> 为发件人收到的配对码）
openclaw pairing approve <channel> <code>

批准后，发件人会被添加到本地允许名单，后续可正常发送消息。

可选：开放公共 DM 访问（需谨慎）

若需接收任意发件人的消息，需手动开启「开放模式」，并配置允许名单：

1. 设置 dmPolicy="open"（对应渠道配置：如 channels.discord.dm.policy="open"）。
2. 在渠道允许名单中添加 "*"（对应配置：allowFrom / channels.discord.dm.allowFrom）。

警告：开放公共 DM 访问会增加安全风险，建议仅在可信场景下使用，且定期运行 openclaw doctor 检查配置风险。

模型配置与故障转移

1. 模型详细配置（含 CLI 操作）：参考官方「模型」文档。
2. 认证配置文件轮换与故障转移：支持 OAuth 与 API 密钥切换，当某个模型/提供商不可用时，可自动切换到备用选项，参考官方「模型故障转移」文档。
3. 推荐配置：Anthropic Pro/Max（Opus 4.5），兼顾长上下文与安全性。

核心功能补充说明

1. 多智能体路由：可将不同渠道/账户/对等点的消息，路由到隔离的智能体（独立工作空间+专属会话），避免信息干扰，适合多场景分用。
2. 实时画布：由 AI 智能体驱动的可视化工作空间，基于 A2UI 构建，可用于思维导图、任务规划等场景，直接通过网关调用即可。
3. 技能系统：入门向导会预装常用技能，也可自定义/安装社区技能，覆盖自动化、信息查询、任务管理等多种场景，是扩展 OpenClaw 能力的核心方式。
4. 升级检查：运行 openclaw doctor 可一键检查环境、配置、安全策略等问题，是排查故障、升级前的必备操作。