OpenClaw 快速开始
从零开始，按照以下步骤完成 OpenClaw 的安装和配置
最快体验路径
如果你只想快速体验，一行命令即可启动 Dashboard 开始聊天：
bash
$ openclaw dashboard → http://127.0.0.1:18789/
1
OpenClaw 环境要求
在开始之前，请确保你的系统满足以下要求：
Node.js ≥ 22
必需，用于运行 OpenClaw
操作系统
macOS、Linux 或 Windows (推荐 WSL2)
Brave Search API (可选)
用于启用网络搜索功能
Windows
Windows 用户强烈建议使用 WSL2 环境，可获得更好的兼容性和性能。
2
安装 OpenClaw
选择适合你的安装方式，推荐使用 One-liner 一键安装：
bash
curl -fsSL https://openclaw.ai/install.sh | bash
One-liner 会自动检测并安装 Node.js 和所有依赖，无需手动配置环境。
bash
npm install -g openclaw@latest
# 或
pnpm add -g openclaw@latest
bash
git clone https://github.com/openclaw/openclaw.git
cd openclaw
npm install
npm run build
npm link
3
OpenClaw 配置向导
配置向导会引导你完成所有必要的设置，包括网关、认证和聊天平台连接：
bash
$ openclaw onboard --install-daemon向导将配置以下内容：
- 网关类型：选择本地或远程网关
- AI 模型认证：OpenAI (OAuth/API Key) 或 Anthropic (推荐) API Key，也支持 claude setup-token
- 聊天平台：WhatsApp 二维码、Telegram/Discord Bot Token 等
- 守护进程：后台服务安装 (macOS: launchd, Linux: systemd)
配置文件存放位置（重要）
~/.openclaw/
如果你已经安装了 Claude Code，可以通过 claude setup-token 复用现有凭证，无需重新配置。
无显示器的服务器部署提示：先在有图形界面的机器上完成 OAuth 认证，然后将 oauth.json 文件复制到服务器的对应目录。
4
启动 OpenClaw 网关
网关是 OpenClaw 的核心服务，负责处理所有消息：
检查服务状态：
bash
$ openclaw gateway status手动启动网关 (如需指定端口)：
bash
$ openclaw gateway --port 18789访问 Web Dashboard：
5
连接聊天平台
配对并连接你的第一个聊天界面：
WhatsApp (二维码登录)
bash
$ openclaw channel s login运行命令后会显示 QR 码，打开 WhatsApp → 设置 → 已连接设备 → 扫描二维码即可完成连接。
建议使用专用手机号，不推荐使用 VoIP 号码（容易被封号）。凭证存储在 ~/.openclaw/credentials/whatsapp/ 目录。
Telegram / Discord / 其他
向导可以帮你配置 Token，如果你更喜欢手动配置，请参考以下文档：
Telegram 提示：你的第一条私信会返回一个配对码，需要批准它（见下一步），否则机器人不会响应。
6
OpenClaw 安全配置
确保只有授权用户可以使用你的 AI 助手：
默认状态：未知的 DM 会获得一个随机代码，消息不会在未经批准前处理。如果你的第一条 DM 没有收到回复，请批准配对：
bash
$ openclaw pairing list whatsapp批准配对（将 <code> 替换为实际代码）
bash
$ openclaw pairing approve whatsapp <code>
这是一个重要的安全隔离，防止未授权用户访问你的 AI 助手。你也可以在配置文件中设置 allowlist 来自允许许配对电话号。
7
验证 OpenClaw
在新私信中，发送一条测试消息：
bash
$ openclaw message send --target +15555550123 --message "hello from OpenClaw"
如果 openclaw health 显示「未配置授权」，请回到向导并设置 OAuth/密钥授权—没有代理，代理将无法响应。
OpenClaw 配置完成
恭喜！你已成功完成 OpenClaw 的安装和配置。现在可以开始使用 AI 助手了。