OpenClaw 本地部署指南
OpenClaw 是一个支持自托管的 AI 管家系统。它允许你在本地或服务器上启动一个网关，接入飞书、Telegram 等聊天渠道，并支持插件、工具调用、定时任务和仪表盘。它的核心目标是将 AI 从单纯的聊天对象转变为能实际干活的助手。
前置检查
安装前请确保环境满足以下要求：
- Node.js >= 22
- 操作系统：macOS / Linux / Windows (WSL2)
建议先检查当前版本：
node -v
npm -v
如果 Node 版本过低，请先升级。macOS 用户常用 Homebrew，Linux 用户可使用官方源或 NodeSource。
快速安装（推荐）
在 macOS、Linux 或 WSL2 环境下，直接执行以下命令即可一键安装：
curl -fsSL https://openclaw.ai/install.sh | bash
安装完成后，建议运行新手引导脚本，这会自动配置好服务守护进程：
openclaw onboard --install-daemon
验证安装状态
安装后不要急着开始用，先确认服务真的跑起来了。依次执行以下三条命令：
1. 诊断检查
openclaw doctor
2. 查看运行状态
openclaw status
3. 打开管理仪表盘
openclaw dashboard
备选安装方式
如果你已经配置好了 Node/npm 环境，或者需要参与源码贡献，可以选择以下方式。
方式 A：手动全局安装
npm install -g openclaw@latest
openclaw onboard --install-daemon
注意： macOS 上如果遇到 sharp 原生编译报错，可以使用预编译包绕过：
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
常见问题排错
提示 "command not found"
如果安装成功但终端提示 openclaw: command not found，99% 的情况是 npm 的全局 bin 目录没有加入 PATH。
检查路径：
npm prefix -g
echo ""