快速开始

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

环境要求

• Node.js ≥ 22

1. 安装 CLI

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

npm install -g openclaw@latest
# 或
pnpm add -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
openclaw onboard --install-daemon

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

下一步

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