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 "$PATH"
修复方法（macOS/Linux）：
export PATH="$(npm prefix -g)/bin:$PATH"
修改后记得重新加载终端配置（zsh 可执行 rehash 或重启终端）。
Node 版本与环境问题
在实际部署中，经常遇到 Node 版本不兼容的问题。例如某些旧环境默认是 Node 18，而 OpenClaw 需要 22+。如果遇到类似情况，优先升级 Node 到指定版本，并确保新安装的 Node 二进制文件已正确写入 PATH，否则新开终端窗口时可能无法识别命令。
后续建议
安装完成后，建议立刻做这三件事：
- 跑一遍自检：再次确认
openclaw doctor无报错。 - 确认服务正常：通过
openclaw status或openclaw gateway status确认守护进程存活。 - 规划入口渠道：选择一个日常使用的平台（如飞书、Telegram 或 Slack）作为主要入口，后续再逐步扩展插件和自动化任务。
官方文档
如需更详细的配置说明，请参考官方文档：
