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):


