EP-62 在 Mac Mini 安裝龍蝦，再結合本地端 AI 知識庫，威力太強了

上一期（EP-61）我分享了我如何打造本地端的 AI 知識庫。簡單來說，就是把 Notion 上的文章自動備份到電腦本地端，讓 AI 代理可以直接讀取、修改這些文章，處理完之後再推送回 Notion。這樣既保留了 Notion 隨時隨地查看的便利，又能讓 AI 幫我做那些以前只能手動處理的事。這一期，我要分享的是下一步：把「龍蝦」，也就是 OpenClaw，接上這套知識庫，讓整件事的威力再往上拉一個層級。OpenClaw 是一個開源的個人 AI 代理平台，核心定位是「真的會做事的 AI」。主要特點：* 透過 WhatsApp、Telegram、Discord 等你已在用的 chat app 操作 AI* 支援收信、發信、行事曆管理、自動化工作流等實際任務* 可串接多種 LLM（OpenAI、Anthropic、本地模型等），支援 API proxy 路由降低成本* 具備持久記憶、persona 設定、技能（Skills）擴充機制* 提供 Desktop App、Web Dashboard、Docker 部署等多種形式如何安裝 OpenClaw 在 Mac mini1. OpenClaw 安裝過程整個安裝流程大約只需要 5 到 10 分鐘，OpenClaw 本身設計得很友善，有引導程式帶你一步一步完成設定。前置條件：你需要先確認已安裝 Node.js 22 或更新版本。可以在終端執行 node --version 檢查。如果版本過舊，建議用 nvm（Node Version Manager）來升級。第一步：安裝 OpenClaw打開 Mac 的終端機（Terminal），輸入：npm install -g openclaw@latest這個命令會下載最新版本的 OpenClaw 並安裝到系統路徑中。安裝完成後，就可以在任何地方使用 openclaw 命令。第二步：執行引導程式openclaw onboard --install-daemon這個引導程式會一步一步問你問題，包括：* API 金鑰配置：選擇你想使用的 AI 供應商，輸入對應的 API 金鑰* 套件管理器選擇：選擇 npm、yarn 或 pnpm（對大多數人來說，直接選預設的 npm 即可）* 技能安裝選項：選擇要預先安裝的技能（Skills）* 守護程序設定：--install-daemon 這個參數會把 OpenClaw 設定成開機就自動在背景跑，即使關閉終端也不會中斷。在 macOS 上，這會建立 launchd 配置第三步：設定與連接通訊頻道安裝過程中的引導程式會讓你選擇一個通訊平台來跟你的 AI 助手對話。我選擇使用 Telegram。 理由是：* 官方 Bot API：Telegram 提供官方的 Bot API，不需要透過第三方服務或複雜的認證流程。整個設定過程在 Telegram 應用程式內完成，只需要跟 @BotFather 對話，就能建立機器人並取得 Bot Token* 穩定可靠：Telegram Bot API 相當成熟穩定* 跨平台：手機、桌面、網頁都能用，隨時隨地都能與 AI 助手對話* 豐富功能：支援內聯鍵盤、媒體檔案處理、語音訊息轉文字等設定 Telegram 頻道的步驟：(1) 取得 Bot Token你必須先在 Telegram 應用程式中，與官方的機器人 @BotFather 對話。* 發送 /newbot 指令給 @BotFather。* 按照指示為你的機器人命名，完成後，@BotFather 會提供一組 Bot Token（格式通常像這樣：123456789:AA...），把它複製下來。(2) 在 OpenClaw 中設定 Token取得 Token 後，你有兩種方式可以將其設定到 OpenClaw 中：* 方法 A：使用設定精靈（推薦）執行 openclaw onboard，然後在流程中選擇 Telegram 並貼上你的 Token。* 方法 B：使用 CLI 指令新增你也可以直接使用 openclaw channels add 指令： openclaw channels add --channel telegram --token 你的BotToken這會將設定寫入你的 openclaw.json 檔案中。據說 Discord 也挺好用的，它的 Bot 設定同樣很方便。雖然我目前還沒有用，但如果你是 Discord 的重度使用者，也可以試試看。OpenClaw 支援同時連接多個頻道，所以你也可以兩個都設定。(3) 啟動 Gateway 並核准配對設定完成後，重新啟動 Gateway：openclaw gateway restartTelegram 的預設直接訊息 (DM) 政策也是 pairing（配對模式）：* 你（或其他使用者）第一次傳送訊息給這個 Telegram 機器人時，機器人不會馬上回覆，而是會回傳一組配對碼 (Pairing Code)。* 在終端機執行openclaw pairing approve telegram * 配對碼會在 1 小時後過期。核准之後，你就可以在 Telegram 上正常與你的 OpenClaw 代理進行對話了。2. 為什麼我選擇 CLI 而不是 macOS App 介面？OpenClaw 在 macOS 上有兩種使用方式：CLI（命令列） 和 OpenClaw App（圖形介面）。我最初是把 OpenClaw 安裝在 VPS 上的，所以一開始就很習慣使用 CLI 介面。後來在安裝 Mac mini 的時候，第一時間我也是選擇 CLI。之後才發現有一個 macOS App 的 UI 介面，於是我也嘗試安裝了。但安裝之後發現，App 版本會跟原本的 CLI 環境產生衝突。而我又不太可能把原本的環境砍掉重裝。因為重裝需要重新設定所有的 API 金鑰、頻道配對、技能安裝等等，會花費很多力氣。所以最後就放棄 App，直接繼續使用 CLI 介面。反正之後我就是使用 Telegram 來命令它，操作起來也沒什麼差別。如果偶爾需要查看 UI 介面的話，在終端輸入 openclaw dashboard 就可以打開網頁版的控制介面了。建議：安裝之前，你要先決定走哪條路。CLI 適合想要自動化、用指令控制一切的人；App 適合不熟悉命令列、想直接點 UI 操作的人。但兩種方式不要混著用，很容易出問題。3. 大型語言模型的選擇OpenClaw 支援多種 AI 模型供應商，包括 Anthropic Claude、OpenAI GPT、Google Gemini、Mistral、MiniMax、MoonShot，也支援透過 Ollama 運行本地模型。選擇原則：預設模型一定要選擇最聰明的等級。所謂「最聰明的等級」，我的定義是指最起碼要在 Google Gemini 3 Flash 等級以上，或者是 Kimi K2.5 這種中國的頂級開源模型。不要用太便宜或太小的模型（例如 Haiku 或 GPT 5 Mini），因為這些模型在複雜推理和工具使用上的表現會差很多。我個人使用的模型：* OpenAI Codex：我有訂閱 OpenAI，直接授權非常方便。在引導程式中選擇 OpenAI 作為供應商，輸入 API 金鑰就行了。* Kimi Code（Kimi K2.5）：這是我的另一個選擇，我也有訂閱（目前每月花費約 20 美金）。Kimi K2.5 是中國的開源模型，在程式設計和推理能力上表現不錯，性價比很高。OpenClaw 也支援備用模型機制（Fallback）。你可以在 ~/.openclaw/openclaw.json 中設定，當主要模型不可用時，自動切換到備用模型。我就是把 Kimi K2.5 設為備援模型。3. Skills與Tools（技能與工具）Skills（技能）是 OpenClaw 最強大的功能之一。如果說 Tools（工具）是 AI 的手腳，那 Skills 就是 AI 的專業知識和經驗。技能的本質是一份「使用說明書」，告訴 AI 如何完成特定任務。它不是可執行的程式碼，而是用 Markdown 格式寫成的結構化指示和知識。每個技能是一個包含 SKILL.md 檔案的目錄，裡面定義了任務描述、執行步驟、最佳實踐、常見錯誤處理等。目前我主要還是使用官方內建的技能。官方內建工具（不需要另外安裝）：* 檔案系統工具 (group:fs)：讀取檔案 (read)、寫入檔案 (write)、編輯檔案 (edit)、套用補丁 (apply_patch)。* 執行與終端機工具 (group:runtime)：執行 Shell 指令 (exec)、Bash 捷徑 (bash)、管理背景處理程序 (process)。* 網頁與 UI 工具 (group:web 與 group:ui)：網路搜尋 (web_search)、網頁內容抓取 (web_fetch)、獨立瀏覽器自動化控制 (browser)、Canvas 介面控制 (canvas)。* 記憶工具 (group:memory)：語意記憶搜尋 (memory_search)、讀取特定記憶檔案 (memory_get)。* 會話與代理管理 (group:sessions)：列出會話 (sessions_list)、獲取會話歷史 (sessions_history)、發送訊息至其他會話 (sessions_send)、生成子代理 (sessions_spawn)、查詢會話狀態 (session_status)、列出可用代理 (agents_list)。* 自動化與系統 (group:automation)：排程與喚醒任務 (cron)、閘道器設定與更新管理 (gateway)。* 訊息與設備節點 (group:messaging 與 group:nodes)：跨頻道傳送訊息與相關互動 (message)、控制已配對的設備節點 (nodes)。* 媒體與防護工具：圖片視覺分析 (image)、工具呼叫迴圈偵測 (loop-detection)。我安裝的官方內建技能：* apple-notes：管理 Apple Notes（新增/搜尋/編輯/匯出）* apple-reminders：管理 Apple Reminders（新增/完成/刪除）* blogwatcher：監控 RSS/Atom 部落格更新* clawhub：搜尋/安裝/更新/發布技能* coding-agent：委派大型程式任務給子代理* gh-issues：GitHub Issues 自動修復與 PR 流程* gifgrep：搜尋/下載 GIF 與抽幀* github：GitHub CLI（PR/Issue/CI/API）* gog：Google Workspace（Gmail/Calendar/Drive…）* goplaces：Google Places 搜尋與地點詳情* healthcheck：OpenClaw 主機安全與更新健檢* mcporter：MCP server/tool 設定與呼叫* nano-pdf：自然語言編輯 PDF* notion：Notion API（頁面/資料庫/區塊）* obsidian：Obsidian Vault 筆記操作* openai-image-gen：批次生成圖片* openai-whisper：本地 Whisper 語音轉文字* openai-whisper-api：Whisper API 轉錄* oracle：oracle CLI 使用最佳實踐你可以透過 openclaw skills list 指令查看你自己安裝的技能，或者在設定檔的 skills.entries 中針對個別技能進行啟用或設定（例如設定 API Key）。社群技能（ClawHub）：OpenClaw 有一個公開的技能註冊中心叫做 ClawHub，截至 2026 年 2 月已有超過 5,700 個社群貢獻的技能。你可以用以下指令來搜尋和安裝：# 搜尋技能 openclaw skills search "python" # 安裝技能 openclaw skills install python-debugging # 查看已安裝的技能 openclaw skills list 4. OpenClaw 內部重要文件OpenClaw 的核心精髓藏在幾份關鍵的 Markdown 和 JSON 檔案中。理解這些文件，你才能真正讓 AI 變成你的「分身」。以下是每個檔案的說明：(a) BOOTSTRAP.md用途：系統初始化引導文件。這是 OpenClaw 啟動時最先讀取的文件，定義了 AI 代理的初始化流程。它告訴 AI 在每次開機或重啟時，應該先做哪些事情。例如：檢查環境是否正常、載入必要的設定、確認各項服務的連線狀態等。你可以把它理解成 AI 的「開機 SOP」。(b) SOUL.md用途：AI 的靈魂／核心性格設定。這份文件定義了 AI 助手的行為準則和性格特徵。你在這裡設定 AI 的語氣（例如正式或口語化）、回應的偏好（例如偏向簡潔還是詳盡）、擅長的領域、以及一些不可違反的規則。簡單來說，SOUL.md 就是 AI 的「系統提示詞（System Prompt）」。修改這份文件，等於在塑造 AI 的全部人格。(c) AGENTS.md用途：代理的能力清單與工作說明。這份文件描述了 AI 代理能做什麼、不能做什麼，以及在不同情境下應該如何行動。例如，它可以列出每個代理的專業領域、可以使用的工具清單、工作流程的優先順序等。如果你設定了多個代理（例如專門處理程式碼的代理和專門處理文件撰寫的代理），這份文件會定義它們各自的職責。(d) USER.md用途：使用者個人檔案。這份文件存放的是你的個人資訊——你的工作內容、偏好設定、常用的工具和流程等。AI 透過這份文件來「認識你」，讓它在回答問題或執行任務時能更貼近你的需求。例如，你可以在這裡寫「我是一個內容創作者，主要使用 Notion 管理文章，習慣用繁體中文」，AI 就會以此為基礎來回應你。(e) openclaw.json用途：系統核心配置檔案。這是 OpenClaw 最重要的設定檔，位於 ~/.openclaw/openclaw.json，使用 JSON5 格式。所有的系統配置都集中在這裡，包括：* 頻道配置（channels）：Telegram Bot Token、Discord Token、WhatsApp 設定等* 代理設定（agents）：使用哪個 AI 模型、模型參數（temperature、maxTokens）、回退模型（fallback）* 技能配置（skills）：啟用哪些技能、技能的優先順序* 工具配置（tools）：允許或禁止哪些工具* 排程設定：heartbeat 的啟動時間與頻率、Cron job 的排程規則你可以手動編輯這個檔案，應該也是可以透過 OpenClaw 的控制介面（http://127.0.0.1:18789/）用圖形化界面來修改，但是我都是用終端機介面修改就是了。OpenClaw 的使用方式安裝完 OpenClaw 之後，接下來要讓它真正變成你的好幫手。以下的所有設定，我大部分都是優先推薦讓 AI 來幫你處理，而不是由你自己手動去安裝或修改。1. 先把重要的 Markdown 文件設定完畢在開始使用之前，我建議先把上面提到的那幾份 Markdown 文件全部設定好：BOOTSTRAP.md、SOUL.md、AGENTS.md、USER.md。這些文件決定了 AI 的性格、能力和對你的認識，設定好才能讓 AI 更精準地幫你做事。設定方式有兩種：* 手動修改：直接用編輯器打開這些文件，按照自己的需求填寫內容。適合對內容有明確想法的人。* 透過對話讓 AI 幫你完成：在 Telegram 上跟 OpenClaw 對話，告訴它你的工作內容、偏好，然後請它幫你修改這些文件。例如你可以說：「我是一個內容創作者，主要使用 Notion 管理文章，習慣用繁體中文。請幫我更新 USER.md，把這些資訊加進去。」AI 會直接幫你改好，你完全不需要自己去碰設定檔。2. 設定 Heartbeat（心跳）機制OpenClaw 有一個 Heartbeat（心跳） 機制，預設是每 30 分鐘啟動一次，全天 24 小時無休。Heartbeat 的作用是讓 AI 定期「醒來」，執行你預先設定好的檢查或任務。這些指令的內容會寫在 HEARTBEAT.md 檔案中。預設值可能太頻繁了，這會非常耗你的 Token，也就是很花你的錢。你可以根據需求調整。有兩種方式：* 跟 OpenClaw 對話，請它幫你改：直接在 Telegram 上說「請幫我把 heartbeat 調整成每天早上 6 點到下午 6 點之間，每三個小時執行一次」，AI 會幫你修改 openclaw.json 裡面的設定。* 查閱官方文件自行調整：手動編輯 ~/.openclaw/openclaw.json 中的排程設定。以我個人為例：(a) 我設定在每天早上 6 點到下午 6 點這段時間才會啟動 heartbeat。晚上不需要 AI 定期醒來打擾我。(b) 啟動頻率為每三個小時一次——分別是早上 6 點、9 點、中午 12 點、下午 3 點、下午 6 點。我的 heartbeat 主要目的就是檢查排程有沒有正常執行，以及整個系統有沒有出錯。例如備份有沒有成功、Cron job 有沒有正常跑完等等。3. Cron Job：讓 AI 幫你設定排程任務我主要的自動化工作是透過 Cron job 來完成的。Cron job 是一種排程機制，讓你可以設定「在特定時間自動執行特定的任務」。例如：每天凌晨 2 點自動備份資料、每天早上 8 點自動整理昨天的筆記、每週日自動產生週報等。在 OpenClaw 裡面，你可以直接跟 AI 說你需要什麼排程，讓它幫你設定。例如：「我想要每天凌晨 2 點，自動從 Notion 備份文章到~/Documents/raven.tw/backups/ 資料夾」OpenClaw 會幫你在 openclaw.json 中寫入對應的 cron 排程規則，或者幫你設定 macOS 的 crontab。整個過程你完全不需要看程式碼。4. 如何安裝 Notion 以及對接 Notion Database要讓 OpenClaw 存取你的 Notion 資料，流程如下：第一步：自行到 Notion 建立整合（Integration）前往 Notion Integrations 頁面建立一個新的 Integration。建立後你會拿到一組 Notion Access Token（格式類似 ntn_xxxxxx）。重要安全建議：建議你的 Notion Access Token 只連接到你指定的 Database 就好，不要開放整個 Workspace 的權限。這是最小權限原則——給 AI 剛好夠用的權限就好，避免不小心誤改到其他重要資料。在 Notion 中，進到你要連接的 Database 頁面，點右上角的「...」→「Connections」→ 選擇你剛建立的 Integration，這樣才能讓這個 Token 存取該 Database。第二步：把 Token 交給龍蝦拿到 Access Token 之後，直接在 Telegram 上跟 OpenClaw 說：「這是我的 Notion Access Token：ntn_xxxxxx，請幫我設定好 Notion 的連接，我主要要存取的 Database ID 是 xxxxxxxx」OpenClaw 會幫你把 Token 存入環境變數或設定檔，並設定好 Notion API 的串接。之後你就可以直接對它下指令操作 Notion 了，例如：「幫我查詢 Notion 中所有 Status 是 In progress 的文章」。5. 如何使用 Google 的服務如果你想讓 OpenClaw 存取 Google 的服務（例如 Gmail、Google Calendar、Google Drive），你需要先了解一個關鍵概念：Google OAuth（開放授權）。Google OAuth 是一種授權機制，讓第三方應用程式（在這裡就是 OpenClaw）可以代替你去存取你的 Google 帳戶資料，但不需要知道你的密碼。你會經過一個「授權同意」的畫面，勾選你願意開放的權限（例如只允許讀取 Gmail，不允許刪除郵件），然後系統會產生一組 Token 給 OpenClaw 使用。如何安裝？整個過程我建議讓 AI 來幫你處理，但前置作業你需要自己做：* 建立 Google Cloud 專案：前往 Google Cloud Console 建立一個新專案* 啟用所需的 API：根據你要使用的服務，啟用對應的 API（Gmail API、Calendar API、Drive API 等）* 建立 OAuth 憑證：在「API 和服務」→「憑證」中建立 OAuth 2.0 客戶端 ID，下載 JSON 格式的憑證檔案* 把憑證交給龍蝦：將下載的憑證檔案給 OpenClaw，讓它幫你完成後續的授權流程設定完成後，你就可以透過 Telegram 下達像這樣的指令：「幫我查一下今天的 Google Calendar 有什麼行程」「幫我讀取 Gmail 最新的 5 封未讀郵件」「把這份檔案上傳到 Google Drive」6. 操作瀏覽器：Browser RelayOpenClaw 支援透過 Browser Relay 工具來操控瀏覽器。這讓 AI 可以幫你瀏覽網頁、擷取資訊、甚至自動填表單。Browser Relay 的概念是：OpenClaw 會啟動一個瀏覽器實例，然後 AI 可以透過指令來控制這個瀏覽器——開啟網頁、點擊按鈕、擷取頁面內容等。安裝方式一樣建議讓 AI 幫你處理。在 Telegram 上跟 OpenClaw 說：「請幫我安裝並設定 Browser Relay」它會幫你處理相關的安裝與設定。在操作的過程中，它可能會要求你協助點擊網頁，你只要照著做就可以了。安裝完成後，你就可以下達像這樣的指令：「幫我打開 GitHub，搜尋最近一週最熱門的開源專案，整理前 10 名的列表給我」7. 安裝 NotebookLM 工具NotebookLM 是 Google 推出的 AI 筆記本工具，而社群有開發一套 Python 版本的 NotebookLM 工具：notebooklm-py，可以讓你透過程式碼來操作 NotebookLM。安裝方式同樣建議讓 AI 幫你處理。直接在 Telegram 上跟 OpenClaw 說：「請幫我安裝 notebooklm-py，GitHub 網址是 https://github.com/teng-lin/notebooklm-py」OpenClaw 會幫你 clone 專案、安裝相依套件、設定好環境。之後你就可以透過 AI 來操作 NotebookLM，進行文件分析、筆記整理等工作。使用龍蝦搭配本地端 AI 知識庫這裡是我的實作過程，也是這一整套系統最精華的部分——把 OpenClaw 和本地端 AI 知識庫串起來之後，可以做到什麼事。1. 定期備份 Notion 資料我每天定期使用 Cron job 將 Notion 的資料備份到本地端。關鍵是我採用增量備份的方式——不會每次都備份全部的資料，而是只備份自上次備份後有變更的部分。這樣做的好處是：* 備份速度快* 不會佔用太多磁碟空間* 避免檔案大小一下子暴增太快每天凌晨，Cron job 會自動從 Notion API 拉取最新的文章，存到~/Documents/raven.tw/content/ 資料夾中。2. 提升 AI 檢索效率把資料備份到本地端的目的，是為了讓 AI 在找尋過往文件時更方便、更快速。比起每次都要透過 Notion API 去查詢（有速率限制、有延遲），直接讀取本地端的 Markdown 檔案快多了。AI 可以用 grep_content 或 search_files 等內建工具，在幾秒內搜遍整個知識庫。例如我可以在 Telegram 上說：「幫我找出 content 資料夾裡，所有 Status 還是 In progress 的文章，把標題列出來給我看。」AI 會直接去搜尋本地端的檔案，幾秒鐘內就給你結果。3. 跨平台編輯與同步我請 AI 幫我寫了一個 VS Code Extension 外掛，讓我可以在 IDE 上編輯完文件後，直接將文件上傳到 Notion。透過這種方式，我可以實現這樣的工作流：* 在 Notion 上隨時隨地用手機記錄想法* 知識庫腳本自動把文章同步到本地端* 在 Antigravity（或任何 IDE）上深度編輯文章* 編輯完用 VS Code Extension 推送回 Notion* 在 Telegram 上對 OpenClaw 下指令，做最後的整理和發布不管在哪個裝置、用什麼工具，都能無縫銜接。4. 自動化電子報發佈目前我的龍蝦也會每天定期整理資料，並上網搜尋熱門的開源專案。AI 會做這些事：* 透過 Browser Relay 瀏覽 GitHub Trending、Hacker News 等網站* 篩選出有趣的開源專案* 撰寫簡短的介紹說明* 以「蝦報」的名義，寫成每日電子報* 自動發佈到網路上整個流程從搜尋、撰寫到發布，全部由 AI 自動完成。我只需要偶爾檢查一下品質，確認沒有離譜的內容就好。結語當 Notion、本地端 AI 知識庫、還有 OpenClaw 這三個東西串起來之後，我現在的日常流程大概長這樣：* 在任何裝置上隨時可以檢視 Notion 上的知識庫，有什麼新想法可以直接改，每天更新到本地端* 在本地端撰寫文章，腳本自動把文章同步到 Notion* 打開 Telegram，直接跟 AI 下指令——整理筆記、修改文章、推送發文，全部搞定* AI 自動執行排程任務——備份資料、發布電子報、檢查系統狀態最棒的地方是：整個過程幾乎不需要打開電腦，用手機就能完成。工商時間如果你也對於打造個人化 AI 生產力系統有興趣，我創立了付費社群「社畜進化論」，專為想用 AI 提升工作效率的上班族設計。💎 會員專屬權益* 基礎課程：* AI 知識管理：使用各種工具建立 AI 知識庫，包含 ChatGPT、Gemini、Perplexity、NotebookLM、Notion，以及 Antigravity AI 程式編輯器。* AI Coding：教你使用 ChatGPT 開發 Google Apps Script，並且結合 Google 自家產品如試算表、簡報、表單、雲端硬碟等。* AI 自動化：使用 n8n 建立可視化的自動化工作流。* 深度內容：每月持續更新至少 2 篇研究筆記、實戰腳本或講解影片* 交流討論：遇到問題可以在社群提問，一起找解方* 優惠方案：進階課程享會員專屬折扣💰 訂閱方案* 月費制：$5 USD / 月* 年費制：$50 USD / 年（省 $10） This is a public episode. If you would like to discuss this with other subscribers or get access to bonus episodes, visit newsletters.raven.tw