入门指南

约 881 字大约 3 分钟

快速开始

本文介绍从零安装 OpenClaw 到发送第一条消息的完整流程。内容基于官方 Getting Started。

环境要求

Node.js ≥ 22

1. 安装 CLI

推荐全局安装（npm 或 pnpm）：

npm install -g openclaw@latest
## 或

2. 运行向导并安装服务

向导会引导你完成网关、工作区、通道与技能的配置，并安装系统服务（launchd / systemd 用户服务），使网关在后台常驻：

openclaw onboard --install-daemon

3. 登录通道（例如 WhatsApp）

openclaw channels login

按提示完成扫码或登录，凭证会保存在 ~/.openclaw/credentials。

4. 启动网关

向导完成后，网关会由安装的服务自动运行。如需手动启动：

openclaw gateway --port 18789

5. 打开控制台

在浏览器访问：

http://127.0.0.1:18789/ 或 http://localhost:18789/

即可使用控制台进行对话、查看会话与配置。

6. 发送测试消息（可选）

在网关已运行的前提下：

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

将 +15555550123 替换为你的目标号码。

从源码运行（开发）

若从 GitHub 克隆源码开发：

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build   # 首次会安装 UI 依赖
pnpm build

未全局安装时，可用 pnpm openclaw ... 从仓库运行命令。

下一步

安装向导 — 向导各步骤说明
配对 — DM 与设备节点配对
配置 — 网关与通道配置
官方文档 — 完整英文文档

配对连接

OpenClaw 通过配对机制控制谁可以与助手对话，以及设备节点如何接入网关。内容基于官方 Pairing。

私信（DM）配对

默认策略下，未配对用户发来的私信不会直接进入助手，而是收到一个配对码。你本地批准后，该用户才会被加入允许列表。

批准配对

openclaw pairing approve channel> code>

将替换为通道名（如 `whatsapp`、`telegram`），替换为用户收到的配对码。

策略说明

pairing（默认）：未知发件人需先配对，适合私信安全
open：不限制发件人（需在通道配置中显式允许，如 allowFrom: ["*"]）

详见官方文档与各通道配置说明。

设备节点配对

iOS / Android 节点、macOS 伴侣应用等通过网关的 WebSocket 与配对流程接入：

节点与网关在同一网络（或通过 Tailscale / SSH 等可达）
在节点端发起配对，网关会显示配对请求
在控制台或 CLI 中批准节点

详见 Nodes 与 Discovery。

向导配置

推荐使用 安装向导（openclaw onboard）完成首次配置。内容基于官方 Wizard。

运行向导

openclaw onboard --install-daemon

--install-daemon 会安装用户级系统服务（macOS launchd / Linux systemd），使网关在后台持续运行。

向导会做什么

网关 — 端口、绑定、Token 等
工作区 — 智能体工作目录与默认配置
通道 — 选择要启用的通道（WhatsApp、Telegram、Discord、iMessage 等）
技能 — 可选预置或社区技能
服务安装 — 将网关注册为系统服务（可选）

完成后

网关会按配置在后台运行
如需登录某个通道，再执行 openclaw channels login 完成扫码/登录
控制台地址：http://127.0.0.1:18789/（或你配置的端口）

修改安装方式后

若之后从 npm 安装改为从 git 安装（或反过来），可执行：

openclaw doctor

会检查并更新网关服务的入口等配置。