OpenClaw 是一个你可以部署在自己设备上的个人 AI 助理：它通过你常用的聊天软件（如 Telegram/WhatsApp/Slack/Discord 等）和你对话，也能运行工具（浏览器、文件、定时任务、节点设备等），核心由一个常驻后台的 Gateway 负责调度。
本文以"最快跑起来 + 最少踩坑"为目标，把官方文档与社区教程的关键步骤整理成一篇可直接照做的安装指南。
1. 安装前准备
1.1 系统与运行时
- Node.js：建议 Node >= 22（官方文档以此为前提）
- macOS / Linux：直接按本文步骤即可
- Windows：建议使用 WSL2 (Ubuntu)，原生 Windows 环境兼容性与工具链较麻烦
验证 Node 版本：
node -v
2. 安装 OpenClaw CLI
官方推荐一键脚本（macOS / Linux）：
curl -fsSL https://openclaw.ai/install.sh | bash
Windows PowerShell：
iwr -useb https://openclaw.ai/install.ps1 | iex
也可以选择全局安装：
npm install -g openclaw@latest
# 或
pnpm add -g openclaw@latest
3. 运行引导向导（onboard）
安装完成后，建议直接跑向导，它会把"模型、网关、工作区、渠道、技能、后台服务"等一次性配好：
openclaw onboard --install-daemon
向导会让你选择：
- Gateway 运行在本机还是远程
- 选择模型与鉴权方式（OAuth / API Key 等）
- 是否配置渠道（Telegram/WhatsApp/Discord…）
- 是否安装为后台服务（systemd/launchd；WSL2 可用 systemd）
提示：如果你要用 Telegram/WhatsApp，官方不建议用 Bun 作为运行时，优先用 Node（兼容性更稳）。
4. 启动与访问 Gateway（最关键）
如果你在向导里选择安装后台服务，通常 Gateway 已经在跑了：
openclaw gateway status
如果你要手动前台启动（便于看日志排障）：
openclaw gateway --port 18789 --verbose
确认 Gateway 已经启动后，用 curl 验证：
curl http://localhost:18789/v1/health
返回 {"ok":true} 就说明 Gateway 在正常工作了。
5. 连接渠道（以 Telegram 为例）
Gateway 启动后，需要把 Telegram Bot 接进来：
openclaw channel add telegram --token YOUR_BOT_TOKEN --gateway http://localhost:18789
然后私信你的 Bot 发送 /start，如果收到回复就说明渠道通了。
6. 常见问题
6.1 Gateway 启动报端口占用
默认端口 18789 可能被占用，换一个端口即可：
openclaw gateway --port 18790
6.2 渠道连不上
检查 Gateway 日志：
openclaw gateway logs --tail 50
6.3 想用本地模型
OpenClaw 支持 Ollama 等本地推理后端。配置文件中修改 llm.provider 即可。
6.4 后台服务管理
# 查看状态
openclaw daemon status
# 重启
openclaw daemon restart
# 停止
openclaw daemon stop