OpenClaw本地安装实战指南：3分钟跑通，绕过npm报错直连AI工作流

你执行 npm install -g openclaw@latest，终端卡在 preinstall，报错 ERR! lifecycle scripts not allowed；或者运行 openclaw onboard --install-daemon 时提示 Failed to start openclaw-daemon.service。这不是环境问题——是 npm 12+ 默认禁用生命周期脚本导致的兼容性断裂。2026年8月实测中，Node.js 18.20.2 / 20.15.0 / 22.10.0 均复现该问题。修复只需三步，不升级 npm，不降级 Node。

OpenClaw 是一个轻量级本地 AI 代理网关，把 ChatGPT、Claude、Ollama 等模型统一接入 Cursor、Dify 或你的 Python 脚本。它不是玩具，是连接「AI 能力」和「开发工具」的物理接口——像 USB-C 转接头，插上就通电。

步骤一：确认 Node 版本并选择安全组合

先检查当前环境：

node -v && npm -v

✅ 2026年8月实测兼容表（仅推荐以下组合，其他版本会触发 daemon 注册失败）：

💡 OpenClaw daemon 依赖 systemd 服务文件生成。Node 22+ 的 npm 默认禁用 scripts，服务文件根本不会写入 /etc/systemd/system/。

步骤二：绕过 Lifecycle Scripts，强制安装

别直接 npm install -g openclaw。
用这行命令跳过所有被拦截的脚本：

npm install -g openclaw@latest --ignore-scripts

然后手动补全关键动作（这才是真正“安装”的部分）：

# 进入全局 node_modules 目录（Mac/Linux）
cd $(npm root -g)/openclaw

# 手动运行原应由 postinstall 完成的 daemon 注册
sudo node ./scripts/install-daemon.js




👉 <a href="https://idsoo.com/go/binance.html" rel="nofollow noopener" target="_blank">Binance</a> · <a href="https://idsoo.com/go/okx.html" rel="nofollow noopener" target="_blank">OKX</a> · <a href="https://idsoo.com/go/gate.html" rel="nofollow noopener" target="_blank">Gate.io</a> · <a href="https://idsoo.com/go/htx.html" rel="nofollow noopener" target="_blank">HTX</a> · <a href="https://idsoo.com/go/bitget.html" rel="nofollow noopener" target="_blank">Bitget</a>

# 启动服务（非 root 用户需输密码）
sudo systemctl start openclaw-daemon

💡 --ignore-scripts 只跳过自动执行，但 OpenClaw 的核心是后台常驻进程。install-daemon.js 负责生成 systemd 服务配置、设开机自启、开放本地端口 http://localhost:3000——这才是你后续调用 AI 的入口。

步骤三：验证是否真跑通

打开浏览器访问：

http://localhost:3000/health

看到 {"status":"ok","models":[]} 就成功了。再试一个真实请求：

curl -X POST http://localhost:3000/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-3-haiku",
    "messages": [{"role":"user","content":"你好，请用中文回答"}]
  }'

如果返回 JSON 中含 "content" 字段，说明 OpenClaw 已作为代理，把请求转发给了你配置的 Claude API——你本地机器现在就是一个 AI 中继站。

常见问题

Q：sudo systemctl start openclaw-daemon 报 Unit openclaw-daemon.service not found？
A：说明 install-daemon.js 没执行成功。检查是否在 openclaw 目录下运行，或改用绝对路径：

sudo node $(npm root -g)/openclaw/scripts/install-daemon.js

Q：访问 :3000/health 显示 Connection refused？
A：daemon 没启动。运行 sudo systemctl status openclaw-daemon 查日志，90% 是端口被占用。换端口启动：

sudo OPENCLAW_PORT=3001 systemctl start openclaw-daemon

Q：能启动但调用模型返回 401？
A：OpenClaw 本身不提供模型，只做路由。你需要在 ~/.openclaw/config.json 里填好 API Key（如 Anthropic 的 ANTHROPIC_API_KEY），教程见 yitb.com/openclaw-config。

装完 OpenClaw，你就能在 Cursor 里写代码时按 Ctrl+K 直接调用 Claude；在 Dify 里新增一个“OpenClaw API”工具节点；甚至用 Python requests 发请求，把本地 Ollama 模型接入 Coze Bot——不用改一行业务代码，AI 能力秒级注入现有工作流。

OpenClaw 是龙虾生态的「协议转换器」，它不替代 Claude 或 Ollama，而是让它们像 USB 设备一样即插即用。

👉 下一步：《OpenClaw + Ollama本地模型实战：离线运行Qwen2.5-7B》｜《用OpenClaw把AI接入Dify工作流（附JSON Schema模板）》