MAGI_0 系統演化日誌（2026-02-27 ～ 2026-03-02）

時區：Asia/Taipei

這一段期間的主題是「把可重複的工作變成一鍵流程」：
- 把 session 匯出做成自動判斷 current session 的工具（並固化成 skill）。
- 把 tools use 稽核從口頭需求，產品化成可重跑的提示詞與報告檔。
- 補上 ACP（Agent Client Protocol）與 Slack（Socket Mode）兩條整合路線的操作/規劃知識。

1) 本期重大變動摘要

(A) /save：Session 匯出流程自動化（scripts/format_session.py）

問題背景：原本 scripts/format_session.py 需要手動餵一個 session .jsonl 路徑，對「臨時想把正在聊的對話存檔」很不順。

本期改動：
- format_session.py 改成可以自動判斷「目前正在更新的 session」：
1. 優先讀 ~/.openclaw/agents/<agent>/sessions/sessions.json，取 updatedAt 最新那筆的 sessionFile。
2. 若找不到才 fallback 掃描 sessions/ 目錄挑最新 *.jsonl（排除 lock/reset）。
- 使用方式調整為：把輸出路徑放第一個參數，session 檔路徑變成可選。
- 例：
bash python3 /home/pofeng/.openclaw/workspace/scripts/format_session.py \ /home/pofeng/.openclaw/workspace/kb/s --agent main
- 產出仍維持兩份檔：
- 完整 transcript（含 tool call / tool result 等）
- talk-only transcript（僅保留 user/assistant 文字）

落地成果：
- 將這條流程寫成既有的 skills/save/SKILL.md，讓「把目前對話存成 md」變成穩定能力，而不是一次性操作。

(B) 工具稽核「可執行化」：提示詞 → 固定檔 → 產出報告

問題背景：使用者想要「最近一週 tools use 狀況與錯誤回顧」，但若只靠臨時描述，容易每次輸出格式不同、也難以追蹤改善。

本期改動/成果：
- 將稽核需求整理成一份可重用的提示詞規格，並存檔：p/audit_tooluse.md。
- 稽核規格重點：
- 嚴重度分級改成交通號誌燈號：🔴🟠🟡🟢
- 修復狀態改成 emoji：✅/🛠️/⏳/❌
- 固定輸出到 kb/report/、固定章節結構（Executive Summary、問題清單、Roadmap、範本等）
- 已用該規格實際跑出報告：kb/report/tooluse_audit_2026-02-28.md
- 報告中也把常見根因（認證、config schema 不相容、依賴缺失、shell 參數字元錯誤等）具體化成可修項。

(C) 模型設定層級釐清：openclaw.json vs cron/jobs.json

本期釐清重點：
- ~/.openclaw/openclaw.json：全域預設（primary/fallbacks）與各 agent 預設 model。
- ~/.openclaw/cron/jobs.json：每個 cron job 的 payload.model 若存在，會覆寫 agent/global 預設。

這讓後續要做「統一模型策略」有清楚的改動點：
- 若追求可重現：cron 內鎖 payload.model。
- 若追求維護簡單：cron 移除 payload.model，全都跟著 defaults 走。

註：openclaw.json 內含金鑰/Token 等機密，本期紀錄僅描述行為與層級，不在文章中揭露任何機密值。

2) 新增/強化的能力（Skills / SOP）

Skill：Save current session transcript

將「匯出目前 session」固化進 skills/save/SKILL.md。
實務效果：需要回顧、交接、留存證據時，可快速把對話保存進 kb/s/。

SOP：Slack 整合（規劃稿）

本期完成「只規劃不執行」的 Slack 整合藍圖：
- 目標：互動型（可收可回）、Socket Mode、僅回覆指定 channel 的 @mention。
- 核心設計：
- Bot token（xoxb）+ App token（xapp）
- allowlist（用 channel ID）
- thread reply 優先
- event 去重（event_id 或 channel+ts）

SOP：ACP（Agent Client Protocol）使用與定位

說明 ACP 作為「客戶端 ↔ Gateway」的傳輸橋接：ACP 本身不負責選 model。
若要「指揮 Claude」：關鍵在 Gateway 端（openclaw）把預設模型/agent 模型切到 Claude（透過相對應 provider 的授權與 models set）。

3) 觀察到的問題與修復/待辦

(A) Google OAuth（gog）token 過期造成郵件檢查中斷（⏳）

現象：invalid_grant，導致 heartbeat 無法檢查郵件。
需要人工動作：重新授權（例如執行 gog auth）。

(B) Shell 參數字元陷阱：非 ASCII 破折號（✅ 已記憶）

現象：ls: invalid option -- '�'
根因：命令列參數中的「破折號」不是 ASCII -，而是 –/－ 等字元。
已落地：寫入日誌與長期記憶，作為日後 debug checklist 的固定項。

4) 小結：這期的「系統演化方向」

把高頻動作（存檔、稽核）從「一次性指令」升級成「可重複、可驗收、可追蹤」的流程。
對整合（Slack / ACP）先做正確分層與最小權限設計，避免過早落地造成設定 schema/權限/安全面返工。
下一步若要繼續推進：
1) 把 Google OAuth 重新授權納入 heartbeat 的「失敗處置 SOP」。
2) 將 tools-audit 報告的 P0/P1 行動清單逐條修復並建立回歸測試。

pofeng