OpenClaw 自托管 AI 管家安装与配置指南
OpenClaw 是一款支持自托管的 AI 管家系统,可接入飞书、Telegram 等渠道实现自动化任务。本文介绍在 macOS/Linux/WSL2 环境下通过 npm 或官方脚本安装 OpenClaw 的步骤,包括环境检查(Node.js 22+)、服务验证(doctor/status/dashboard)及常见问题排查。同时提供源码安装方式及接入飞书等实际应用场景说明,帮助用户将 AI 能力集成到本地工作流中。

OpenClaw 是一款支持自托管的 AI 管家系统,可接入飞书、Telegram 等渠道实现自动化任务。本文介绍在 macOS/Linux/WSL2 环境下通过 npm 或官方脚本安装 OpenClaw 的步骤,包括环境检查(Node.js 22+)、服务验证(doctor/status/dashboard)及常见问题排查。同时提供源码安装方式及接入飞书等实际应用场景说明,帮助用户将 AI 能力集成到本地工作流中。

OpenClaw 是一个支持自托管的 AI 管家系统:在本地或服务器启动 Gateway,接入飞书、Telegram 等聊天渠道,支持插件、工具调用、定时任务和仪表盘。适合把 AI 变成能干活的助手,而不仅是聊天。
macOS / Linux / WSL2 直接执行:
curl -fsSL https://openclaw.ai/install.sh | bash
安装完成后运行新手引导(建议执行,会把服务也配置好):
openclaw onboard --install-daemon
OpenClaw 需要:
先检查版本:
node -v
npm -v
如果 Node 版本过低:先升级 Node 再继续(macOS 常用 Homebrew;Linux 可用官方源/NodeSource)。
建议依次跑这三条:
openclaw doctor
openclaw status
openclaw dashboard
npm install -g openclaw@latest
openclaw onboard --install-daemon
有些环境会遇到 sharp 原生编译问题,可以用预编译包绕过:
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build
openclaw onboard --install-daemon
99% 是 npm 全局 bin 不在 PATH。
检查:
npm prefix -g
echo "$PATH"
修复(macOS/Linux):
export PATH="$(npm prefix -g)/bin:$PATH"
然后重开终端(zsh 可执行 rehash)。
openclaw doctoropenclaw status / openclaw gateway status用户也可借助 AI 编程助手(如 Claude Code)辅助完成环境检查与安装步骤,具体命令需根据当前终端环境适配。
参考官方文档接入飞书机器人。
注意:请确保安装最新版本以修复已知安全漏洞,第三方技能可能存在数据泄露风险,安装时需谨慎。

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online
基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online
JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online
Terser 压缩、变量名混淆,或 javascript-obfuscator 高强度混淆(体积会增大)。 在线工具,JavaScript 压缩与混淆在线工具,online