Claw Watchdog

README

# claw-watchdog

OpenClaw plugin — 獨立驗證 agent 是否真的執行了它聲稱完成的任務。

**核心哲學：不信任 agent 的自我報告。**

## 背景

當 OpenClaw agent 聲稱完成了任務，你怎麼知道它真的執行了？

claw-watchdog 透過 OpenClaw 的 additive plugin hooks（`agent_end` + `after_tool_call` + `message_received`）實時監控每一輪對話，用確定性規則引擎驗證 agent 的聲明與實際行為是否一致。

詳細設計見：[執行驗證監工系統設計提案](https://github.com/thepagent/claw-info/blob/main/docs/execution-watchdog.md)（claw-info）

## 判定邏輯

```
L0（零成本）：完成聲明詞 + 零 tool call → 直接告警
L1b（極低成本）：agent 聲稱「已發送」但無 message tool call → 告警
L2（Phase 2）：Gemini Flash 語義層判斷（異步）
```

## 安裝

```bash
# 複製到 OpenClaw extensions 目錄
cp -r execution-watchdog ~/.openclaw/extensions/

# 在 openclaw.json 中加入 load path
# plugins.load.paths: ["/root/.openclaw/extensions/execution-watchdog"]

# 重啟 gateway
openclaw gateway restart
```

## 告警日誌

```
~/.openclaw/watchdog/alerts.log   # 即時告警
~/.openclaw/watchdog/audit.log    # 每輪審計記錄（JSONL）
```

## 實測記錄

2026-03-20，icern VPS，OpenClaw ≥ 2026.3.7：
- L0 成功攔截偷懶場景（有完成聲明詞 + 零 tool call）✅
- L1b 誤報 bug 發現並修復（agent_end.messages 包含整個 session 歷史，需只取最後一條）✅

## 相關

- [openclaw/openclaw#40082](https://github.com/openclaw/openclaw/issues/40082) — 問題原始 issue
- [claw-info 設計文件](https://github.com/thepagent/claw-info/blob/main/docs/execution-watchdog.md)