上一期(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 mini
1. 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 Relay
OpenClaw 支援透過 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)










