安装与部署

这一课你将能做到

1. 在 macOS / Linux / Windows 上用官方脚本完成安装
2. 用 openclaw onboard 完成初始化并把 Gateway 装成开机自启的系统服务
3. 说清楚本地、Docker、VPS 三种部署形态各自的适用场景

为什么要学

团队 bot 和个人玩具的区别就一个字：稳。你笔记本上前台跑的进程，合上盖子就死；同事的值班问答 bot 不能这样。这一课解决的是「让 Gateway 像 nginx 一样常驻、崩溃自愈、重启自恢复」。

人话：装软件谁都会，装成「服务」才是工程。

先建立图像

安装完成后，你磁盘和系统里会多出这些东西：

~/.openclaw/                    ← 状态目录：配置、会话、记忆、插件
├── openclaw.json               ← 主配置文件
├── workspace/                  ← agent 工作区（SOUL.md 等）
└── ...

系统服务层（openclaw gateway install 写入）：
├── macOS    → LaunchAgent（~/Library/LaunchAgents/）
├── Linux    → systemd user unit
└── Windows  → Scheduled Task（计划任务）

进程：
openclaw gateway  ← 常驻，默认监听 127.0.0.1:18789

跟着做

步骤 1：安装（三选一）

macOS / Linux / WSL 推荐官方一键脚本（会自动检测并装 Node 24）：

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

Windows 用 PowerShell：

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

已有 Node 24+ 的话，直接 npm 全局装也行：

npm i -g openclaw

步骤 2：初始化

openclaw onboard

向导会引导你选模型 Provider（可复用已有的 Claude Code / Codex CLI 登录态，或填 API key），并写入 ~/.openclaw/openclaw.json。选 Quick start 可跳过大部分选项。全程无人值守部署时用非交互模式：

openclaw onboard --non-interactive --accept-risk --skip-health \
  --mode local --auth-choice openai-api-key --skip-channels --no-install-daemon

步骤 3：装成系统服务

onboard 结束后 Gateway 是前台进程，Ctrl+C 停掉它，然后：

openclaw gateway install

这一条命令在 macOS 写 LaunchAgent、Linux/WSL2 写 systemd user unit、Windows 写计划任务，实现登录自启 + 崩溃拉起。

步骤 4：验证

openclaw gateway status    # 应看到监听在 18789 端口
openclaw dashboard         # 打开 Web 控制台发一条消息测试

步骤 5：Docker / VPS 路径（团队共享实例）

Docker 部署时把状态目录挂出来即可：

docker run -d --name openclaw \
  -v openclaw-data:/home/node/.openclaw \
  -p 18789:18789 \
  openclaw/openclaw:latest