?? 龍蝦新手指南

OpenClaw一鍵安裝教程：解決daemon安裝失敗的Python版本、權(quán)限與服務(wù)常駐問題

發(fā)布時間：2026-07-15 分類：龍蝦新手指南

摘要：OpenClaw 一鍵安裝實(shí)測指南npm install -g openclaw@latest 能跑通，但 openclaw onboard --install-daemon 在 Windows/macOS/Linux 上大概率失敗：Python 版本錯、npm 緩存卡住、權(quán)限不足、服務(wù)無法常駐。這篇記錄我踩完所有坑后的實(shí)操路徑——3 分鐘讓 daemon 真正開機(jī)就待命。問題opencla...

OpenClaw 一鍵安裝實(shí)測指南

npm install -g openclaw@latest 能跑通，但 openclaw onboard --install-daemon 在 Windows/macOS/Linux 上大概率失敗：Python 版本錯、npm 緩存卡住、權(quán)限不足、服務(wù)無法常駐。這篇記錄我踩完所有坑后的實(shí)操路徑——3 分鐘讓 daemon 真正開機(jī)就待命。

問題

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–），且必須調(diào)用系統(tǒng)級 python3，不能用 conda 或 virtualenv 里的解釋器。

方案

三步解決：

鎖定 Python 版本（強(qiáng)制使用 3.11）
清緩存 + 強(qiáng)制重裝（繞過 npm 的版本緩存邏輯）
按平臺配權(quán)限 + 啟動服務(wù)（純命令行，不依賴 GUI）

步驟

? 第一步：確認(rèn)并鎖定 Python

OpenClaw daemon 只認(rèn) python3 命令指向 3.9–3.11。檢查當(dāng)前版本：

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 內(nèi)部硬編碼調(diào)用 subprocess.run(['python3', ...])。3.12 的 asyncio 行為變更會導(dǎo)致啟動后秒退；3.8 缺 zoneinfo，時間校驗(yàn)失敗。

? 第二步：清緩存 + 全局重裝

npm 默認(rèn)跳過“太新的包”，但 OpenClaw 發(fā)布頻繁，緩存常卡在舊版：

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 管理員運(yùn)行）：

openclaw onboard --install-daemon

![配圖](http://www.xmhny.cn/usr/uploads/covers/cover_guides_20260714_201207.jpg)

# 驗(yàn)證
Get-Service openclaw | Select-Object Status, Name
# 應(yīng)輸出：Running  openclaw

macOS（終端執(zhí)行）：

sudo openclaw onboard --install-daemon
# 驗(yàn)證
launchctl list | grep openclaw
# 應(yīng)看到類似：7890    -    openclaw.daemon

Linux（systemd，Ubuntu/Debian/CentOS）：

sudo openclaw onboard --install-daemon
sudo systemctl enable openclaw
sudo systemctl start openclaw
# 驗(yàn)證
sudo systemctl is-active openclaw
# 應(yīng)輸出：active

?? 必須 sudo：daemon 默認(rèn)監(jiān)聽 localhost:3001，綁定該端口需 root 權(quán)限；服務(wù)注冊也要寫入 /etc/systemd/system/ 或 /Library/LaunchDaemons/。

驗(yàn)證

無論哪個平臺，執(zhí)行：

curl http://localhost:3001/health

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

再試真實(shí)請求（比如觸發(fā)本地 AI 工作流）：

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

有 JSON 響應(yīng) → daemon 已就緒，可接 Dify/Coze/Cursor 插件。

常見錯誤速查

錯誤提示	原因	解決
`Error: Python not found`	`python3` 命令不可用或版本不對	運(yùn)行 `which python3`，按第一步重裝 3.11
`EACCES: permission denied`	npm 全局目錄權(quán)限混亂	`sudo chown -R $(whoami) $(npm config get prefix)/lib/node_modules`
`Failed to start service: 1067` (Win)	Python 路徑含空格（如 `Program Files`）	重裝 Python 到 `C:\python311`，手動設(shè) `PATH`
`Job failed to load` (macOS)	launchd plist 文件損壞	`sudo rm /Library/LaunchDaemons/openclaw.plist` → 重跑 `--install-daemon`

下一步

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

所有教程均基于本次實(shí)測環(huán)境（Python 3.11.9 + openclaw@0.8.4 + npm 10.8.1），版本號寫死，拒絕“可能可以”。

返回首頁

欧美www-老司机精品福利视频-一卡二卡三卡四卡-女人扒开腿免费视频app-日本免费网址-一本到在线-亚洲性xxxx-中国大陆毛片-中国美女囗交视频-欧美裸体性生活-中文字幕11页中文字幕11页