⚠️ 更新提示：本專案 (Moltbot) 已於 2026/01/30 正式更名為 OpenClaw。本文技術內容依然適用，但部分指令名稱可能有所變動。關於更名細節與新功能，請參考：OpenClaw 正式更名懶人包。
2026/01 更新：本工具已從 Clawdbot 改名為 Moltbot（因 Anthropic 商標問題）。 如果你是搜尋 Clawdbot 找到這篇，你來對地方了！npm 套件已改為
moltbot，但舊版clawdbot指令目前仍可使用。 本文指令以moltbot為主，如果你還在用舊版，請自行替換為clawdbot。
情境說明
用官方推薦的方式安裝 Moltbot（原 Clawdbot）CLI：
curl -fsSL https://molt.bot/install.sh | bash安裝過程看起來一切正常，但執行時卻跳出：
zsh: command not found: moltbot如果你使用 Volta 管理 Node.js 版本，這是一個常見的 PATH 衝突問題。
問題根源
curl install.sh 執行時會做這些事：
curl install.sh 執行流程：├── 安裝 Node 22+ / pnpm / git├── git clone https://github.com/moltbot/moltbot ~/moltbot├── pnpm build└── npm install -g → ~/.volta/tools/image/node/22.17.0/lib/node_modules/moltbot問題在於 Volta 會劫持 npm 的 global 安裝路徑。當你執行 npm install -g，套件實際上被安裝到：
~/.volta/tools/image/node/22.x.x/lib/node_modules/moltbot而不是標準的 ~/.local/bin 或 /usr/local/bin。
Volta 的 PATH 優先順序：
~/.volta/bin > ~/.volta/tools/*/bin > system > ~/.local/bin (curl 預期位置)結果：which moltbot 找不到指令，雖然檔案確實存在於 Volta 的 node_modules 目錄中。
診斷指令
在嘗試修復前，先確認問題：
# 找 moltbot 真實位置find ~/.volta ~/.npm-global -name "*moltbot*" 2>/dev/null
# 查看 npm global prefixnpm prefix -g
# 確認 bin 是否存在ls "$(npm prefix -g)/bin/moltbot"
# Volta 狀態volta --versionecho $PATH | grep voltawhich npm node如果 find 找到檔案但 which moltbot 找不到，就是 PATH 衝突問題。
解法對照表
| 解法 | 指令 | 優點 | 缺點 |
|---|---|---|---|
| Volta install ⭐ | volta install moltbot@latest | 1 行搞定，自動 shim，Node 升級跟隨 | 綁定 Volta |
| 修 PATH | export PATH="$HOME/.volta/tools/image/node/22.17.0/bin:$PATH" | 保留 curl 原版 | 要找 bin 路徑 |
| npm 重裝 | npm i -g moltbot --prefix ~/.local | 獨立於 Volta | 手動修 PATH |
完整修復步驟（Volta install）
推薦方案——使用 Volta 原生安裝：
# 1. Volta 一鍵安裝volta install moltbot@latest
# 2. 確認安裝成功which moltbot # → ~/.volta/bin/moltbotmoltbot --version # → x.x.x
# ⚠️ 注意：google-antigravity provider 已不建議使用！# 透過 OpenClaw 呼叫 Antigravity API 可能導致 Google 帳號被永久封禁（fban）# 建議改用 NVIDIA Build API 等替代方案，詳見：# https://zeroone.work/posts/openclaw-kimi-k2-5-advisor/
# 以下為舊版設定，僅供參考，請勿使用# moltbot plugins enable google-antigravity-auth# moltbot models auth login --provider google-antigravity --set-default# moltbot daemon restart
# 4. 測試/models # 顯示可用模型~/.zshrc 最佳配置
如果你需要手動調整 PATH，以下是推薦的配置：
# 1. Volta（原有設定）export VOLTA_HOME="$HOME/.volta"export PATH="$VOLTA_HOME/bin:$PATH"
# 2. Moltbot（如果使用「修 PATH」解法）# 注意：需要替換成你實際的 Node 版本號export PATH="$HOME/.volta/tools/image/node/22.17.0/bin:$PATH"
# 3. 自訂 ~/.local/bin（通用）export PATH="$HOME/.local/bin:$PATH"修改後執行：
source ~/.zshrc技術解釋
為什麼會這樣？
- curl install.sh 內部使用
npm install -g，但 Volta 劫持了 npm prefix，改為~/.volta/tools/image/node/xx/ - node_modules/.bin 沒有自動 symlink 到 PATH（這是 Volta 的特性）
- Volta shim 只自動管理 Node/yarn/pnpm，不會自動 shim 其他 global package
Volta 的 shim 機制
Volta 使用 shim（墊片）來攔截命令。當你執行 node、npm、yarn 時，實際上執行的是 ~/.volta/bin/ 下的 shim，shim 再根據專案設定選擇正確的版本。
但對於其他 global package（如 moltbot），Volta 不會自動建立 shim——除非你用 volta install 安裝。
額外管理指令
# 更新 Moltbotvolta install moltbot@latest# 或moltbot self-update
# 健康檢查moltbot doctor
# 查看 daemon 狀態moltbot daemon status
# 重啟 daemonmoltbot daemon restart常見問題
Q: volta install 和 npm install -g 有什麼差別？
A: volta install 會在 ~/.volta/bin/ 建立 shim，讓指令在任何地方都能使用。npm install -g 只會安裝到 Volta 管理的 node_modules，沒有自動的 PATH 設定。
Q: 更新 Node 版本後 moltbot 會失效嗎？
A: 如果用 volta install 安裝，不會。Volta 的 shim 會自動處理版本切換。
Q: 可以同時用 curl 和 volta 安裝嗎？
A: 不建議。這可能導致多個版本衝突，選擇一種方式即可。
總結
- 根本原因：Volta 劫持 npm global，導致 curl install.sh 安裝的 moltbot 找不到
- 最佳解法：
volta install moltbot@latest——一行指令，乾淨永久 - 測試環境：macOS, zsh, Volta + Node 22.17.0, 2026/01/26
參考來源：
Volta GitHub Issues - VS Code Terminal not using correct node version
回報錯字、失效連結，或告訴我你想看的延伸主題。