OpenClaw 本地 AI 助手安装与配置指南
OpenClaw 是一个自托管的 AI 管家系统:在本地或服务器启动 Gateway,接入飞书、Telegram 等聊天渠道,支持插件、工具调用、定时任务和仪表盘。适合将 AI 转变为能实际工作的助手。
快速安装(推荐)
macOS / Linux / WSL2 直接执行以下命令:
curl -fsSL https://openclaw.ai/install.sh | bash
安装完成后运行新手引导(建议执行,会配置好服务):
openclaw onboard --install-daemon
1. 安装前检查
OpenClaw 需要以下环境:
- Node.js >= 22
- macOS / Linux / Windows (WSL2)
先检查版本:
node -v
npm -v
如果 Node 版本过低,请先升级 Node 再继续(macOS 常用 Homebrew;Linux 可用官方源/NodeSource)。
2. 安装后验证
建议依次运行以下命令确认服务状态:
2.1 诊断
openclaw doctor
2.2 查看运行状态
openclaw status
2.3 打开仪表盘
openclaw dashboard

3. 备选安装方式
方式 A:手动全局安装
如果你已有 Node/npm 环境:
npm install -g openclaw@latest
openclaw onboard --install-daemon
macOS 上 sharp 相关报错处理
部分环境可能遇到 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
4. 常见问题排错
提示 "openclaw: command not found"
通常是 npm 全局 bin 不在 PATH 环境变量中。
检查路径:



