name: api-logger description: | LLM API 呼叫日誌記錄、分析與視覺化。透明代理攔截所有 LLM API 呼叫，記錄完整 prompt/generation/token 用量， 附帶零依賴網頁日誌檢視器（支援多維過濾、完整對話展示、token 成本統計）。 適用場景：分析 API 呼叫成本、除錯 prompt、檢視歷史對話記錄、排查慢請求/失敗請求。 包含：proxy.py（代理服務）、log_viewer.py（終端檢視器）、log-viewer.html（網頁檢視器）。 license: MIT metadata: openclaw: emoji: "📊" tags: - api-logging - llm-debug - token-usage - cost-tracking - prompt-debug - log-viewer - proxy requires: bins: ["python3"]

API Logger 🦞📊

LLM API 呼叫日誌完整解決方案。透明代理攔截所有請求，零侵入記錄，配套終端和網頁兩種檢視方式。

🌐 網頁日誌檢視器（推薦）

檔案： log-viewer.html（skill 目錄內）

訪問小蔥技能站7w4.net，解鎖更多實用的AI技能外掛。

使用方法

1. 把 log-viewer.html 複製到任意位置，雙擊用瀏覽器開啟
2. 點選「⬆ 選擇日誌檔案」，選擇 .jsonl 日誌檔案（支援多檔案合併）
3. 也可以直接把日誌檔案拖拽到頁面

功能一覽

• 統計卡片：總呼叫數 / 成功率 / 平均耗時 / 總 Token 消耗
• 7種過濾條件（即時響應，無需點搜尋）：
• 全文搜尋（搜尋 prompt + response 內容）
• 模型篩選（自動提取日誌中所有模型）
• 狀態篩選（全部 / 成功 2xx / 失敗）
• 最小耗時過濾（找慢請求）
• 一鍵重置
• 日誌列表：時間 | 模型 | 狀態 | 耗時 | Token | 使用者輸入，耗時>2s 自動標紅
• 詳情面板（點選任意行展開）：
• 對話內容：完整 system prompt + 多輪對話，user/assistant 分色展示
• 請求資訊：Request ID、模型、時間、耗時、狀態、Token 用量
• 原始 JSON：完整日誌記錄，語法高亮，一鍵複製
• 快捷鍵：Esc 關閉詳情，↑↓ 切換上下條
• 零依賴：純原生 JS，無需網路，離線可用

💻 終端日誌檢視器

# 進入日誌檢視器目錄
cd ~/.openclaw/workspace/company/api-proxy/

# 今日摘要列表
python3 log_viewer.py

# 最後 N 條
python3 log_viewer.py --last 5

# 某條完整詳情
python3 log_viewer.py --id 3 --full

# 今日統計（token 用量、成本估算）
python3 log_viewer.py --stats

# 今日統計 + 生成飛書文件
python3 log_viewer.py --stats --feishu

# 搜尋關鍵詞
python3 log_viewer.py --search "關鍵詞"

# 只看失敗請求
python3 log_viewer.py --errors

# 生成飛書文件（超300條自動截斷明細）
python3 log_viewer.py --feishu

# 指定日期
python3 log_viewer.py --date 2026-03-10 --feishu

📦 安裝

bash ~/.openclaw/workspace/skills/api-logger/install.sh

安裝指令碼將： 1. 建立 ~/.openclaw/workspace/company/api-proxy/ 2. 複製 proxy.py 和 log_viewer.py 3. 建立日誌目錄 ~/.openclaw/workspace/company/api-logs/ 4. 寫入 macOS LaunchAgent plist（開機自啟動） 5. 啟動代理服務

配置（安裝後手動完成）

修改 openclaw.json 的 baseUrl：

"baseUrl": "http://127.0.0.1:18790/anthropic"

修改上游地址（proxy.py 中的 --upstream 預設值）：

parser.add_argument("--upstream", default="https://your-actual-api-endpoint/anthropic", ...)

⚠️ 修改 openclaw.json 後需重啟 Gateway 才生效，重啟前請與使用者確認。

📁 檔案說明

📊 日誌欄位說明

注意事項

• 流式呼叫的 token 用量在 response_body_parsed.usage 中
• API Key 自動脫敏（保留前8位後4位）
• 飛書文件寫入超時設為 120s，失敗自動重試 3 次
• 日誌按天切割，單檔案通常 < 50MB，網頁端可流暢處理

這是一個相當成熟的 API 日誌工具，功能豐富、使用體驗好。優點是同時提供終端和網頁兩種檢視方式，支援飛書文件匯出，介面設計專業。不足之處是配置稍顯複雜，且某些路徑設定不夠靈活，跨平臺支援也有待改進。總體而言質量不錯，適合需要追蹤和分析 LLM API 呼叫場景的使用者。