入门指南
约 881 字大约 3 分钟
快速开始
本文介绍从零安装 OpenClaw 到发送第一条消息的完整流程。内容基于 官方 Getting Started。
环境要求
- Node.js ≥ 22
1. 安装 CLI
推荐全局安装(npm 或 pnpm):
npm install -g openclaw@latest
## 或2. 运行向导并安装服务
向导会引导你完成网关、工作区、通道与技能的配置,并安装系统服务(launchd / systemd 用户服务),使网关在后台常驻:
openclaw onboard --install-daemon3. 登录通道(例如 WhatsApp)
openclaw channels login按提示完成扫码或登录,凭证会保存在 ~/.openclaw/credentials。
4. 启动网关
向导完成后,网关会由安装的服务自动运行。如需手动启动:
openclaw gateway --port 187895. 打开控制台
在浏览器访问:
即可使用控制台进行对话、查看会话与配置。
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 ... 从仓库运行命令。
下一步
配对连接
OpenClaw 通过配对机制控制谁可以与助手对话,以及设备节点如何接入网关。内容基于 官方 Pairing。
私信(DM)配对
默认策略下,未配对用户发来的私信不会直接进入助手,而是收到一个配对码。你本地批准后,该用户才会被加入允许列表。
批准配对
openclaw pairing approve channel> code>将 替换为通道名(如 `whatsapp`、`telegram`), 替换为用户收到的配对码。
策略说明
- pairing(默认):未知发件人需先配对,适合私信安全
- open:不限制发件人(需在通道配置中显式允许,如
allowFrom: ["*"])
详见 官方文档 与各通道配置说明。
设备节点配对
iOS / Android 节点、macOS 伴侣应用等通过网关的 WebSocket 与配对流程接入:
- 节点与网关在同一网络(或通过 Tailscale / SSH 等可达)
- 在节点端发起配对,网关会显示配对请求
- 在控制台或 CLI 中批准节点
向导配置
推荐使用 安装向导(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会检查并更新网关服务的入口等配置。
