--- read_when: - คุณกำลังเชื่อมต่อพื้นผิวการใช้งาน/โควตาของผู้ให้บริการ - คุณต้องอธิบายพฤติกรรมการติดตามการใช้งานหรือข้อกำหนดด้านการยืนยันตัวตน summary: ส่วนติดต่อการติดตามการใช้งานและข้อกำหนดด้านข้อมูลประจำตัว title: การติดตามการใช้งาน x-i18n: generated_at: "2026-06-27T17:30:59Z" model: gpt-5.5 postprocess_version: locale-links-v1 provider: openai source_hash: 953f9671093c26f874b19fc0e6f8aee0ebf3379d4a6698bc8548abf942e37a59 source_path: concepts/usage-tracking.md workflow: 16 --- ## คืออะไร - ดึงการใช้งาน/โควตาของผู้ให้บริการโดยตรงจาก usage endpoints ของผู้ให้บริการนั้น - ไม่มีค่าใช้จ่ายโดยประมาณ มีเฉพาะช่วงเวลาโควตาที่ผู้ให้บริการรายงาน หรือสรุปสถานะบัญชี - เอาต์พุตสถานะช่วงเวลาโควตาที่มนุษย์อ่านได้จะถูกทำให้เป็นรูปแบบเดียวกันเป็น `X% left` แม้เมื่อ API ต้นทางรายงานโควตาที่ใช้ไป โควตาที่เหลือ หรือมีเพียงจำนวนดิบ ผู้ให้บริการที่ไม่มีช่วงเวลาโควตาแบบรีเซ็ตได้สามารถแสดงข้อความสรุปจากผู้ให้บริการแทนได้ เช่น ยอดคงเหลือ - `/status` ระดับเซสชันและ `session_status` สามารถ fallback ไปยังรายการการใช้งานล่าสุดใน transcript ได้เมื่อสแนปช็อตเซสชันสดมีข้อมูลน้อย fallback นั้นเติมตัวนับ token/cache ที่ขาดหาย สามารถกู้คืนป้ายกำกับโมเดล runtime ที่ใช้งานอยู่ และเลือกผลรวมแบบเน้นพรอมป์ต์ที่มีค่ามากกว่าเมื่อ metadata ของเซสชันขาดหายหรือมีค่าน้อยกว่า ค่าสดที่ไม่เป็นศูนย์ที่มีอยู่ยังคงชนะ ## แสดงที่ไหน - `/status` ในแชต: การ์ดสถานะที่มีอีโมจิมาก พร้อม token ของเซสชัน + ค่าใช้จ่ายโดยประมาณ (เฉพาะ API key) การใช้งานของผู้ให้บริการจะแสดงสำหรับ **ผู้ให้บริการโมเดลปัจจุบัน** เมื่อมีข้อมูล เป็นช่วงเวลา `X% left` ที่ปรับรูปแบบแล้ว หรือข้อความสรุปจากผู้ให้บริการ - `/usage off|tokens|full` ในแชต: ส่วนท้ายการใช้งานต่อการตอบกลับ (OAuth แสดงเฉพาะ token) - `/usage cost` ในแชต: สรุปค่าใช้จ่ายภายในเครื่องที่รวบรวมจากบันทึกเซสชัน OpenClaw - CLI: `openclaw status --usage` พิมพ์รายละเอียดแบบเต็มรายผู้ให้บริการ - CLI: `openclaw channels list` พิมพ์สแนปช็อตการใช้งานเดียวกันควบคู่กับการกำหนดค่าผู้ให้บริการ (ใช้ `--no-usage` เพื่อข้าม) - แถบเมนู macOS: ส่วน "การใช้งาน" ใต้ Context (เฉพาะเมื่อมีข้อมูล) ## โหมดส่วนท้ายการใช้งานเริ่มต้น `/usage off|tokens|full` ตั้งค่าส่วนท้ายสำหรับเซสชันและจะจดจำไว้สำหรับเซสชันนั้น `messages.responseUsage` ใช้เป็นค่าเริ่มต้นของโหมดนั้นสำหรับเซสชันที่ยังไม่ได้เลือก เพื่อให้ส่วนท้ายเปิดอยู่โดยค่าเริ่มต้นได้โดยไม่ต้องพิมพ์ `/usage` ทุกครั้ง ตั้งค่าโหมดเดียวสำหรับทุกช่องทาง หรือแผนที่รายช่องทางพร้อม fallback `default`: ```jsonc { "messages": { "responseUsage": "tokens", // or: { "default": "off", "discord": "full" } }, } ``` ### สถานะเซสชันที่แตกต่างกันสามแบบ ฟิลด์ `responseUsage` ของเซสชันมีสถานะที่แทนค่าได้สามแบบ โดยแต่ละแบบมีความหมายต่างกัน: | สถานะ | ค่าที่จัดเก็บ | โหมดที่มีผล | | ------------------- | ------------------------------- | --------------------------------------------------------------------- | | **ยังไม่ได้ตั้ง / สืบทอด** | `undefined` (ไม่มีอยู่) | ไหลต่อไปยังค่าเริ่มต้น config `messages.responseUsage` แล้วจึงเป็น `off` | | **ปิดโดยชัดเจน** | `"off"` (จัดเก็บไว้) | ปิดเสมอ — ค่าเริ่มต้น config ที่ไม่ใช่ off ไม่สามารถเปิดส่วนท้ายกลับมาได้ | | **เปิดโดยชัดเจน** | `"tokens"` หรือ `"full"` (จัดเก็บไว้) | โหมดนั้น โดยไม่ขึ้นกับค่าเริ่มต้น config | ### ลำดับความสำคัญ โหมดที่มีผล = การ override ของเซสชัน → รายการ config ของช่องทาง → `default` → `off` `/usage off` ที่ชัดเจนจะถูก **persist** เป็นค่าตรงตัว `"off"` ในเซสชัน ไม่ใช่เหมือนกับ "unset" ซึ่งหมายความว่าค่าเริ่มต้น `messages.responseUsage` ที่ไม่ใช่ off ไม่สามารถเปิดส่วนท้ายกลับมาได้หลังจากผู้ใช้ปิดไว้อย่างชัดเจนแล้ว ### รีเซ็ตเทียบกับปิด - `/usage off` — บังคับปิดส่วนท้ายและ persist ตัวเลือกนั้น ค่าเริ่มต้นที่กำหนดค่าไว้ซึ่งไม่ใช่ off ไม่สามารถ override ได้ - `/usage reset` (นามแฝง: `inherit`, `clear`, `default`) — ล้างการ override ของเซสชัน จากนั้นเซสชันจะ **สืบทอด** ค่าเริ่มต้น config ที่มีผล (`messages.responseUsage`) หากไม่ได้กำหนดค่าเริ่มต้นไว้ ส่วนท้ายจะปิด (ไม่เปลี่ยนจากเดิม) ใช้สิ่งนี้เพื่อ "กลับไปใช้ค่าเริ่มต้น" โดยไม่เปิดส่วนท้ายอย่างชัดเจน - การรีเซ็ตเซสชันแบบเต็ม (`/reset` หรือ `/new`) หรือการ rollover เซสชันจะ **รักษา** ค่ากำหนดโหมดการใช้งานที่ตั้งไว้อย่างชัดเจน เพื่อให้ตัวเลือกการแสดงผลของผู้ใช้คงอยู่หลังการ rollover เซสชัน มีเพียง `/usage reset` (และนามแฝงของมัน) เท่านั้นที่ล้างการ override จริง ### พฤติกรรมการสลับ `/usage` ที่ไม่มีอาร์กิวเมนต์จะวน: off → tokens → full → off จุดเริ่มต้นของวงรอบคือโหมดปัจจุบันที่ **มีผล** (การ override ของเซสชันที่ไหลต่อไปยังค่าเริ่มต้น config เมื่อยังไม่ได้ตั้ง) ดังนั้นวงรอบจึงสอดคล้องกับสิ่งที่ผู้ใช้เห็นในส่วนท้ายเสมอ ### Config เมื่อไม่มี config พฤติกรรมเดิมยังคงอยู่ (ส่วนท้ายปิดจนกว่าจะใช้ `/usage`) ใช้ `/usage reset` เพื่อล้างการ override ของเซสชันและกลับไปสืบทอดค่าเริ่มต้นที่กำหนดค่าไว้ ## ส่วนท้าย `/usage full` แบบกำหนดเอง `/usage full` แสดงส่วนท้ายขนาดกะทัดรัดในตัวที่มีโมเดล reasoning, fast/slow, context window, token ของ turn, cache และค่าใช้จ่ายเมื่อมีฟิลด์เหล่านั้น ไม่ต้องใช้ไฟล์เทมเพลต `messages.usageTemplate` มีไว้สำหรับเลย์เอาต์แบบกำหนดเองขั้นสูงเท่านั้น ค่าคือ path ไฟล์ JSON (รองรับ `~`) หรือ object แบบ inline และจะแทนที่ส่วนท้ายในตัวเมื่อถูกต้อง: ```json { "messages": { "usageTemplate": "~/.openclaw/usage-footer.json" } } ``` เทมเพลตที่ขาดหายหรือว่างเปล่าจะ fallback ไปยังส่วนท้ายในตัวแบบเงียบ ๆ เทมเพลตที่กำหนดค่าไว้ซึ่งอ่านไม่ได้หรือไม่ถูกต้องก็จะ fallback ไปยังส่วนท้ายในตัวเช่นกัน และ emit คำเตือนสำหรับ operator เริ่มเทมเพลตแบบกำหนดเองจาก shape ในตัว แล้วแก้ไขส่วนที่ต้องการเปลี่ยน: ```jsonc { "schema": "openclaw.usageBar.v1", "scales": { "braille": "⠐⡀⡄⡆⡇⣇⣧⣷⣿", "block": "░▏▎▍▌▋▊▉█", "shade": "░▒▓█", "moon": "🌑🌘🌗🌖🌕", "level": "▁▂▃▄▅▆▇█", "weather": ["🥶", "☁️", "🌥", "⛅️", "🌤", "☀️"], "plants": ["🪾", "🍂", "🌱", "☘️", "🍀", "🌿"], "moons6": ["🌑", "🌚", "🌘", "🌗", "🌖", "🌝"], }, "aliases": { "models": { "claude-opus-4-6": "opus46", "claude-opus-4-8": "opus48", "claude-sonnet-4-6": "sonnet46", "claude-haiku-4-5": "haiku45", "gpt-5.5": "gpt5.5", }, "reasoning": { "off": "🌑", "minimal": "🌚", "low": "🌘", "medium": "🌗", "high": "🌕", "xhigh": "🌝", }, }, "output": { "sep": "", "default": [ { "text": "{model.provider}{identity.emoji|🤖} {model.display_name|alias:models}" }, { "map": "model.is_fallback", "cases": { "true": " 🔄" } }, { "map": "model.is_override", "cases": { "true": " 📌" } }, { "when": "model.reasoning", "text": " {model.reasoning|alias:reasoning}" }, { "map": "state.fast_mode", "cases": { "true": " ⚡", "false": " 🐌" } }, { "when": "context.max_tokens", "text": " | 📚 [{context.pct_used|meter:5:braille}]{context.max_tokens|num}", }, { "when": "usage.has_split_tokens", "text": " ↕️ {usage.input_tokens|num|?}/{usage.output_tokens|num|?}", }, { "when": "usage.has_total_only_tokens", "text": " ↕️ {usage.total_tokens|num}" }, { "when": "usage.cache_hit_pct", "text": " 🗄 {usage.cache_hit_pct|pct}" }, { "when": "cost.turn_usd", "text": " 💰{cost.turn_usd|fixed:4}" }, ], "surfaces": { "discord": [ { "text": "-# -\n" }, { "text": "-# {model.provider}{identity.emoji|🤖} {model.display_name|alias:models}" }, { "map": "model.is_fallback", "cases": { "true": "🔄" } }, { "map": "model.is_override", "cases": { "true": "📌" } }, { "when": "model.reasoning", "text": " {model.reasoning|alias:reasoning}" }, { "map": "state.fast_mode", "cases": { "true": " ⚡️", "false": " 🐌" } }, { "when": "context.max_tokens", "text": " | 📚 [{context.pct_used|meter:5:braille}]{context.max_tokens|num}", }, { "when": "usage.has_split_tokens", "text": " ↕️ {usage.input_tokens|num|?}/{usage.output_tokens|num|?}", }, { "when": "usage.has_total_only_tokens", "text": " ↕️ {usage.total_tokens|num}" }, { "when": "usage.cache_hit_pct", "text": " 🗄 {usage.cache_hit_pct|pct}" }, { "when": "cost.turn_usd", "text": " 💰{cost.turn_usd|fixed:4}" }, ], }, }, } ``` ### Shape ```jsonc { "schema": "openclaw.usageBar.v1", "scales": { "": "low-to-high glyphs" }, // string (1 glyph/char) or array "aliases": { "": { "": "