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



