教程 15 — OpenClaw Proactive Agent 教程:從「等指令」到「主動提醒」的 AI 升級(2026)
目標:安裝 Proactive Agent Skill,讓 OpenClaw 從被動回答變成能主動預判需求、自動執行定時任務的主動型 AI。
被動 AI vs 主動 AI:有什麼區別?
大多數 AI 助手都是被動的——你不問,它不說。而 openclaw ai 主動提醒 不用每次問 正是 Proactive Agent 解決的核心問題。
| 對比維度 | 普通 OpenClaw | Proactive Agent |
|---|---|---|
| 觸發方式 | 使用者發指令才響應 | 按時間或事件自動觸發 |
| 狀態保持 | 對話結束即停止 | 後台持續運行 |
| 主動推送 | 不支援 | 自動發送到 Telegram |
| 場景適配 | 單次任務 | 持續智慧監控 |
| 典型用法 | 「幫我查天氣」 | 每天早 8 點主動推送天氣 |
這是 ClawHub 下載量第四的 Skill(126k 下載),核心價值:讓 AI 從工具變成「會主動聯絡你的助手」。
什麼是 WAL Protocol?
WAL(Working Action List)協議 是 Proactive Agent 的核心機制,也是實現 proactive agent wal protocol 教程 中最常被問到的概念。
WAL 是一份持久化的「待處理行動列表」,結構如下:
## WAL — 當前行動佇列
- [ ] 每天 08:00 推送科技早報到 Telegram
- [ ] 監控 GitHub repo star 數,超過 1000 時推送通知
- [ ] 每週五 17:00 生成本週工作總結Skill 會在後台定期檢查這份列表,到達觸發條件時自動執行對應任務,執行完畢後把條目標記為 [x] 並記錄時間。WAL 檔案儲存在本地,重啟後仍然有效。
第一步:安裝 Proactive Agent Skill
在 WebChat 或 Telegram 中發送:
/install @halthelobster/proactive-agent
驗證安裝:
pnpm openclaw skills list
# 列表中應出現 proactive-agent安裝後,Skill 會在工作區建立以下檔案:
~/.openclaw/workspace/skills/proactive-agent/
├── SKILL.md ← Skill 主邏輯
├── wal.md ← Working Action List(核心配置檔案)
└── buffer.md ← Working Buffer(臨時緩衝區)
第二步:配置時間觸發任務
打開 wal.md 或直接告訴 AI 新增時間觸發任務:
在 WAL 裡新增一個任務:每天早上 8 點,搜尋今日科技新聞,整理成 3 條要點推送給我
AI 會自動寫入 wal.md:
## WAL
- [ ] cron: 0 8 * * *
task: 搜尋今日科技新聞,整理 3 條要點,推送到 Telegram
last_run: —支援標準 cron 表達式,例如:
每天 08:00 → 0 8 * * *
每小時 → 0 * * * *
每週一 09:00 → 0 9 * * 1
每月 1 日 → 0 9 1 * *
第三步:配置事件觸發任務
openclaw 自動執行定時任務 無需觸發 不僅限於時間觸發,還支援事件觸發。
新增事件觸發任務:當我發送包含「緊急」關鍵詞的訊息時,自動把該訊息轉發到 #urgent Telegram 頻道並標記高優先級
事件觸發類型示例:
## WAL — 事件觸發
- [ ] event: keyword="緊急"
task: 轉發訊息到 #urgent 頻道,新增 🔴 標記
- [ ] event: file_created="~/Downloads/*.pdf"
task: 自動總結新 PDF 並推送摘要到 Telegram
- [ ] event: time_idle=30min
task: 推送今日待辦提醒第四步:設定主動推送到 Telegram
自託管 ai 主動推送訊息 telegram 需要先確認已完成 Lesson 02 的 Telegram 接入。然後在任務中指定推送目標:
配置 Proactive Agent 推送:每天 09:00 檢查我的 GitHub issues,如果有未回覆超過 24 小時的,推送提醒到 Telegram 個人對話
你也可以指定推送到特定群組或頻道:
- [ ] cron: 0 9 * * 1-5
task: 彙總昨日未讀郵件標題,推送到 Telegram 群組 @myteam
target: telegram://group/@myteam測試推送是否正常:
現在觸發一次 Proactive Agent 推送,發一條「推送測試」到 Telegram
第五步:使用 Working Buffer(工作緩衝區)
Working Buffer(buffer.md)是 Proactive Agent 的臨時工作區,用於:
- 跨任務傳遞資料(任務 A 的輸出作為任務 B 的輸入)
- 儲存中間結果避免重複計算
- 記錄任務執行日誌
## Buffer — 2026-03-30
### 科技早報資料
- 來源:HackerNews Top 10
- 抓取時間:08:00:12
- 條目數:10
### 待推送內容
1. OpenAI 發布 o4 模型,推理能力提升 60%
2. Rust 2026 版本發布,編譯速度提升 30%
3. Next.js 16 正式版上線,Server Actions 全面穩定你可以告訴 AI 如何使用 Buffer:
把每次早報抓取的原始資料存入 Buffer,保留最近 7 天,便於我回顧歷史
Proactive Agent 和 Lesson 06 定時任務的區別
Lesson 06 的定時任務是通過系統 cron 觸發單次腳本執行,適合簡單的重複任務(如發早報)。
Proactive Agent 是持續運行的智能體,核心區別:
| 維度 | Lesson 06 定時任務 | Proactive Agent |
|---|---|---|
| 執行方式 | cron 觸發腳本 | AI 持續監聽 + 執行 |
| 任務複雜度 | 固定流程 | 可根據上下文動態調整 |
| 跨任務記憶 | 無 | Buffer 持久化 |
| 事件觸發 | 僅時間觸發 | 時間 + 事件 + 關鍵詞 |
| 典型場景 | 發固定格式早報 | 監控+判斷+分支執行 |
簡單說:Lesson 06 是「鬧鐘」,Proactive Agent 是「會思考的秘書」。
常見問題
Proactive Agent 和普通 OpenClaw 有什麼區別?
普通 OpenClaw 需要使用者發送指令才會響應,對話結束後不保留任何狀態。Proactive Agent 安裝後會在後台持續運行,通過 WAL Protocol 維護一份行動佇列,按照時間或事件自動觸發任務,無需使用者手動發起。最直觀的體現是:你可以讓它每天早上主動給你發訊息,而不是你每天去問它。
WAL Protocol 是什麼,怎麼配置?
WAL(Working Action List)是一份儲存在本地的 Markdown 格式待辦列表,每個條目包含觸發條件(cron 表達式或事件關鍵詞)和執行任務的描述。你可以直接用自然語言告訴 AI「新增一個每天 8 點執行的任務」,AI 會自動寫入 ~/.openclaw/workspace/skills/proactive-agent/wal.md,無需手動編輯配置檔案。
Proactive Agent 會一直消耗 API token 嗎?
不會持續消耗。Proactive Agent 採用「輪詢檢查」機制,預設每 5 分鐘檢查一次 WAL 列表,只有到達觸發條件時才調用 AI 模型執行任務。平時處於輕量級檢查狀態,幾乎不消耗 token。你可以通過修改檢查間隔來進一步控制消耗,比如把輪詢改為每 15 分鐘一次。
主動推送的訊息能發到 Telegram 以外的地方嗎?
可以。Proactive Agent 支援多個推送目標:Telegram(個人/群組/頻道)、郵件(需要配合 Gmail Skill)、Slack(需要 Slack Skill)、本地檔案寫入。只要在 WAL 任務中指定 target 欄位,就能推送到任意已整合的渠道。Telegram 是預設推薦選項,因為配置最簡單且延遲最低。
下一步
- 教程 16 — 安裝 Multi Search Engine,讓 OpenClaw 同時調用百度等 17 個搜尋引擎