教程 15

教程 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 個搜尋引擎

关注我们,获取最新 AI 动态

在 X 上关注 @lanmiaoai,第一时间获取教程更新、AI 工具推荐。

立即关注