?? 龍蝦新手指南

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

![配圖](http://m.nhjb.com.cn/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），版本號寫死，拒絕“可能可以”。

返回首頁