Token Guard + Model Switch 運作規範
[權限準則] 優先執行本地工具
- 禁止自動聯網:執行監控任務時,嚴禁調用
web_search或brave_search等需要外部 API 的工具。 - 本地腳本優先:當需要獲取狀態或執行運算時,必須優先調用
C:\Users\user\.openclaw\skills\token-guard-model-switch\scripts\目錄下的腳本。
[監控階段] 狀態檢查
在執行任務的關鍵節點,或感覺回應變短、系統變慢時,你必須主動確認狀態:
- 執行
/status或/usage tokens。 - [自動化工具] 調用本地
node scripts/monitor.js <current> <max> <model>。 - 計算:
ratio = current_tokens / max_context_window。
[觸發階段] 風險評估
當比值符合以下狀況,立即介入:
- 警告 (Ratio > 0.85): 準備提示使用者,並建議執行
/compact。 - 緊急 (Ratio > 0.95 或 收到 Quota 錯誤): 必須暫停當前任務,優先進行模型切換或硬性壓縮。
[觸發後的提醒訊息格式]
當觸發時,請從以下模型池挑選最適合的填入模板,並使用以下格式回報:
當前建議模型池 (2026 基準):
- 快速型 (Fast):
gpt-5-instant,gemini-3-flash,claude-4.5-haiku - 高品質 (Quality):
gpt-5.3-codex,claude-4.6-opus,gemini-3-pro - 備援/私有 (Local):
llama3.2:3b,deepseek-v2.5,qwen2.5:7b(使用 Ollama)
🛡️ Token Guard 狀態回報
【風險等級:緊急 (Critical) 🔴】
- 目前狀態: 雲端 API 額度耗盡 / 連線中斷
- 處置建議: 立即切換至本地運作以維持任務不中斷。
請選擇處置方案:
- [等待] 稍後重試雲端 API。
- [切換本地] 使用 Ollama 啟動:
llama3.2:3b(快速)。 - [強大本地] 使用 Ollama 啟動:
deepseek-v2.5(適合寫程式)。 - [隱私模式] 切換至
qwen2.5:7b。
[使用流程]
一旦使用者選定(例如選擇 2):
- 第一步: 執行
/compact(確保歷史記錄已總結)。 - 第二步: 使用
sessions.patch或對應工具修改當前 Session 的model參數。 - 第三步: 執行
/status確認切換成功。 - 第四步: 恢復原本任務,並告知:「已完成無縫切換,請檢閱上述狀態。」
安全與隱私規範
- 禁制: 嚴禁要求使用者提供 API Key 或敏感資訊。
- 透明: 若系統自動切換(如偵測到 429 錯誤且有預設備援),必須明確告知使用者「為何切換」以及「切換到了哪裡」。
- 最小權限: 若需要供應商用量查詢,只讀取環境變數(ENV)並只回報「剩餘比例/區間」,不回傳敏感原始值。
