第二章：安装、环境准备与快速上手

本章目标是跑通最小闭环：安装 CLI，完成 onboarding，启动 Gateway，打开 Control UI，并发送第一条消息。

2.1 环境要求

官方推荐 Node.js 24，也支持 Node.js 22.14+。macOS、Linux、Windows 都可使用，Windows 推荐 WSL2。还需要一个模型供应商 API Key、OAuth 授权或可用本地模型服务。检查 Node：

node --version

2.2 安装方式

macOS / Linux 可用官方脚本：

curl -fsSL https://openclaw.ai/install.sh | bash

Windows PowerShell：

iwr -useb https://openclaw.ai/install.ps1 | iex

也可以使用 npm：

npm install -g openclaw@latest

验证：

openclaw --help

2.3 推荐 onboarding

openclaw onboard --install-daemon

onboarding 会引导选择模型、配置认证、初始化 Gateway、创建工作区，并可安装用户级守护进程。守护进程让 Gateway 长驻运行，这是个人助手体验的关键。

2.4 启动与检查

查看 Gateway：

openclaw gateway status

前台启动调试：

openclaw gateway --port 18789 --verbose

打开浏览器控制台：

openclaw dashboard

默认地址通常是 http://127.0.0.1:18789/。

2.5 第一条消息

Control UI 中直接输入即可。CLI 方式：

openclaw agent --message "你好，请介绍一下 OpenClaw" --thinking high

如果已经接入通道，可使用 message 命令向目标发送消息，目标格式因通道而异。

2.6 第一个通道选择

推荐顺序：WebChat 最简单；Telegram 通常只需 Bot token；Discord/Slack 适合社区或工作区；WhatsApp 需要 QR 配对；BlueBubbles、Signal、WeChat、QQ 等更依赖平台或插件环境。

2.7 配置文件

默认配置：

~/.openclaw/openclaw.json

它是 JSON5。常见操作：

openclaw config get agents.defaults.workspace
openclaw config set agents.defaults.heartbeat.every "2h"
openclaw configure

不要把包含 token 或 key 的配置提交到公开仓库。

2.8 doctor

遇到问题先运行：

openclaw doctor
openclaw models status

doctor 可检查配置、通道、模型、文件权限和安全风险。必要时可使用 openclaw doctor --fix，但应阅读它将修改的内容。

2.9 Docker

Docker 是可选部署方式。典型流程：

export OPENCLAW_IMAGE="ghcr.io/openclaw/openclaw:latest"
./scripts/docker/setup.sh

Docker 中访问宿主机 Ollama/LM Studio 时通常使用 host.docker.internal，并确保状态目录持久化。Docker 运行 Gateway 与 Docker 作为沙箱 backend 是两个概念。

2.10 更新

openclaw update --channel stable
openclaw doctor

长期使用优先 stable；beta/dev 适合测试新功能。更新前备份配置、工作区和通道状态。