使用 AI 代理在任何裝置上透過聊天平台控制你的電腦
什麼是 OpenClaw？
OpenClaw（原名 Clawdbot）是一個開源的 AI 代理框架，讓你能夠在自己的硬體或伺服器上運行強大的 AI 助手（支援 Claude、GPT 或透過 Ollama 使用本地模型）。你可以透過常見的聊天應用程式（如 Telegram、WhatsApp、Discord、Slack 和 Signal）來遠端控制你的電腦、瀏覽網頁並執行各種任務。
主要特色
- 多種 AI 模型支援：Anthropic Claude、OpenAI GPT、Ollama 本地模型
- 多平台整合：支援 Telegram、WhatsApp、Discord、Slack、Signal
- 隱私與安全：所有資料都在你的裝置上處理
- 遠端控制：從任何地方透過聊天應用程式控制你的電腦
- 管理儀表板：內建 Web 介面管理和監控
系統需求與準備工作
系統需求
- 作業系統：macOS、Windows 或 Linux（建議伺服器部署使用 Ubuntu）
- 網路連線：需要網際網路連線以與 AI 模型和聊天平台通訊
- 硬碟空間：至少 500MB 可用空間
準備清單
在開始安裝前，請先準備以下項目：1. AI 模型 API 金鑰（擇一）
- Anthropic Claude：前往 Anthropic Console 申請 API 金鑰
- OpenAI GPT：前往 OpenAI Platform 申請 API 金鑰
- Ollama：如果要使用本地模型，請先安裝 Ollama
2. 聊天平台帳號（擇一或多個）
Telegram 選項：
- 需要一個 Telegram 帳號
- 需要建立 Telegram Bot 並取得 Bot Token
- 前往 @BotFather 建立機器人
WhatsApp 選項：
- 需要一個次要裝置/號碼用於連結（使用 WhatsApp Web 協定）
- 或可使用現有帳號進行連結
建議先決定要使用哪個聊天平台，並完成相關的準備工作。Telegram 設定較為簡單，適合初次使用者。
安裝步驟
Step 1: 執行安裝指令
OpenClaw 提供了一鍵安裝腳本，適用於 macOS、Linux 和 Windows。
macOS / Linux：
curl -fsSL https://openclaw.ai/install.sh | bash
Windows (PowerShell)：
irm https://openclaw.ai/install.ps1 | iex
此腳本會自動安裝 OpenClaw CLI 和必要的相依套件（如 Node.js，若尚未安裝）。
安裝完成後，你可以執行以下指令驗證安裝：
openclaw --version
Step 2: 運行初始化設定
安裝完成後，執行互動式引導設定工具：
openclaw onboard此指令會啟動一個互動式精靈，引導你完成以下設定：
- 選擇 AI 模型供應商
- 設定聊天平台
- 配置安全性選項
Step 3: 選擇 AI 模型供應商
在引導過程中，系統會詢問你想使用哪個 AI 模型供應商：
? 請選擇 AI 模型供應商:
> Anthropic (Claude)
OpenAI (GPT)
Ollama (本地模型)
選擇後，系統會要求你輸入對應的 API 金鑰：
? 請輸入你的 Anthropic API 金鑰: sk-ant-xxxxx...
[!TIP] 如果你還沒有 API 金鑰，可以先中斷設定（Ctrl+C），先去申請金鑰後再重新執行
openclaw onboard。
Step 4: 設定聊天平台
接下來，系統會詢問你想使用哪個聊天平台：
? 請選擇聊天平台:
> Telegram
Discord
Slack
Signal
根據你的選擇，後續的設定步驟會有所不同。我們將在下一節詳細說明 Telegram 和 WhatsApp 的設定方式。
Telegram 機器人設定
1. 建立 Telegram Bot
在 Telegram 中搜尋並開啟 @BotFather，然後執行以下步驟：
- 傳送
/newbot指令 - 輸入你的機器人名稱（例如：
我的 OpenClaw 助手） - 輸入機器人的使用者名稱（必須以
_bot結尾，例如：my_openclaw_bot） - BotFather 會回傳你的 Bot Token，類似：
1234567890:ABCdefGHIjklMNOpqrsTUVwxyz
2. 在 OpenClaw 中設定 Token
回到 openclaw onboard 終端機視窗，將剛才取得的 Bot Token 貼上：
? 請輸入你的 Telegram Bot Token: 1234567890:ABCdefGHIjklMNOpqrsTUVwxyz
系統會驗證 Token 的有效性，成功後會顯示：
✓ Token 驗證成功！
✓ OpenClaw 已成功連接到 Telegram
3. 配對授權
為了安全起見，OpenClaw 使用「配對」系統來防止未經授權的存取。
- 在 Telegram 中搜尋並開啟你剛建立的機器人
- 傳送任意訊息（例如：
/start或你好） - 機器人會回覆一組配對代碼（例如：
ABC123） - 回到終端機，執行以下指令查看待授權的配對請求：
openclaw pairing list telegram- 使用配對代碼授權：
openclaw pairing approve telegram ABC123
授權成功後，你就可以開始與機器人互動了！
WhatsApp 設定
1. 在 OpenClaw 中選擇 WhatsApp
在 openclaw onboard 引導過程中選擇 WhatsApp 後，終端機會顯示一個 QR Code。
2. 掃描 QR Code
- 開啟你的 WhatsApp 應用程式
- 前往 設定 → 連結的裝置
- 點擊 連結裝置
- 使用相機掃描終端機中顯示的 QR Code
3. 完成連結
掃描成功後，終端機會顯示：
✓ WhatsApp 已成功連接！
✓ 設定完成
[!WARNING] WhatsApp 使用 WhatsApp Web 協定，因此你的電腦需要保持網路連線。如果長時間離線，可能需要重新掃描 QR Code。
啟動與管理
啟動 OpenClaw 閘道器
完成所有設定後，執行以下指令啟動 OpenClaw 服務：
openclaw gateway start服務啟動後會顯示：
✓ OpenClaw 閘道器已啟動
✓ Telegram 連線正常
✓ Claude API 連線正常
✓ 服務運行於 http://127.0.0.1:18789
存取管理儀表板
OpenClaw 提供了一個 Web 介面來管理你的代理和查看日誌。
開啟瀏覽器並前往：
http://127.0.0.1:18789
或使用指令開啟儀表板：
openclaw dashboard停止服務
如需停止 OpenClaw 服務：
openclaw gateway stop查看日誌
查看服務運行日誌：
openclaw logs更新 OpenClaw
保持 OpenClaw 為最新版本：
openclaw update常見問題解答
Q1: 安裝後無法執行 openclaw 指令
A: 可能是環境變數路徑問題。請嘗試：
# macOS/Linux
export PATH="$HOME/.openclaw/bin:$PATH"
# 或重新載入 shell 設定
source ~/.bashrc # 或 ~/.zshrc
Q2: Telegram Bot 無法回應
A: 請檢查以下項目：
- 確認 OpenClaw 閘道器正在運行（
openclaw gateway status） - 確認已完成配對授權（
openclaw pairing list telegram） - 檢查 API 金鑰是否有效且有足夠的額度
- 查看日誌檔案尋找錯誤訊息（
openclaw logs）
Q3: WhatsApp QR Code 掃描後顯示錯誤
A: 請嘗試：
- 重新啟動 OpenClaw 服務
- 確認 WhatsApp 版本為最新
- 檢查網路連線是否穩定
- 使用
openclaw onboard --reset重置設定後重新設定
Q4: 如何切換 AI 模型？
A: 使用設定指令：
openclaw config set model anthropic # 切換到 Claude
openclaw config set model openai # 切換到 GPT
openclaw config set model ollama # 切換到本地模型
Q5: 可以同時使用多個聊天平台嗎？
A: 可以！執行 openclaw onboard 時可以選擇多個平台，或稍後使用以下指令新增：
openclaw channel add telegram
openclaw channel add whatsapp
Q6: OpenClaw 是否需要持續運行？
A: 是的，OpenClaw 閘道器需要持續運行才能接收和處理訊息。你可以：
- 在本地電腦上運行（需要電腦保持開啟）
- 部署到雲端伺服器（例如 AWS、GCP、DigitalOcean）
- 使用 Docker 容器化部署
Q7: 如何確保 OpenClaw 安全？
A: OpenClaw 提供多層安全保護：
- 配對系統：只有經過授權的裝置才能使用
- API 金鑰加密：敏感資訊加密儲存
- 本地部署：所有資料都在你的控制下
建議額外措施：
- 定期更新 OpenClaw 到最新版本
- 使用強密碼和雙重認證保護聊天平台帳號
- 不要分享你的 Bot Token 或 API 金鑰
- 在不使用時停止閘道器服務
結語
恭喜你完成 OpenClaw 的安裝與設定！現在你可以透過聊天應用程式享受 AI 代理帶來的便利。無論是自動化日常任務、遠端控制電腦，還是進行複雜的資料處理，OpenClaw 都能成為你的得力助手。
如果在使用過程中遇到任何問題，歡迎參考官方文件或加入社群尋求協助。祝你使用愉快！
