⚠️ 注意：安裝 OpenClaw 龍蝦涉及系統變更與網路操作，可能造成現有作業系統不穩定或資料遺失。建議不要直接安裝在目前使用中的主要作業系統上，最好使用虛擬機 (VM)、Docker 或隔離測試環境進行安裝，確保安全。
本完整指南專為新手設計，涵蓋 OpenClaw 龍蝦在 Windows 與 Mac 的安裝、Skills 模組管理、LLM API 串接與錯誤排除，並提供詳細案例和操作提示。
安裝前準備
開始安裝前，先確認系統環境與需求。Windows 使用 PowerShell 5.1 以上並需安裝 Python 3.10 以上，Mac 需安裝 Homebrew 與 Python 3.10 以上。建議關閉 VPN 或防火牆暫時，避免下載過程中被阻擋。Windows 需以「管理員」身份執行 PowerShell，Mac 則需要 sudo 權限進行安裝。安裝前確認磁碟空間至少 2GB，並保證網路穩定。
Windows 安裝流程
# 開啟 PowerShell（系統管理員）
iwr -useb https://openclaw.example.com/install.ps1 | iex
# 遇到執行政策阻擋
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
# 測試版本
openclaw --version
Mac 安裝流程
# 安裝 Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 安裝 OpenClaw
brew install openclaw
# 權限不足
sudo brew install openclaw
# 測試版本
openclaw --version
Skills 模組與 LLM API 設定
| Skill | 用途說明 | 安全下載方式 |
|---|---|---|
| chatbot | 提供文字對話功能 | 官方 Skill 庫 |
| summarizer | 文字摘要 | 官方 Skill 庫 |
| translator | 多語言翻譯 | 官方 Skill 庫 |
| calendar | 日曆管理與提醒 | 官方 Skill 庫 |
| notifier | 通知提醒與警示功能 | 官方 Skill 庫 |
| websearch | 即時網頁查詢 | 官方 Skill 庫 |
| 自動讀取、發送郵件 | 官方 Skill 庫 | |
| todo | 任務清單管理 | 官方 Skill 庫 |
| weather | 天氣查詢與預報 | 官方 Skill 庫 |
| calculator | 計算、公式運算 | 官方 Skill 庫 |
# 安裝範例
openclaw skill install chatbot
openclaw skill install summarizer
# 查看已安裝 Skills
openclaw skill list
# 移除 Skill
openclaw skill uninstall translator
# 設定 OpenAI API Key
# Windows
setx OPENAI_API_KEY "你的API_KEY"
# Mac
export OPENAI_API_KEY="你的API_KEY"
# 測試 LLM API
openclaw llm test --provider openai
網友推薦必裝 10 個 Skills
| Skill | 用途說明 | 安裝指令範例 |
|---|---|---|
| lossless-claw | 長期記憶，對話存入資料庫並壓縮摘要 | npx skills add Martian-Engineering/lossless-claw |
| self-improving-agent | 自動復盤，整理知識卡片 | npx skills add charon-fan/agent-playbook@self-improving-agent |
| skill-vetter | 裝新技能前安全檢查 | npx skills add useai-pro/openclaw-skills-security@skill-vetter |
| openclaw-backup | 定時備份設定檔與記憶庫 | npx skills add theagentservice/skills@openclaw-backup |
| bb-browser | 免登入操作本地瀏覽器 | npx skills add epiral/bb-browser@bb-browser |
| agent-browser | 自動操作網頁並抓取資料 | npx skills add vercel-labs/agent-browser@agent-browser |
| OpenCLI | 多平台一句話操作 CLI | npx skills add joeseesun/opencli-skill@opencli |
| cron-claw | 定時任務，自動抓取與生成報告 | npx skills add clawops/cron-claw@cron-claw |
| control-center | 多龍蝦管理面板 | npx skills add aradotso/trending-skills@openclaw-control-center |
| claw-router | 智慧分配任務給最合適龍蝦 | npx skills add clawops/claw-router@claw-router |
系統修復與更新
# 清除暫存
openclaw cache clear
# 更新 OpenClaw
openclaw update
# 回滾到指定版本
openclaw install --version 1.2.0
# 備份 config.yaml
# Windows
copy %APPDATA%\OpenClaw\config.yaml D:\backup\config_backup.yaml
# Mac
cp ~/Library/Application\ Support/OpenClaw/config.yaml ~/Backup/config_backup.yaml
注意事項與操作提示
- Mac 永久環境變數：在 ~/.zshrc 或 ~/.bash_profile 設定 export OPENAI_API_KEY=”你的API_KEY”，並 source ~/.zshrc
- Windows PowerShell 權限：如安裝遇到阻擋，執行 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser，並以管理員執行 PowerShell
- config.yaml 備份與恢復：備份後覆蓋原位置即可恢復
- 清除暫存與回滾：openclaw cache clear + openclaw update，或回退版本 openclaw install –version x.x.x
- Skills 安裝問題處理：openclaw skill cache clear + openclaw skill install <skill_name>
FAQ 常見問題
安裝 OpenClaw 時遇到 PowerShell 錯誤怎麼辦？
PowerShell 預設阻止執行網路下載腳本。使用指令 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser 可解決。
Skills 安裝失敗如何排除？
網路連線或緩存可能導致安裝失敗。使用 openclaw skill cache clear 清除緩存後再安裝即可。
LLM API 連線失敗怎麼辦？
API Key 錯誤或防火牆阻擋。可使用 ping api.openai.com 測試連線，確保 Key 無多餘空格。
程式執行當機或無回應怎麼處理？
舊版本或暫存可能導致程式當機。使用 openclaw cache clear 與 openclaw update 即可解決。
如何確認安裝是否成功？
版本號顯示代表核心套件已安裝。建議完成後測試 Skills 與 API 串接是否正常。
Mac 安裝遇到權限不足怎麼辦？
Homebrew 或 OpenClaw 安裝需要管理員權限。指令 sudo brew install openclaw 可解決權限問題。