การติดตามการใช้งาน

# คืออะไร

• ดึงข้อมูลการใช้งาน/โควตาของผู้ให้บริการโดยตรงจาก endpoint การใช้งานของผู้ให้บริการนั้น ๆ
• ไม่มีต้นทุนโดยประมาณ; มีเฉพาะช่วงเวลาที่ผู้ให้บริการรายงานเท่านั้น
• เอาต์พุตสถานะที่มนุษย์อ่านได้จะถูกทำให้เป็นรูปแบบปกติเป็น เหลือ X% แม้เมื่อ API ต้นทางรายงานโควตาที่ใช้ไปแล้ว โควตาที่เหลืออยู่ หรือเฉพาะจำนวนดิบเท่านั้น
• /status ระดับเซสชันและ session_status สามารถ fallback ไปยังรายการการใช้งานล่าสุด ใน transcript ได้เมื่อ snapshot ของเซสชันสดมีข้อมูลน้อย fallback นั้นจะเติมตัวนับ token/cache ที่ขาดไป สามารถกู้คืนป้ายกำกับโมเดล runtime ที่ใช้งานอยู่ได้ และจะเลือกผลรวมที่เน้น prompt ซึ่งมากกว่าเมื่อ metadata ของเซสชันขาดหายไปหรือน้อยกว่า ค่าสดที่ไม่ใช่ศูนย์ซึ่งมีอยู่แล้วยังคงมีสิทธิ์เหนือกว่า

# แสดงที่ไหน

• /status ในแชต: การ์ดสถานะที่มี emoji จำนวนมากพร้อม token ของเซสชัน + ต้นทุนโดยประมาณ (เฉพาะคีย์ API) การใช้งานของผู้ให้บริการจะแสดงสำหรับ ผู้ให้บริการโมเดลปัจจุบัน เมื่อมีข้อมูล ในรูปแบบหน้าต่าง เหลือ X% ที่ถูกทำให้เป็นรูปแบบปกติแล้ว
• /usage off|tokens|full ในแชต: ส่วนท้ายการใช้งานต่อคำตอบ (OAuth แสดงเฉพาะ token)
• /usage cost ในแชต: สรุปต้นทุนในเครื่องที่รวมจากบันทึกเซสชัน OpenClaw
• CLI: openclaw status --usage พิมพ์รายละเอียดแยกตามผู้ให้บริการแบบครบถ้วน
• CLI: openclaw channels list พิมพ์ snapshot การใช้งานเดียวกันพร้อมกับ config ของผู้ให้บริการ (ใช้ --no-usage เพื่อข้าม)
• แถบเมนู macOS: ส่วน “การใช้งาน” ภายใต้บริบท (เฉพาะเมื่อมีข้อมูล)

# ผู้ให้บริการ + credentials

• Anthropic (Claude): OAuth token ใน auth profiles
• GitHub Copilot: OAuth token ใน auth profiles
• Gemini CLI: OAuth token ใน auth profiles
  • การใช้งาน JSON fallback ไปที่ stats; stats.cached จะถูกทำให้เป็นรูปแบบปกติเป็น cacheRead
• OpenAI Codex: OAuth token ใน auth profiles (ใช้ accountId เมื่อมี)
• MiniMax: คีย์ API หรือ auth profile OAuth ของ MiniMax OpenClaw ถือว่า minimax, minimax-cn, และ minimax-portal เป็นพื้นผิวโควตา MiniMax เดียวกัน จะเลือก OAuth ของ MiniMax ที่จัดเก็บไว้ก่อนเมื่อมี และมิฉะนั้นจะ fallback ไปที่ MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY, หรือ MINIMAX_API_KEY การ polling การใช้งานจะหา host ของ Coding Plan จาก models.providers.minimax-portal.baseUrl หรือ models.providers.minimax.baseUrl เมื่อกำหนดค่าไว้ และมิฉะนั้นจะใช้ host MiniMax CN ฟิลด์ดิบ usage_percent / usagePercent ของ MiniMax หมายถึงโควตาที่ เหลืออยู่ ดังนั้น OpenClaw จะกลับค่าก่อนแสดงผล; ฟิลด์ที่อิงจำนวนมีสิทธิ์เหนือกว่าเมื่อมี
  • ป้ายกำกับหน้าต่างของ coding-plan มาจากฟิลด์ชั่วโมง/นาทีของผู้ให้บริการเมื่อมี จากนั้น fallback ไปที่ช่วง start_time / end_time
  • หาก endpoint ของ coding-plan ส่งคืน model_remains OpenClaw จะเลือก รายการโมเดลแชตก่อน หา label ของหน้าต่างจาก timestamp เมื่อไม่มีฟิลด์ window_hours / window_minutes ที่ระบุชัดเจน และรวมชื่อโมเดลไว้ใน label ของแผน
• Xiaomi MiMo: คีย์ API ผ่าน env/config/auth store (XIAOMI_API_KEY)
• z.ai: คีย์ API ผ่าน env/config/auth store

การใช้งานจะถูกซ่อนเมื่อไม่สามารถ resolve auth สำหรับการใช้งานของผู้ให้บริการที่ใช้ได้ ผู้ให้บริการ สามารถระบุ logic auth การใช้งานเฉพาะ Plugin ได้; มิฉะนั้น OpenClaw จะ fallback ไปยัง credential แบบ OAuth/API-key ที่ตรงกันจาก auth profiles, environment variables, หรือ config

# ที่เกี่ยวข้อง

• การใช้ token และต้นทุน
• การใช้งาน API และต้นทุน
• การแคช prompt