OpenClaw 本地部署指南
OpenClaw 是一个支持自托管的 AI 管家系统。它在本地或服务器上启动一个网关，接入飞书、Telegram 等聊天渠道，支持插件、工具调用、定时任务和仪表盘。它的目标是将 AI 变成能实际干活的助手，而不仅仅是聊天机器人。
快速安装（推荐）
在 macOS、Linux 或 WSL2 环境下，直接执行以下命令即可一键安装：
curl -fsSL https://openclaw.ai/install.sh | bash
安装完成后，建议运行新手引导来配置服务：
openclaw onboard --install-daemon
环境检查与前置条件
为了避免后续报错，安装前请确保满足以下基础要求：
- Node.js >= 22
- 操作系统：macOS / Linux / Windows (WSL2)
先检查当前版本是否符合要求：
node -v
npm -v
如果 Node 版本过低，请先升级。macOS 用户推荐使用 Homebrew，Linux 用户可使用官方源或 NodeSource。
验证安装状态
安装完成后，通过以下三个步骤确认服务是否正常运行：
1. 诊断检查
强烈建议先运行诊断工具，它能自动检测潜在的环境问题。
openclaw doctor
2. 查看运行状态
确认守护进程和网关是否已启动。
openclaw status
3. 打开管理仪表盘
通过浏览器访问本地仪表盘进行可视化配置。
openclaw dashboard
备选安装方式
如果你已经拥有 Node/npm 环境，或者希望参与源码贡献，可以选择以下方式：
方式 A：手动全局安装
适用于已有开发环境的用户。
npm install -g openclaw@latest
openclaw onboard --install-daemon
macOS 常见报错处理：
如果遇到 sharp 原生编译问题，可以通过忽略全局 libvips 来绕过：
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
方式 B：从源码安装
适合需要二次开发或贡献代码的场景。
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build
openclaw onboard --install-daemon
