Openclaw Skills 讓您可以在 macOS 上安裝並維護一個本地專屬的 Übersicht 小工具，用於追蹤 Codex token 使用量、根工作階段（root sessions）、來源標籤以及上下文視窗壓力。
安裝與下載
1. ClawHub CLI
從來源直接安裝技能的最快方式。
npx clawhub@latest install codex-usage-widget
2. 手動安裝
將技能資料夾複製到以下位置之一
~/.openclaw/skills/ <project>/skills/ 優先級：工作區 > 本地 > 內建
3. 提示詞安裝
將此提示詞複製到 OpenClaw 即可自動安裝。
請幫我使用 Clawhub 安裝 codex-usage-widget。如果尚未安裝 Clawhub，請先安裝（npm i -g clawhub）。
想要直接下載？
取得包含原生技能檔案的ZIP壓縮檔。
什麼是 Codex Usage Widget？
Openclaw Skills 提供了一個隱私優先的 macOS Übersicht 小工具，用於在不離開本地機器的情況下監控 Codex 活動。它讀取 ~\/.codex 下的本地 Codex 產出，聚合工作階段和 token 訊號，並在桌面上轉譯一個緊湊的檢視，展示使用量、最近的根工作階段以及上下文視窗壓力。\n\n由於它從不呼叫外部 API、不需要模型金鑰且從不上傳資料，因此非常適合需要輕量級本地 Codex 儀表板的開發人員。Openclaw Skills 採用盡力而為（best-effort）的設計理念，以便與 Codex 的本地儲存格式保持一致，同時保持易於安裝、更新、驗證和移除。
Codex Usage Widget 應用場景
- 在 macOS 上使用 Übersicht 安裝本地 Codex 使用量監控器。\n- 檢查最近的根工作階段和 token 計數事件，無需解析訊息文字。\n- 從本地來源標籤中區分使用來源，例如 VSCode、Client 和 Terminal。\n- 一目了然地追蹤上下文視窗壓力，以發現大型或持續增長的工作階段。\n- 在 Codex 或 Übersicht 發生變更後更新或重新安裝該小工具。\n- 乾淨地移除該小工具，而不影響其他小工具或 Codex 設定。
Codex Usage Widget 運作原理
- 執行
scripts\/install.sh將assets\/codex-usage.widget\/複製到~\/Library\/Application Support\/Übersicht\/widgets\/codex-usage.widget\/。\n2. Übersicht 會自動重新整理；如果沒有自動重新整理，請使用選單列項目重新整理所有小工具。\n3. 該小工具僅讀取本地 Codex 檔案：~\/.codex\/state_5.sqlite、~\/.codex\/logs_2.sqlite、~\/.codex\/sessions\/**\/*.jsonl和~\/.codex\/archived_sessions\/*.jsonl。\n4. 它按根工作階段聚合最近的列，因此產生的子代理（subagents）會被折疊到其父工作階段中，而不是個別顯示。\n5. 它從originator中繼資料中規範化來源標籤，並根據最新的input_tokens計算上下文視窗壓力。在工作階段超過 200K 之前使用 200K 視窗，超過後切換到 1M。\n6. 要維護該小工具，請重新執行scripts\/install.sh進行更新，使用 Python 進入點進行驗證，或執行scripts\/uninstall.sh僅移除此小工具目錄。
Codex Usage Widget 設定指南
需求\n- 已安裝 Übersicht 的 macOS\n- ~\/.codex 路徑下有本地 Codex 資料\n- 無需 API 金鑰、模型金鑰或網路設定\n\n### 安裝\nbash\nscripts\/install.sh\n\n\n這會將 assets\/codex-usage.widget\/ 複製到 ~\/Library\/Application Support\/Übersicht\/widgets\/codex-usage.widget\/。如果 Übersicht 沒有自動重新整理，請使用選單列項目重新整理所有小工具。\n\n### 驗證\nbash\npython3 "$HOME\/Library\/Application Support\/Übersicht\/widgets\/codex-usage.widget\/codex-usage.py"\n\n\n成功執行應輸出包含 "ok": true 的 JSON。\n\n### 更新\nbash\nscripts\/install.sh\n\n\n### 解除安裝\nbash\nscripts\/uninstall.sh\n\n\n這只會移除 ~\/Library\/Application Support\/Übersicht\/widgets\/codex-usage.widget\/，而不會影響其他小工具和 Codex 設定。
Codex Usage Widget 資料結構與分類體系
輸入源\n| 路徑 | 用途 | 備註 |\n| --- | --- | --- |\n| ~\/.codex\/state_5.sqlite | 執行緒中繼資料 | 用於分析執行緒與根工作階段之間的關係 |\n| ~\/.codex\/logs_2.sqlite | 本地記錄位元組總數 | 支援輕量級的使用上下文 |\n| ~\/.codex\/sessions\/**\/*.jsonl | 作用中工作階段事件流 | 提供 token 計數事件、來源標籤和壓力訊號 |\n| ~\/.codex\/archived_sessions\/*.jsonl | 封存工作階段事件流 | 用於最近的歷程記錄和分組列 |\n\n### 衍生分類\n- root_session：規範的分組鍵，可將產生的子代理折疊到父工作階段下。\n- source_label：根據 rollout originator 值衍生出的規範化顯示標籤，例如 codex_vscode -> VSCode，Codex Desktop -> Client，以及終端機或類似 CLI 的來源 -> Terminal。\n- context_window_pressure：根據最新的 input_tokens 計算得出；該小工具預設使用 200K 視窗，一旦工作階段超出該邊界，則切換到 1M。\n- recent_rows：僅根據封存狀態建置的盡力而為的本地活動列；該小工具從不解析訊息文字。\n\n### 產生的輸出\n- ~\/Library\/Application Support\/Übersicht\/widgets\/codex-usage.widget\/ — 從 assets\/codex-usage.widget\/ 複製的已安裝小工具目錄。\n- 該 Skill 不會建立外部遙測、API 負載、雲端匯出或長期存在的衍生資料庫檔案。
Codex Usage Widget 進階特性
- 僅限本地的架構，無外部 API 呼叫、模型金鑰或上傳。\n- 根工作階段聚合功能，可將產生的子代理折疊成一個易讀的儀表板列集。\n- 來源標籤規範化，以便在 VSCode、Codex Desktop 和終端機工作流程中快速識別。\n- 自適應上下文視窗壓力評分，當工作階段增長時，從 200K 調整為 1M。\n- 無損的安裝、更新和解除安裝指令碼，僅觸及小工具目錄。\n- 盡力而為的相容性設計，能夠容忍不同版本之間 Codex 本地儲存格式的變更。\n- 透過
codex-usage.py進行 CLI 驗證，用於安裝後快速驗證。
SKILL.md
加載中
Openclaw 相關技能
Memory Assistant
Openclaw Skills Memory Assistant 將每日筆記轉化為可搜尋的長期記憶系統，用於捕獲上下文、尋找歷史資訊並整合持久知識。
SSL Cert Monitor
Openclaw Skills 的 SSL Cert Monitor 稽核網域的憑證到期、憑證鏈完整性與 SNI 問題，然後產生支援 cron 的警報與狀態表。
YAML Config Validator
用於 YAML 驗證的 Openclaw Skills，在部署崩潰前擷取 Kubernetes, Docker Compose 和 GitHub Actions 的錯誤。
Narodmon Daily Summary → Telegram
透過獲取 24 小時讀數、產生附註解的圖表並將其傳送到 Telegram，自動執行每日 Narodmon 感測器報告。
精選*
