คู่มือการตั้งค่า

คู่มือการตั้งค่าผู้ให้บริการ

ดูขั้นตอนการตั้งค่าและการแก้ปัญหาตามเครื่องมือ

การตั้งค่า OpenClaw

OpenClaw เป็นเครื่องมือ Terminal/Web UI สำหรับการเขียนโค้ดโดยเฉพาะ โดยรองรับโปรโตคอลโมเดลที่หลากหลาย จุดสำคัญของการตั้งค่าจึงไม่ใช่แค่การกรอก URL เพียงอย่างเดียว แต่คือการจับคู่ baseUrl และ api ให้ถูกต้องตรงกัน

เครื่องมือนี้คืออะไรและใช้ทำอะไร

ขั้นแรก: ตรวจสอบวิธีเลือกโปรโตคอล

สถานการณ์การใช้งานวิธีตรวจสอบ Base URLวิธีเลือกฟิลด์ API
OpenAI Nativeใช้ที่อยู่ API แบบ OpenAI / เข้ากันได้กับ OpenAI ที่ผู้ให้บริการจัดเตรียมไว้ โดยการใส่ /v1 หรือไม่นั้นขึ้นอยู่กับระบบหลังบ้านของผู้ให้บริการopenai-responses
Claude Nativeใช้ที่อยู่อินเทอร์เฟซ Anthropic / Claude ที่ผู้ให้บริการจัดเตรียมไว้anthropic-messages
Gemini Nativeใช้ที่อยู่อินเทอร์เฟซ Google / Gemini ที่ผู้ให้บริการจัดเตรียมไว้google-generative-ai
โหมดความเข้ากันได้ (Compatibility Mode)ที่อยู่อินเทอร์เฟซที่เข้ากันได้กับ OpenAI ของผู้ให้บริการopenai-completions

หากหน้าเว็บของผู้ให้บริการแยกอินเทอร์เฟซสำหรับ OpenAI, Claude และ Gemini ออกจากกัน อย่าคัดลอกเฉพาะชื่อโดเมน แต่ให้คัดลอกที่อยู่อย่างสมบูรณ์ตามโปรโตคอลที่เกี่ยวข้องด้วย

ตัวอย่างโค้ดการกำหนดค่า

โดยทั่วไปไฟล์การกำหนดค่าจะอยู่ที่ ~/. openclaw/openclaw.json หากวิซาร์ดเริ่มต้นระบบไม่สามารถกรอกที่อยู่ของผู้ให้บริการได้อย่างถูกต้อง คุณสามารถข้ามขั้นตอนการเลือกโมเดลไปก่อน แล้วค่อยแก้ไขไฟล์การกำหนดค่าด้วยตนเองในภายหลัง

ตัวอย่างการตั้งค่าผู้ให้บริการรายเดียวใน OpenClaw
"models": { "providers": { "mz-openai": { "baseUrl": "https://YOUR_PROVIDER_API_URL", "apiKey": "YOUR_KEY", "auth": "api-key", "api": "openai-responses", "models": [ { "id": "MODEL_ID_FROM_PROVIDER_DASHBOARD", "name": "DISPLAY_NAME", "reasoning": false, "input": [], "contextWindow": 128000, "maxTokens": 32000 } ] } } }

วิธีตรวจสอบหลังจากบันทึก

  1. ขั้นแรก ให้กำหนดค่าผู้ให้บริการเพียงรายเดียวก่อน และอย่าเพิ่งเพิ่มโมเดลหลายตัวพร้อมกัน
  2. เข้าไปยังโปรเจกต์ทดสอบและเลือกโมเดลที่เพิ่งเพิ่มเข้ามา
  3. ส่งคำถามที่สั้นที่สุด เช่น 'โปรดตอบกลับเฉพาะคำว่า: ตั้งค่าสำเร็จ'
  4. หากพบข้อผิดพลาดเกี่ยวกับโปรโตคอล ให้ตรวจสอบก่อนว่าฟิลด์ api และ Base URL มาจากอินเทอร์เฟซประเภทเดียวกันหรือไม่

คำถามที่พบบ่อยสำหรับผู้เริ่มต้น

ปัญหาที่พบสิ่งที่ควรตรวจสอบก่อนวิธีแก้ไข
ข้อผิดพลาดเกี่ยวกับโปรโตคอลตรวจสอบว่าฟิลด์ api ตรงกับ Base URL หรือไม่อย่าผสมระหว่าง OpenAI, Claude และ Gemini เข้าด้วยกัน ให้กรอกข้อมูลให้ตรงกับโปรโตคอลของผู้ให้บริการนั้นๆ
รายการโมเดลว่างเปล่าผู้ให้บริการรองรับการดึงรายการโมเดลหรือไม่?หากดึงข้อมูลไม่สำเร็จ ให้กรอก Model ID / ชื่อโมเดลที่ระบบหลังบ้านระบุไว้ด้วยตนเอง
แก้ไขไฟล์การกำหนดค่าแล้วแต่ไม่มีผลไฟล์ที่แก้ไขตรงกับไฟล์ที่ OpenClaw อ่านค่าจริงหรือไม่รีสตาร์ต OpenClaw แล้วลองทดสอบใหม่อีกครั้ง และหลีกเลี่ยงการเปลี่ยนการตั้งค่าหลายจุดพร้อมกัน
Key ถูกต้องแต่ยังใช้งานไม่ได้ฟิลด์ auth และ apiKey ของ Provider ปัจจุบันตรวจสอบให้แน่ใจว่า Key ตรงกับโปรโตคอลและผู้ให้บริการปัจจุบัน
เว็บไซต์ทางการของ OpenClaw ดูข้อมูลแนะนำเครื่องมือและทางเข้าใช้งาน
เอกสารอ้างอิงการตั้งค่าผู้ให้บริการ AI บน OpenClaw ดูแนวคิดการจับคู่ฟิลด์ baseUrl และ api ตามโปรโตคอลต่างๆ