newsence
來源篩選

OpenClaw Complete Setup Guide: Building Your 24/7 Personal AI Assistant – TechBoy

一介資男

OpenClaw 是 GitHub 68K+ Stars 的開源 AI 助手平台。本文從零開始教你安裝部署、設定 Telegram/Discord 管道、Skills 技能系統到自動化排程,打造你的 24/7 個人 AI 助手。

newsence

OpenClaw 完整建置指南:打造你的 24/7 個人 AI 助手 – 一介資男

一介資男
21 天前

AI 生成摘要

OpenClaw 是 GitHub 68K+ Stars 的開源 AI 助手平台。本文從零開始教你安裝部署、設定 Telegram/Discord 管道、Skills 技能系統到自動化排程,打造你的 24/7 個人 AI 助手。

OpenClaw 完整建置指南:打造你的 24/7 個人 AI 助手 – 一介資男

本篇文章更新時間:2026/02/08。如有資訊過時或語誤之處,歡迎使用 Contact 功能通知或向一介資男的 LINE 社群反應。如果本站內容對你有幫助,歡迎贊助支持。

內容目錄

一、前言:OpenClaw 是什麼?為什麼值得關注?

我們與 AI 互動的方式正在轉變。從最初在 ChatGPT 對話框裡一問一答,到如今的 AI Agent——能夠自主執行任務、操作真實世界工具的智慧代理人。這不再只是「聊天」,而是「委派工作」。

OpenClaw 正是這波浪潮中最受矚目的開源專案之一。它由 PSPDFKit 創辦人 Peter Steinberger 開發,在 GitHub 上獲得超過 68,000 顆星。OpenClaw 的核心理念是:打造一個你自己架設、自己控制的 24/7 個人 AI 助手。

你可以透過 WhatsApp、Telegram、Discord 等日常使用的通訊軟體,用自然語言下達指令,AI 代理人就會自主完成工作——收發信件、安排行程、瀏覽網頁、執行系統指令,甚至替你寫程式。

核心架構總覽

在深入安裝之前,先理解 OpenClaw 的主要元件:

適用情境 vs 不適用情境

適合使用 OpenClaw 的場景:

不太適合的場景:

與傳統自動化工具的差異

你可能聽過 n8n、Make(Integromat)或 Zapier 等自動化工具。它們透過「拖拉式工作流」讓你串接不同服務。OpenClaw 的路線完全不同:你用自然語言描述你想做什麼,AI 自主決定如何完成。不需要手動設計流程圖、不需要理解 API 參數——你只需要「說」,它就「做」。

當然,兩者可以互補。OpenClaw 擅長處理需要判斷力的模糊任務,而 n8n 等工具更適合高吞吐量、確定性的資料管線。

二、環境準備與系統需求

硬體需求

必要條件

在開始安裝之前,請確認你已準備好以下項目:

如果版本不足,建議使用 nvm 安裝最新 LTS 版。

支援平台

注意:如果你的環境資源極度受限(如 512MB RAM 的微型容器),OpenClaw 可能無法穩定運行。建議至少 2GB 記憶體起步。

三、安裝 OpenClaw

3.1 方式一:本地安裝(macOS/Linux)

這是最快速的上手方式,一行指令搞定:

這個安裝腳本會自動完成以下工作:

安裝完成後,執行入門精靈:

精靈會互動式地引導你完成以下設定:

為什麼用 --install-daemon? 沒有這個參數,Gateway 不會自動啟動。你每次重開機都得手動啟動。加上它,OpenClaw 就能真正做到 24/7 待命。

3.2 方式二:VPS + Docker 部署(推薦用於 24/7 運行)

如果你希望 AI 助手真正全天候運行,部署在 VPS 上搭配 Docker 是最穩定的方案。

VPS 供應商選擇建議

OpenClaw 不需要昂貴的伺服器,一台入門級 VPS 就足夠:

建議選擇 2 核心 / 4GB RAM 以上的規格,特別是如果你打算啟用瀏覽器自動化功能。

Docker 部署步驟

docker-setup.sh 會自動完成以下工作:

環境變數設定

Docker 部署支援以下環境變數,可在 .env 檔案中設定:

關鍵提醒:一定要設定 OPENCLAW_HOME_VOLUME。Docker 容器是臨時性的,如果不將 ~/.openclaw/ 目錄持久化到主機,每次重建容器都會遺失所有設定、記憶和技能。

手動 Docker 流程(進階使用者)

如果你偏好完全手動控制每個步驟:

權限注意事項

OpenClaw 的 Docker 容器以 UID 1000 的 node 使用者執行(非 root)。如果你的掛載目錄權限不正確,Gateway 會因為無法讀寫而失敗:

Linux VPS 上的 systemd 服務設定

如果你在 Linux 上不使用 Docker,可以透過 systemd 管理 Gateway:

為什麼需要 loginctl enable-linger? 預設情況下,Linux 會在使用者登出後終止其所有背景程序。啟用 lingering 後,即使你斷開 SSH 連線,Gateway 依然會持續運行。

3.3 首次登入與驗證

無論使用哪種安裝方式,完成後都可以透過以下步驟驗證:

或手動存取 http://127.0.0.1:18789/(VPS 上需設定 SSH 隧道或反向代理)。

首次登入時,系統會要求你貼入 Gateway Token——這在 onboard 完成時已經顯示過。如果忘記了:

看到控制面板的儀表板,恭喜你,OpenClaw 已成功運行!

四、通訊管道設定

OpenClaw 支援超過 20 種通訊管道。以下介紹最常用的幾種,建議從 Telegram 開始。

4.1 Telegram(最推薦的入門管道)

為什麼推薦 Telegram?

設定步驟

設定完成後,直接在 Telegram 對你的 Bot 發送訊息,就能開始與 AI 助手對話了。

4.2 Discord

提示:Discord Bot 可以綁定到特定頻道,避免在不相關的頻道被觸發。在 OpenClaw 設定中指定 channelId 即可。

4.3 WhatsApp

OpenClaw 使用 Baileys 函式庫連接 WhatsApp(非官方 API),需要掃描 QR Code 認證。

設定時會顯示 QR Code,用 WhatsApp 掃描即可。

重要安全注意事項:

4.4 Slack

Slack 的優勢是可以多人共享同一個 AI 助手——適合小團隊使用。

4.5 其他管道一覽

OpenClaw 支援的管道遠不止以上四種,以下是更多選擇:

每個管道的設定方式類似:openclaw channels add ,CLI 會引導你完成認證和設定。

五、LLM 模型設定

支援的模型供應商

OpenClaw 不綁定特定 LLM 供應商,目前支援:

API Key 設定

設定檔中的關鍵欄位:

模型選擇建議

成本控制

AI 助手 24/7 運行,Token 用量可能累積得比你想像中快。幾個控制成本的策略:

六、Skills 技能系統(核心功能)

Skills 是 OpenClaw 最強大的功能之一。它讓你的 AI 助手從「只會聊天」進化為「什麼都能做」。每個 Skill 就像一個可插拔的能力模組——安裝日曆技能就能管理行程,安裝 GitHub 技能就能審查 PR。

6.1 Skills 架構說明

OpenClaw 從三個位置載入技能,優先級從高到低:

每個 Skill 由一個 SKILL.md 檔案定義,格式為 YAML frontmatter 加上 Markdown 內容:

重要欄位說明:

Token 成本須知:每個載入的 Skill 會增加約 97 個字元的系統提示開銷(加上基礎開銷 195 字元)。如果你安裝了 50 個 Skills,每次對話都會多消耗這些 Token。只安裝你真正使用的技能。

6.2 ClawHub 技能市場

ClawHub 是 OpenClaw 社群的技能分享平台,類似 npm 或 VS Code 擴充套件市場。

安全警告:第三方技能本質上是「別人寫的程式碼」,會在你的系統上執行。根據 Snyk 的安全研究報告,曾發現超過 280 個技能存在 API Key 洩漏風險。安裝任何第三方技能前,務必先檢視其原始碼。 使用 clawhub view 查看技能內容。

6.3 社群最推薦的必裝 Skills(精選 Top 15)

以下根據社群回饋和實際使用經驗,精選 15 個最實用的技能:

生產力類

  1. Calendar Integration——日曆管理

整合 Google Calendar 和 Outlook,讓你用自然語言管理行程:「明天下午 3 點和 Alice 開會」、「這週有哪些會議?」

  1. Email Management——郵件管理

收發郵件、自動分類、草擬回覆。配合 Cron 排程可實現「智慧收件匣」——每小時掃描新信並通知你重要郵件。

  1. Task List——任務管理

整合 Todoist、Things、Asana 等工具。「幫我在 Todoist 加一個任務:週五前完成報告」。

  1. Note-Taking——筆記整合

連接 Obsidian 或 Notion,讓 AI 幫你整理和搜尋筆記。

  1. Cron Creator——用自然語言建立排程

不需要記 Cron 語法,直接說「每天早上 7 點提醒我看新聞」就能建立排程任務。

開發者工具類

  1. GitHub Integration——GitHub 整合

審查 PR、管理 Issue、接收 CI/CD 通知。「幫我看一下 PR #42 的改動」、「把這個 Issue 標記為 bug」。

  1. Claude Code Skill——代理式程式開發

讓 OpenClaw 的 Agent 具備 Claude Code 的程式開發能力——在聊天中直接執行程式碼修改和除錯。

  1. DeepWiki——程式碼庫文件查詢

為任何 GitHub 倉庫生成即時文件,幫助你快速理解陌生的程式碼庫。

  1. Terminal Access——Shell 命令執行

讓 AI 直接在你的伺服器上執行 Shell 命令。功能強大但要注意安全——務必搭配沙箱模式使用。

資訊與研究類

  1. Web Search——即時網路搜尋

讓 AI 能搜尋最新資訊,克服知識截止日期的限制。

  1. News Aggregation——RSS 監控和新聞簡報

監控指定的 RSS 來源,配合 Cron 每天早上自動生成個人化新聞摘要。

智能家居與生活類

  1. Home Assistant——智能家居控制

透過聊天控制你的智能家居設備:「把客廳的燈調暗」、「空調設到 25 度」。

  1. Spotify/Media Control——音樂和媒體控制

透過聊天控制音樂播放:「放一些 Lo-Fi 音樂」、「現在在播什麼歌?」

  1. Garmin Connect——健康數據追蹤

讀取 Garmin 手錶的運動和健康數據,生成趨勢報告。

系統工具類

  1. Document Processing——文件處理

處理 PDF、Word、Excel 等檔案。「把這份 PDF 翻譯成中文」、「從這個 Excel 裡提取銷售數據」。

6.4 建立自訂 Skill

如果現有技能不滿足你的需求,建立自訂 Skill 非常簡單:

在目錄中建立 SKILL.md:

Skill 中需要的環境變數,可以在 openclaw.json 中設定:

如果你正在開發 Skill,可以啟用熱重新載入,修改後不需要重啟 Gateway:

七、自動化:讓 AI 替你工作

OpenClaw 最令人興奮的功能是自動化——設定好之後,AI 會在指定時間或特定事件觸發時自動執行任務,完全不需要你介入。

7.1 Cron 排程任務

OpenClaw 內建 Cron 排程系統,你可以用自然語言或 CLI 建立定時任務:

排程設定儲存在 ~/.openclaw/cron/ 目錄中,格式為 JSON。每個排程可以指定 agentId,讓特定的代理人負責執行。

實用排程範例

範例一:每日晨間簡報(早上 6:30)

範例二:每週五下午生成週報

範例三:每日自動備份

7.2 Webhooks 事件觸發

除了定時排程,OpenClaw 也支援 Webhook——讓外部事件觸發 AI 行動。例如:

你也可以搭配 IFTTT 或 Zapier 作為橋梁,將更多服務的事件連接到 OpenClaw 的 Webhook。

7.3 五個最實用的自動化場景

場景一:智慧收件匣

設定 AI 每小時掃描郵件,自動執行:重要信件 → 立即轉發摘要到 Telegram;垃圾郵件 → 歸檔;需要回覆的信件 → 草擬回覆等你確認。省去每天花 30 分鐘整理信箱的時間。

場景二:晨間簡報

每天起床時,Telegram 已經有一則訊息在等你:今天的天氣、日曆行程、待辦事項清單、你關注領域的新聞摘要。一杯咖啡的時間就掌握全天大局。

場景三:GitHub 通知管家

監控你負責的 GitHub 倉庫,有新 PR 時自動摘要改動內容;CI 失敗時分析錯誤原因;有人在 Issue 提到你時即時通知。不再淹沒在 GitHub 通知洪流中。

場景四:文件自動整理

監控指定的下載資料夾,AI 自動辨識檔案類型和內容,分類歸檔到對應目錄,並更新一份索引清單。下載的論文自動歸到「研究」、收據歸到「財務」、截圖歸到「圖片」。

場景五:健康追蹤日報

每天從 Garmin Connect 拉取你的運動數據(步數、心率、睡眠),分析趨勢,每週日生成一份健康週報:「本週平均睡眠時間比上週少了 30 分鐘,建議調整作息。」

八、Memory 記憶系統

OpenClaw 的記憶系統讓你的 AI 助手不再是「金魚腦」——它能記住你的偏好、過去的對話、重要的決定,並在未來的互動中自動運用這些知識。

記憶的運作方式

OpenClaw 使用結構化的 Markdown 檔案儲存記憶,搭配時間戳和語意搜尋能力:

教導 AI 你的偏好

不需要編輯任何設定檔。只要在對話中自然地告訴 AI:

AI 會將這些偏好儲存到記憶中,未來的所有互動都會自動套用。

記憶管理最佳實踐

九、安全強化與最佳實踐

OpenClaw 是一個能在你系統上執行指令的 AI 代理人——這意味著安全性至關重要。以下是從基本到進階的安全強化建議。

9.1 基本安全原則

9.2 沙箱模式

沙箱(Sandbox)是 OpenClaw 最重要的安全機制之一。它將 AI 的執行環境隔離在受限的容器中,防止意外或惡意的系統操作。

在 openclaw.json 中設定沙箱:

沙箱模式選項:

網路存取預設為 none(完全隔離),需要時可以明確啟用特定的網路存取權限。

9.3 權限控制

除了沙箱,你還可以精細控制 AI 的權限:

9.4 安全審計

這會檢查你的設定是否存在已知的安全風險,並給出建議。

Snyk 研究報告的警示:安全研究公司 Snyk 曾分析 OpenClaw 社群的第三方技能生態系,發現超過 280 個技能存在將使用者 API Key 洩漏到外部伺服器的風險。這再次強調:安裝第三方技能前,務必檢視其原始碼。不要盲目信任 ClawHub 上的任何技能,即使它有很高的下載量。

9.5 日常維護與安全

十、多代理人系統(進階)

當你的使用場景變得複雜,單一 AI 代理人可能不夠用。OpenClaw 支援多代理人架構,讓不同的代理人負責不同的任務。

預設代理人 vs 專用代理人

安裝完成後,你有一個「預設代理人」處理所有訊息。但你可以建立專用代理人:

多代理人路由

OpenClaw 可以根據訊息內容自動將任務路由到對應的代理人。你也可以在聊天中手動指定:「用開發代理人幫我看這段程式碼」。

多 Gateway 實例

進階使用者可以運行多個 Gateway 實例。一個典型的場景是 rescue-bot 模式:主要 Gateway 負責日常工作,備用 Gateway 在主要 Gateway 掛掉時自動接管,確保 AI 助手永遠在線。

工作區隔離

每個代理人可以有獨立的 Skills 設定、記憶空間和權限範圍。這樣,開發代理人有 Shell 存取權限,而生活代理人則完全沒有——即使同一個人使用。

十一、維護與更新

更新方式

本地安裝:

Docker 部署:

日誌查看

Gateway 狀態監控

這會顯示 Gateway 的運行狀態、已連接的管道、載入的技能數量等資訊。

備份策略

所有 OpenClaw 的設定、記憶和技能都儲存在 ~/.openclaw/ 目錄中。定期備份這個目錄即可:

建議至少每週備份一次,或者設定一個 OpenClaw Cron 任務讓 AI 自動幫你備份。

十二、常見問題疑難排解

十三、結語

完成後驗證清單

在宣告「完成」之前,逐項確認:

進階方向

當你熟悉了基本使用後,可以探索以下進階主題:

參考資源

OpenClaw 正在快速發展,社群活躍且友善。如果你在建置過程中遇到問題,GitHub Issues 和 Discord 社群都是很好的求助管道。

祝你打造出一個得力的 24/7 AI 助手!