Technical reference

การใช้งาน API และค่าใช้จ่าย

แผนผังฟีเจอร์ของ OpenClaw ที่สามารถเรียก API ของผู้ให้บริการแบบชำระเงิน ตำแหน่งที่แต่ละฟีเจอร์อ่านข้อมูลประจำตัว และตำแหน่งที่ค่าใช้จ่ายที่เกิดขึ้นปรากฏ

ค่าใช้จ่ายปรากฏที่ใด

/status (ภาพรวมต่อเซสชัน)

แสดงโมเดลของเซสชันปัจจุบัน การใช้บริบท และจำนวนโทเค็นของคำตอบล่าสุด
เพิ่ม ค่าใช้จ่ายโดยประมาณ สำหรับคำตอบล่าสุดเมื่อ OpenClaw มีเมทาดาทาการใช้งานและราคาที่กำหนดภายในสำหรับโมเดลที่ใช้งานอยู่ รวมถึงผู้ให้บริการที่ไม่ได้ใช้คีย์ API แต่มีการกำหนดราคาไว้อย่างชัดเจน เช่น โมเดล Bedrock aws-sdk
หากภาพรวมเซสชันสดมีข้อมูลไม่ครบถ้วน /status จะกู้คืนตัวนับโทเค็น/แคชและป้ายชื่อโมเดลที่ใช้งานอยู่จากรายการการใช้งานล่าสุดในทรานสคริปต์ ค่าสดที่มีอยู่และไม่เป็นศูนย์จะมีลำดับความสำคัญเหนือข้อมูลทรานสคริปต์ แต่ผลรวมจากทรานสคริปต์ที่มีขนาดเท่าพรอมป์ยังคงมีลำดับความสำคัญได้เมื่อผลรวมที่จัดเก็บไว้ไม่มีอยู่หรือมีค่าน้อยกว่า

/usage (ส่วนท้ายต่อข้อความ)

/usage full เพิ่มส่วนท้ายการใช้งานต่อท้ายทุกคำตอบ รวมถึง ค่าใช้จ่ายโดยประมาณ เมื่อกำหนดราคาภายในไว้และมีเมทาดาทาการใช้งาน
/usage tokens แสดงเฉพาะโทเค็น รันไทม์ OAuth/โทเค็นแบบสมัครสมาชิกและรันไทม์ CLI จะแสดงเฉพาะโทเค็น เว้นแต่จะให้เมทาดาทาการใช้งานที่เข้ากันได้พร้อมราคาภายในที่ระบุไว้อย่างชัดเจน
/usage cost แสดงสรุปค่าใช้จ่ายภายใน ส่วน /usage off ปิดใช้งานส่วนท้าย
หมายเหตุสำหรับ Gemini CLI: ทั้งเอาต์พุต stream-json และ json แบบเดิมมีข้อมูลการใช้งานอยู่ภายใต้ stats OpenClaw ปรับ stats.cached ให้อยู่ในรูป cacheRead และคำนวณโทเค็นอินพุตจาก stats.input_tokens - stats.cached เมื่อจำเป็น

Control UI → การใช้งาน (การวิเคราะห์ข้ามเซสชัน)

แสดงผลรวมโทเค็นและค่าใช้จ่ายโดยประมาณที่ได้จากทรานสคริปต์สำหรับช่วงวันที่ที่เลือก พร้อมรายละเอียดแยกตามผู้ให้บริการ โมเดล เอเจนต์ ช่องทาง และประเภทโทเค็น
เปรียบเทียบช่วงปฏิทินที่สั้นกว่าซึ่งสิ้นสุดในวันที่สิ้นสุดของช่วงที่เลือก วันที่ที่ไม่มีข้อมูลจะนับเป็นวันปฏิทินที่มีการใช้งานเป็นศูนย์ โดยจะไม่ข้ามวันเหล่านั้นเพื่อสร้างช่วงที่มีข้อมูลหนาแน่นขึ้น
ระบุมาตราส่วนของแผนภูมิรายวันโดยตรง ป้าย √ หมายความว่ากำลังใช้การบีบอัดแบบรากที่สองเพื่อให้วันที่มีการใช้งานต่ำยังคงมองเห็นได้
ผลรวมเหล่านี้อธิบายประวัติเซสชันภายในที่มีอยู่ ไม่ใช่ใบแจ้งหนี้จากผู้ให้บริการหรือบัญชีแยกประเภทการเรียกเก็บเงินตลอดอายุการใช้งาน UI จะแจ้งเตือนเมื่อบางรายการไม่มีข้อมูลราคา

ช่วงการใช้งานของ CLI (โควตาของผู้ให้บริการ ไม่ใช่ค่าใช้จ่ายต่อข้อความ)

openclaw status --usage และ openclaw channels list แสดง ช่วงการใช้งาน ของผู้ให้บริการในรูป เหลือ X%
ผู้ให้บริการช่วงการใช้งานปัจจุบัน ได้แก่ Anthropic, ClawRouter, DeepSeek, GitHub Copilot, Gemini CLI, MiniMax, OpenAI (ครอบคลุมการรับรองความถูกต้องด้วย OAuth/โทเค็นของ ChatGPT/Codex), Xiaomi และ z.ai ดูรายการผู้ให้บริการ/แฟล็กทั้งหมดได้ที่ CLI สำหรับโมเดล และ CLI สำหรับช่องทาง
ฟิลด์ดิบ usage_percent / usagePercent ของ MiniMax รายงานโควตาที่เหลือ ดังนั้น OpenClaw จึงกลับค่า โดยฟิลด์แบบนับจำนวนจะมีลำดับความสำคัญเมื่อมีอยู่ หากการตอบกลับมีอาร์เรย์ model_remains OpenClaw จะเลือกรายการโมเดลแชต คำนวณป้ายชื่อช่วงจากการประทับเวลาเมื่อจำเป็น และรวมชื่อโมเดลไว้ในป้ายชื่อแพ็กเกจ
การรับรองความถูกต้องสำหรับการใช้งานมาจากฮุกเฉพาะผู้ให้บริการเมื่อมี มิฉะนั้น OpenClaw จะย้อนกลับไปใช้ข้อมูลประจำตัว OAuth/คีย์ API ที่ตรงกันจากโปรไฟล์การรับรองความถูกต้อง ตัวแปรสภาพแวดล้อม หรือการกำหนดค่า

ดูตัวอย่างโดยละเอียดที่ การใช้โทเค็นและค่าใช้จ่าย

วิธีค้นหาคีย์

โปรไฟล์การรับรองความถูกต้อง: แยกตามเอเจนต์ จัดเก็บไว้ใน auth-profiles.json
ตัวแปรสภาพแวดล้อม: ตัวอย่างเช่น OPENAI_API_KEY, BRAVE_API_KEY, FIRECRAWL_API_KEY
การกำหนดค่า: models.providers.*.apiKey, plugins.entries.*.config.webSearch.apiKey, plugins.entries.firecrawl.config.webFetch.apiKey, agents.defaults.memorySearch.*, talk.providers.*.apiKey
Skills: skills.entries.<name>.apiKey ซึ่งอาจส่งออกคีย์ไปยังสภาพแวดล้อมของโปรเซส Skills

ฟีเจอร์ที่สามารถใช้คีย์และก่อให้เกิดค่าใช้จ่าย

การตอบกลับของโมเดลหลัก (แชต + เครื่องมือ)

ทุกคำตอบหรือการเรียกเครื่องมือทำงานบนผู้ให้บริการโมเดลปัจจุบัน นี่คือแหล่งหลักของการใช้งานและค่าใช้จ่าย รวมถึงแพ็กเกจโฮสต์แบบสมัครสมาชิกที่เรียกเก็บเงินภายนอก UI ภายในของ OpenClaw ได้แก่ OpenAI Codex, Alibaba Cloud Model Studio Coding Plan, MiniMax Coding Plan, Z.AI/GLM Coding Plan และเส้นทางการเข้าสู่ระบบ Claude ของ Anthropic ที่เปิดใช้ Extra Usage

ดูการกำหนดราคาได้ที่ โมเดล และดูการแสดงผลได้ที่ การใช้โทเค็นและค่าใช้จ่าย

การทำความเข้าใจสื่อ (เสียง/รูปภาพ/วิดีโอ)

สื่อขาเข้าสามารถได้รับการสรุปหรือถอดเสียงผ่าน API ของผู้ให้บริการก่อนที่ไปป์ไลน์การตอบกลับจะทำงาน การรองรับผู้ให้บริการลงทะเบียนแยกตาม Plugin และเปลี่ยนแปลงเมื่อมีการเพิ่ม Plugin ดูรายการปัจจุบันและการกำหนดค่าได้ที่ การทำความเข้าใจสื่อ

การสร้างรูปภาพและวิดีโอ

image_generate และ video_generate จะกำหนดเส้นทางไปยังผู้ให้บริการที่กำหนดค่าไว้และพร้อมใช้งาน การสร้างรูปภาพสามารถอนุมานผู้ให้บริการเริ่มต้นที่มีการรับรองความถูกต้องรองรับได้เมื่อไม่ได้ตั้งค่า agents.defaults.imageGenerationModel ส่วนการสร้างวิดีโอต้องระบุ agents.defaults.videoGenerationModel อย่างชัดเจน (ตัวอย่างเช่น qwen/wan2.6-t2v)

ดูรายการผู้ให้บริการปัจจุบันได้ที่ การสร้างรูปภาพ และ การสร้างวิดีโอ

เอ็มเบดดิงหน่วยความจำและการค้นหาเชิงความหมาย

การค้นหาหน่วยความจำเชิงความหมายใช้ API เอ็มเบดดิงเมื่อ agents.defaults.memorySearch.provider ระบุอะแดปเตอร์ระยะไกล (ตัวอย่างเช่น openai, gemini, voyage, mistral, deepinfra, github-copilot, amazon-bedrock) memorySearch.provider = "lmstudio" หรือ "ollama" จะทำงานกับเซิร์ฟเวอร์ภายใน/ที่โฮสต์เองและโดยทั่วไปไม่มีการเรียกเก็บเงินจากบริการโฮสต์ memorySearch.provider = "local" จะประมวลผลทุกอย่างบนอุปกรณ์โดยไม่มีการใช้ API ผู้ให้บริการ memorySearch.fallback ที่เลือกกำหนดได้สามารถรองรับกรณีที่เอ็มเบดดิงภายในล้มเหลว

ดู หน่วยความจำ

เครื่องมือค้นหาเว็บ

web_search อาจก่อให้เกิดค่าบริการตามการใช้งาน ขึ้นอยู่กับผู้ให้บริการที่เลือก ผู้ให้บริการแต่ละรายจะอ่านคีย์จากตัวแปรสภาพแวดล้อมก่อน จากนั้นจึงอ่านจาก plugins.entries.<id>.config.webSearch.apiKey:

ผู้ให้บริการ	ตัวแปรสภาพแวดล้อม
Brave Search	`BRAVE_API_KEY`
DuckDuckGo	ไม่ต้องใช้คีย์; ไม่เป็นทางการ ใช้ HTML และไม่มีการเรียกเก็บเงิน
Exa	`EXA_API_KEY`
Firecrawl	`FIRECRAWL_API_KEY`
Gemini (Google Search)	`GEMINI_API_KEY`
Grok (xAI)	โปรไฟล์ OAuth ของ xAI หรือ `XAI_API_KEY`
Kimi (Moonshot)	`KIMI_API_KEY` หรือ `MOONSHOT_API_KEY`
MiniMax Search	`MINIMAX_CODE_PLAN_KEY`, `MINIMAX_CODING_API_KEY`, `MINIMAX_OAUTH_TOKEN` หรือ `MINIMAX_API_KEY`
Ollama Web Search	ไม่ต้องใช้คีย์สำหรับโฮสต์ภายในที่เข้าถึงได้และเข้าสู่ระบบแล้ว; การค้นหาโดยตรงผ่าน `https://ollama.com` ใช้ `OLLAMA_API_KEY`; โฮสต์ที่ป้องกันด้วยการรับรองความถูกต้องจะใช้การรับรองความถูกต้องแบบ bearer ของผู้ให้บริการ Ollama ตามปกติซ้ำ
Parallel	`PARALLEL_API_KEY`
Perplexity Search API	`PERPLEXITY_API_KEY` หรือ `OPENROUTER_API_KEY`
SearXNG	`SEARXNG_BASE_URL`; ไม่ต้องใช้คีย์/โฮสต์เอง และไม่มีการเรียกเก็บเงินจากบริการโฮสต์
Tavily	`TAVILY_API_KEY`

เส้นทางการกำหนดค่าแบบเดิม tools.web.search.* ยังคงโหลดผ่านชิมความเข้ากันได้ แต่ไม่ใช่พื้นผิวที่แนะนำอีกต่อไป

เครดิตฟรีของ Brave Search: แต่ละแพ็กเกจมีเครดิตฟรีที่ต่ออายุทุกเดือนมูลค่า $5 แพ็กเกจ Search มีราคา $5 ต่อ 1,000 คำขอ ดังนั้นเครดิตฟรีจึงครอบคลุมคำขอ 1,000 รายการต่อเดือนโดยไม่มีค่าใช้จ่าย ตั้งค่าขีดจำกัดการใช้งานในแดชบอร์ด Brave เพื่อหลีกเลี่ยงค่าใช้จ่ายที่ไม่คาดคิด

ดู เครื่องมือเว็บ

เครื่องมือดึงข้อมูลเว็บ (Firecrawl)

web_fetch สามารถเรียก Firecrawl โดยใช้สิทธิ์เริ่มต้นที่ไม่ต้องใช้คีย์ เพิ่ม FIRECRAWL_API_KEY (หรือ plugins.entries.firecrawl.config.webFetch.apiKey) เพื่อเพิ่มขีดจำกัด หากไม่ได้กำหนดค่า Firecrawl เครื่องมือจะย้อนกลับไปดึงข้อมูลโดยตรงร่วมกับ Plugin web-readability ที่รวมมาให้ (ไม่มี API แบบชำระเงิน) ปิดใช้ plugins.entries.web-readability.enabled เพื่อข้ามการแยกเนื้อหาด้วย Readability ภายใน

ดู เครื่องมือเว็บ

ภาพรวมการใช้งานของผู้ให้บริการ (สถานะ/ความพร้อมใช้งาน)

openclaw status --usage และ openclaw models status --json เรียกเอนด์พอยต์การใช้งานของผู้ให้บริการเพื่อแสดงช่วงโควตาหรือสถานะความพร้อมของการรับรองความถูกต้อง การเรียกเหล่านี้มีปริมาณน้อยแต่ยังคงเรียก API ของผู้ให้บริการ

ดู CLI สำหรับโมเดล

การสรุปเพื่อป้องกัน Compaction

กลไกป้องกัน Compaction สามารถสรุปประวัติเซสชันโดยใช้โมเดลปัจจุบัน ซึ่งจะเรียก API ของผู้ให้บริการเมื่อทำงาน

ดู การจัดการเซสชันและ Compaction

การสแกน/ตรวจสอบโมเดล

openclaw models scan สามารถตรวจสอบโมเดล OpenRouter และใช้ OPENROUTER_API_KEY เมื่อเปิดใช้งานการตรวจสอบ

ดู CLI สำหรับโมเดล

การสนทนา (เสียงพูด)

โหมดการสนทนาสามารถเรียก ElevenLabs เมื่อกำหนดค่าไว้: ELEVENLABS_API_KEY หรือ talk.providers.elevenlabs.apiKey

ดู โหมดการสนทนา

Skills (API ของบุคคลที่สาม)

Skills สามารถจัดเก็บ apiKey ไว้ใน skills.entries.<name>.apiKey หาก Skills ใช้คีย์ดังกล่าวกับ API ภายนอก ค่าใช้จ่ายจะเป็นไปตามผู้ให้บริการของ Skills นั้น

ดู Skills

เนื้อหาที่เกี่ยวข้อง

Was this useful?