Providers
ClawRouter
ClawRouter มอบคีย์เดียวที่กำหนดขอบเขตตามนโยบายให้ OpenClaw สำหรับผู้ให้บริการโมเดลต้นทางหลายราย Plugin ที่รวมมาให้จะค้นหาเฉพาะโมเดลที่อนุญาตสำหรับคีย์นั้น กำหนดเส้นทางแต่ละโมเดลผ่านโปรโตคอลที่ประกาศไว้ และรายงานงบประมาณของคีย์กับการใช้งานรวมบนพื้นผิวการใช้งานของ OpenClaw
คุณไม่ต้องติดตั้งหรือยืนยันตัวตน Plugin ของผู้ให้บริการต้นทางแต่ละรายบนโฮสต์ OpenClaw ข้อมูลประจำตัวต้นทางและการส่งต่อเฉพาะผู้ให้บริการจะอยู่ใน ClawRouter OpenClaw ต้องการเพียง Plugin @openclaw/clawrouter ที่รวมมาให้และข้อมูลประจำตัว ClawRouter ที่ออกให้แล้วเท่านั้น
| คุณสมบัติ | ค่า |
|---|---|
| ผู้ให้บริการ | clawrouter |
| แพ็กเกจ | @openclaw/clawrouter |
| การยืนยันตัวตน | CLAWROUTER_API_KEY |
| URL เริ่มต้น | https://clawrouter.openclaw.ai |
| แคตตาล็อกโมเดล | กำหนดขอบเขตตามข้อมูลประจำตัวผ่าน /v1/catalog |
| โควตา | งบประมาณรายเดือนและการใช้งานผ่าน /v1/usage |
เริ่มต้นใช้งาน
รับข้อมูลประจำตัวที่กำหนดขอบเขต
ขอข้อมูลประจำตัวจากผู้ดูแลระบบ ClawRouter ของคุณ โดยนโยบายของข้อมูลประจำตัวนั้นต้องรวมผู้ให้บริการ โมเดล และงบประมาณรายเดือนที่คุณควรใช้ ข้อมูลประจำตัวจะแสดงให้เห็นเพียงครั้งเดียวเมื่อออกให้
กำหนดค่า OpenClaw
export CLAWROUTER_API_KEY="..."openclaw onboard --auth-choice clawrouter-api-keyopenclaw plugins enable clawrouterPlugin นี้รวมมากับ OpenClaw หากการกำหนดค่าของคุณตั้งค่า plugins.allow ให้เพิ่ม clawrouter ลงในรายการนั้นก่อนเปิดใช้งาน สำหรับการปรับใช้แบบกำหนดเอง ให้ตั้งค่า models.providers.clawrouter.baseUrl เป็นต้นทางของ ClawRouter ค่าเริ่มต้นคือ https://clawrouter.openclaw.ai
แสดงรายการโมเดลที่ได้รับสิทธิ์
openclaw models list --all --provider clawrouterใช้ refs ของโมเดลที่ส่งกลับมาตามที่แสดงทุกประการ โดยจะคง namespace ต้นทางไว้ เช่น clawrouter/openai/..., clawrouter/anthropic/... หรือ clawrouter/google/... หาก agents.defaults.models เป็น allowlist ในการกำหนดค่าของคุณ ให้เพิ่ม ref ของ ClawRouter ที่เลือกแต่ละรายการเข้าไป
เลือกโมเดล
openclaw models set clawrouter/<provider>/<model>คุณยังสามารถเลือกโมเดลที่ส่งกลับมาสำหรับการรันครั้งเดียวได้ด้วย openclaw agent --model clawrouter/<provider>/<model> --message "..."
การค้นหาโมเดล
GET /v1/catalog คือแหล่งข้อมูลที่เชื่อถือได้ OpenClaw ไม่ได้จัดส่งรายการโมเดล ClawRouter แบบตายตัวรายการที่สอง โมเดลที่กำหนดค่าใน ClawRouter จะปรากฏเมื่อ:
- นโยบายของข้อมูลประจำตัวให้สิทธิ์ผู้ให้บริการนั้น;
- การเชื่อมต่อผู้ให้บริการเปิดใช้งานและพร้อมใช้งาน;
- โมเดลในแคตตาล็อกประกาศความสามารถ LLM ที่รองรับ; และ
- แคตตาล็อกเปิดเผยสัญญาการขนส่งที่ Plugin รองรับ
ดังนั้นการเพิ่มโมเดลอื่นให้กับผู้ให้บริการ ClawRouter ที่รองรับจึงไม่ต้องมีการออก OpenClaw รุ่นใหม่หรือ Plugin ผู้ให้บริการตัวอื่น การรีเฟรชแคตตาล็อกครั้งถัดไปจะค้นพบโมเดลนั้น โมเดลที่ต้องใช้ wire protocol ใหม่ต้องได้รับการรองรับใน Plugin ClawRouter ก่อนที่ OpenClaw จะประกาศให้ใช้งาน
โปรโตคอลและ Plugin ผู้ให้บริการ
คุณไม่จำเป็นต้องติดตั้ง Plugin การยืนยันตัวตนของบริษัทต้นทางทุกแห่ง ClawRouter เป็นเจ้าของข้อมูลประจำตัวต้นทาง แคตตาล็อกของ ClawRouter จะบอก OpenClaw ว่าควรใช้การขนส่งแบบใด Plugin รองรับ:
| เส้นทางแคตตาล็อก | การขนส่งของ OpenClaw |
|---|---|
| แชตที่เข้ากันได้กับ OpenAI | openai-completions |
| Responses ที่เข้ากันได้กับ OpenAI | openai-responses |
| Anthropic Messages แบบเนทีฟ | anthropic-messages |
| การสตรีม Google Gemini แบบเนทีฟ | google-generative-ai |
Plugin ยังใช้นโยบายการเล่นซ้ำและ tool-schema ที่ตรงกันสำหรับตระกูลเหล่านั้นด้วย แถวในแคตตาล็อกที่ใช้รูปแบบคำขอ/สตรีมอื่นจะไม่ถูกประกาศเป็นโมเดลข้อความของ OpenClaw โดยตั้งใจ ให้ปรับผู้ให้บริการเหล่านั้นใน ClawRouter ให้เป็นหนึ่งในสัญญาที่รองรับ แทนที่จะส่ง payload ที่เข้ากันไม่ได้
โควตาและการใช้งาน
การตอบกลับ /v1/usage ของ ClawRouter จะป้อนข้อมูลเข้าสู่พื้นผิวการใช้งานผู้ให้บริการมาตรฐานของ OpenClaw /status และสถานะแดชบอร์ดที่เกี่ยวข้องจะแสดงหน้าต่างงบประมาณรายเดือนเมื่อคีย์มีขีดจำกัด พร้อมยอดรวมคำขอ โทเค็น และค่าใช้จ่าย คีย์ที่ไม่คิดตามมิเตอร์ยังคงแสดงการใช้งานรวมโดยไม่มีหน้าต่างเปอร์เซ็นต์
การค้นหาโควตาใช้คีย์ที่กำหนดขอบเขตเดียวกับการค้นหาโมเดล การค้นหาโควตาที่ล้มเหลวจะไม่บล็อกการเรียกใช้โมเดล
ตรวจสอบสแนปช็อตแบบสดด้วย:
openclaw status --usageopenclaw models statusสแนปช็อตผู้ให้บริการเดียวกันพร้อมใช้งานสำหรับ /status ในแชตและ UI การใช้งานของ OpenClaw งบประมาณเป็นระดับนโยบายทั้งหมด ดังนั้นคำขอที่ทำโดยไคลเอนต์อื่นซึ่งใช้นโยบาย ClawRouter เดียวกันสามารถเปลี่ยนเปอร์เซ็นต์ที่เหลืออยู่ได้
การแก้ไขปัญหา
| อาการ | ตรวจสอบ |
|---|---|
| ไม่มีโมเดล ClawRouter | ยืนยันว่า Plugin เปิดใช้งานอยู่และได้รับอนุญาตโดย plugins.allow จากนั้นตรวจสอบว่าข้อมูลประจำตัว active และให้สิทธิ์ผู้ให้บริการที่พร้อมใช้งานอย่างน้อยหนึ่งราย |
| โมเดล ClawRouter ที่กำหนดค่าไว้หายไป | ตรวจสอบความสามารถและรูปแบบเส้นทางของ /v1/catalog สำหรับโมเดลนั้น สัญญาการขนส่งที่ไม่รองรับจะถูกกรองออกโดยตั้งใจ |
Unknown model: clawrouter/... |
เพิ่ม ref จากแคตตาล็อกที่ตรงทุกประการลงใน agents.defaults.models เมื่อแผนที่การกำหนดค่านั้นถูกใช้เป็น allowlist |
401 หรือ 403 จากแคตตาล็อกหรือการใช้งาน |
ออกข้อมูลประจำตัว ClawRouter ใหม่หรือปรับขอบเขตใหม่ OpenClaw จะไม่ fallback ไปยังคีย์ผู้ให้บริการต้นทาง |
| การเรียกโมเดลล้มเหลวหลังการค้นหา | ตรวจสอบการเชื่อมต่อผู้ให้บริการและสถานะต้นทางใน ClawRouter แล้วลองใหม่หลังจากสถานะความพร้อมใช้งานฟื้นตัว |
| การใช้งานมียอดรวมแต่ไม่มีเปอร์เซ็นต์ | นโยบายไม่ได้คิดตามมิเตอร์ เพิ่มงบประมาณรายเดือนใน ClawRouter เพื่อแสดงหน้าต่างเปอร์เซ็นต์ |
พฤติกรรมด้านความปลอดภัย
- การค้นหาแคตตาล็อกถูกกำหนดขอบเขตตามคีย์พร็อกซีที่กำหนดค่าไว้และแคชต่อคีย์
- คีย์พร็อกซีจะแนบเฉพาะตอนส่งคำขอเท่านั้น และจะไม่ถูกจัดเก็บในเมทาดาทาโมเดล
- รหัสโมเดล Anthropic และ Gemini แบบเนทีฟจะถูกเขียนใหม่เป็นรหัสต้นทางเฉพาะตอนส่งคำขอเท่านั้น
- แถวในแคตตาล็อกที่ไม่รองรับหรือไม่ได้รับสิทธิ์จะ fail closed และไม่สามารถเลือกได้
