🚀 龙虾新手指南

OpenClaw一键安装教程：解决daemon安装失败的Python版本、权限与服务常驻问题

发布时间：2026-07-15 分类：龙虾新手指南

摘要：OpenClaw 一键安装实测指南npm install -g openclaw@latest 能跑通，但 openclaw onboard --install-daemon 在 Windows/macOS/Linux 上大概率失败：Python 版本错、npm 缓存卡住、权限不足、服务无法常驻。这篇记录我踩完所有坑后的实操路径——3 分钟让 daemon 真正开机就待命。问题opencla...

OpenClaw 一键安装实测指南

npm install -g openclaw@latest 能跑通，但 openclaw onboard --install-daemon 在 Windows/macOS/Linux 上大概率失败：Python 版本错、npm 缓存卡住、权限不足、服务无法常驻。这篇记录我踩完所有坑后的实操路径——3 分钟让 daemon 真正开机就待命。

问题

openclaw 命令可用，但 openclaw onboard --install-daemon 报错：

Windows：Error: Python not found 或 Failed to start service
macOS：Permission denied 或 launchd: Could not find job
Linux：Unit file not found 或 python3: command not found

根本原因：OpenClaw daemon 依赖 Python 3.9–3.11（不支持 3.12+，也不兼容 3.8–），且必须调用系统级 python3，不能用 conda 或 virtualenv 里的解释器。

方案

三步解决：

锁定 Python 版本（强制使用 3.11）
清缓存 + 强制重装（绕过 npm 的版本缓存逻辑）
按平台配权限 + 启动服务（纯命令行，不依赖 GUI）

步骤

✅ 第一步：确认并锁定 Python

OpenClaw daemon 只认 python3 命令指向 3.9–3.11。检查当前版本：

python3 --version

如果输出是 3.12.1 或 3.8.10，立刻切换：

Windows（推荐）：下载 Python 3.11.9 → 安装时勾选 “Add Python to PATH” → 重启终端

macOS：

brew install python@3.11
sudo ln -sf /opt/homebrew/bin/python3.11 /usr/local/bin/python3

Linux（Ubuntu/Debian）：

sudo apt update && sudo apt install python3.11 python3.11-venv
sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.11 1

⚠️ 为什么？daemon 内部硬编码调用 subprocess.run(['python3', ...])。3.12 的 asyncio 行为变更会导致启动后秒退；3.8 缺 zoneinfo，时间校验失败。

✅ 第二步：清缓存 + 全局重装

npm 默认跳过“太新的包”，但 OpenClaw 发布频繁，缓存常卡在旧版：

npm cache clean --force
npm uninstall -g openclaw
npm install -g openclaw@latest --no-audit --no-fund

⚠️ 加 --no-audit --no-fund 是为了跳过 npm 自检阻塞，OpenClaw 是 CLI 工具，不需要审计依赖树。

✅ 第三步：按平台启动 daemon

Windows（PowerShell 管理员运行）：

openclaw onboard --install-daemon

![配图](https://yitb.com/usr/uploads/covers/cover_guides_20260714_201207.jpg)

# 验证
Get-Service openclaw | Select-Object Status, Name
# 应输出：Running  openclaw

macOS（终端执行）：

sudo openclaw onboard --install-daemon
# 验证
launchctl list | grep openclaw
# 应看到类似：7890    -    openclaw.daemon

Linux（systemd，Ubuntu/Debian/CentOS）：

sudo openclaw onboard --install-daemon
sudo systemctl enable openclaw
sudo systemctl start openclaw
# 验证
sudo systemctl is-active openclaw
# 应输出：active

⚠️ 必须 sudo：daemon 默认监听 localhost:3001，绑定该端口需 root 权限；服务注册也要写入 /etc/systemd/system/ 或 /Library/LaunchDaemons/。

验证

无论哪个平台，执行：

curl http://localhost:3001/health

返回 {"status":"ok","uptime":123} 即成功。

再试真实请求（比如触发本地 AI 工作流）：

curl -X POST http://localhost:3001/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{"model":"llama3","messages":[{"role":"user","content":"hi"}]}'

有 JSON 响应 → daemon 已就绪，可接 Dify/Coze/Cursor 插件。

常见错误速查

错误提示	原因	解决
`Error: Python not found`	`python3` 命令不可用或版本不对	运行 `which python3`，按第一步重装 3.11
`EACCES: permission denied`	npm 全局目录权限混乱	`sudo chown -R $(whoami) $(npm config get prefix)/lib/node_modules`
`Failed to start service: 1067` (Win)	Python 路径含空格（如 `Program Files`）	重装 Python 到 `C:\python311`，手动设 `PATH`
`Job failed to load` (macOS)	launchd plist 文件损坏	`sudo rm /Library/LaunchDaemons/openclaw.plist` → 重跑 `--install-daemon`

下一步

daemon 跑通后，你已具备本地 AI 工具链底座。下一步可：

所有教程均基于本次实测环境（Python 3.11.9 + openclaw@0.8.4 + npm 10.8.1），版本号写死，拒绝“可能可以”。

返回首页