SECTION
OpenClaw 安装教程
从环境准备到初始化向导，手把手完成 OpenClaw 安装并验证可用状态。
OpenClaw（原名 Clawdbot，过渡名 Moltbot）是一个开源、可自托管的 AI Agent 运行时平台。它不仅能对话，还能执行任务，例如文件处理、命令执行、浏览器操作和工作流调度。
本教程目标很明确：让你在 30 分钟内把 OpenClaw 跑起来，并完成首次可用验证。
1. 安装前准备
1.1 你需要准备什么
- 一台可联网设备（macOS、Linux、Windows 均可）
- Node.js
>= 22（走 npm 安装路线时必须） - 一个可用的大模型 API（推荐 OpenAI 或 Anthropic）
1.2 OpenClaw 运行形态
安装后你会得到两部分能力：
- 本地/服务器上的 Agent 运行时
- Gateway + Web UI（默认端口
18789）
默认访问地址通常是：
http://127.0.0.1:18789/chat
2. 安装方式选择
OpenClaw 支持两种主流安装路线：
- 一键脚本安装（推荐新手）
- Node.js + npm 全局安装（适合需要精细控制环境的用户）
如果你只想快速可用，优先选一键脚本。
3. 一键脚本安装（推荐）
3.1 macOS / Linux
curl -fsSL https://openclaw.ai/install.sh | bash
3.2 Windows
# PowerShell
iwr -useb https://openclaw.ai/install.ps1 | iex
# CMD
curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
脚本会自动完成环境检测、依赖安装，并进入 Onboarding 初始化向导。
3.3 重新进入向导
后续如果要重跑向导（修改模型、Channel、Hooks 等）：
openclaw onboard --install-daemon
4. Node.js + npm 安装（手动路线）
4.1 环境要求
必须满足：
- Node.js
>= 22
版本检查：
node -v
4.2 Node.js 安装示例（macOS）
方式 A：官网下载 LTS 安装包。
方式 B：Homebrew 安装。
brew install node
4.3 安装 OpenClaw
npm install -g openclaw@latest
安装后验证：
openclaw --version
5. Onboarding 向导：推荐操作顺序
启动向导：
openclaw onboard --install-daemon
5.1 安全确认
OpenClaw 会提示高权限执行风险，确认环境可控后再选择 Yes。
5.2 选择模式：QuickStart
新手建议直接 QuickStart，先跑通主流程。
5.3 模型选择建议
- 优先：OpenAI / Anthropic
- 若暂时不配模型：可先
Skip for now，后续在控制台配置
模型认证最终写入：
~/.openclaw/openclaw.json
5.4 Channel、Skills、Hooks 建议
- Channel：先
Skip（先保证主链路可用） - Skills：先
Skip for now - Hooks：建议启用
command-logger与session-memory
5.5 Gateway 与 Web UI
- Gateway 端口建议保留默认：
18789 - 选择
Open the Web UI后会自动打开控制台
6. 安装完成后如何验证
6.1 运行状态检查
openclaw status
openclaw health
openclaw gateway status
6.2 前台启动网关（调试用）
openclaw gateway --port 18789 --verbose
6.3 常用运维命令
openclaw onboard --install-daemon
openclaw doctor
openclaw dashboard
6.4 Web UI 验证
看到控制台并能发起对话，即安装成功。
7. 常见问题与处理
7.1 openclaw 命令找不到
- 检查 npm 全局路径是否在
PATH中 - 重新安装并重开终端
7.2 页面打不开 127.0.0.1:18789
- 先执行
openclaw gateway status - 端口冲突时更换端口再启动：
openclaw gateway --port 18888 --verbose
7.3 向导中模型调用失败
- 先确认 API Key 是否可用
- 检查
~/.openclaw/openclaw.json的baseUrl/apiKey - 暂时可跳过模型配置，后续在模型配置页面补上
8. 安装完成清单
openclaw --version有输出openclaw status正常- 能打开
http://127.0.0.1:18789/chat - 至少配置 1 个可用模型
完成上述 4 项后，你的 OpenClaw 已具备可用基础。
下一步建议阅读：OpenClaw 模型配置 。