FAQ
คำถามที่พบบ่อย: โมเดลและการยืนยันตัวตน
คำถามและคำตอบเกี่ยวกับโมเดลและโปรไฟล์การยืนยันตัวตน สำหรับการตั้งค่า เซสชัน Gateway ช่องทาง และ การแก้ไขปัญหา โปรดดู คำถามที่พบบ่อย หลัก
โมเดล: ค่าเริ่มต้น การเลือก นามแฝง และการสลับ
"โมเดลเริ่มต้น" คืออะไร
ตั้งค่าด้วย:
agents.defaults.model.primaryโมเดลคือการอ้างอิง provider/model (ตัวอย่าง: openai/gpt-5.5,
anthropic/claude-sonnet-4-6) ให้ตั้งค่า provider/model อย่างชัดเจนเสมอ หาก
ไม่ระบุผู้ให้บริการ OpenClaw จะลองจับคู่นามแฝงก่อน จากนั้นจึงจับคู่
ผู้ให้บริการที่กำหนดค่าไว้ซึ่งมีเพียงรายเดียวสำหรับรหัสโมเดลนั้น แล้วจึงย้อนกลับไปใช้
ผู้ให้บริการเริ่มต้นที่กำหนดค่าไว้ (เส้นทางความเข้ากันได้ที่เลิกแนะนำแล้ว) หาก
ผู้ให้บริการนั้นไม่มีโมเดลเริ่มต้นที่กำหนดค่าไว้อีกต่อไป OpenClaw จะย้อนกลับ
ไปใช้ผู้ให้บริการ/โมเดลแรกที่กำหนดค่าไว้แทนค่าเริ่มต้นที่ล้าสมัย
แนะนำโมเดลใด
ใช้โมเดลรุ่นล่าสุดที่มีประสิทธิภาพสูงสุดซึ่งสแต็กผู้ให้บริการรองรับ โดยเฉพาะสำหรับเอเจนต์ที่เปิดใช้เครื่องมือหรือรับอินพุตที่ไม่น่าเชื่อถือ — โมเดลที่ด้อยกว่า หรือถูกควอนไทซ์มากเกินไปจะเสี่ยงต่อการแทรกคำสั่งในพรอมต์และพฤติกรรมที่ไม่ปลอดภัย มากกว่า (ดู ความปลอดภัย) กำหนดเส้นทางโมเดลที่มีค่าใช้จ่ายต่ำกว่าให้กับ แชตทั่วไป/ความเสี่ยงต่ำตามบทบาทของเอเจนต์
กำหนดเส้นทางโมเดลแยกตามเอเจนต์และใช้เอเจนต์ย่อยเพื่อทำงานที่ใช้เวลานานแบบขนาน (เอเจนต์ย่อยแต่ละตัว ใช้โทเค็นของตนเอง) ดู โมเดล, เอเจนต์ย่อย, MiniMax และ โมเดลภายในเครื่อง
จะสลับโมเดลโดยไม่ล้างการกำหนดค่าได้อย่างไร
เปลี่ยนเฉพาะฟิลด์โมเดล — หลีกเลี่ยงการแทนที่การกำหนดค่าทั้งหมด
/modelในแชต (เฉพาะเซสชัน ดู คำสั่งแบบสแลช)openclaw models set ...(อัปเดตเฉพาะการกำหนดค่าโมเดล)openclaw configure --section model(แบบโต้ตอบ)- แก้ไข
agents.defaults.modelใน~/.openclaw/openclaw.jsonโดยตรง
สำหรับการแก้ไขผ่าน RPC ให้ตรวจสอบด้วย config.schema.lookup ก่อน (พาธที่ทำให้เป็นมาตรฐานแล้ว
เอกสารสคีมาแบบตื้น และข้อมูลสรุปขององค์ประกอบลูก) จากนั้นควรใช้ config.patch
แทน config.apply พร้อมออบเจ็กต์บางส่วน หากเขียนทับการกำหนดค่าไปแล้ว
ให้คืนค่าจากข้อมูลสำรองหรือเรียกใช้ openclaw doctor เพื่อซ่อมแซม
เอกสาร: โมเดล, กำหนดค่า, การกำหนดค่า, Doctor
ใช้โมเดลที่โฮสต์เอง (llama.cpp, vLLM, Ollama) ได้หรือไม่
ได้ — Ollama เป็นวิธีที่ง่ายที่สุด การตั้งค่าอย่างรวดเร็ว:
- ติดตั้ง Ollama จาก
https://ollama.com/download - ดึงโมเดลภายในเครื่อง เช่น
ollama pull gemma4 - สำหรับโมเดลบนคลาวด์ด้วย ให้เรียกใช้
ollama signin - เรียกใช้
openclaw onboardเลือกOllamaจากนั้นเลือกLocalหรือCloud + Local
Cloud + Local มอบทั้งโมเดลบนคลาวด์และโมเดล Ollama ภายในเครื่อง
โมเดลบนคลาวด์ เช่น kimi-k2.5:cloud ไม่จำเป็นต้องดึงลงมาในเครื่อง หากต้องการสลับ
ด้วยตนเอง: openclaw models list จากนั้น openclaw models set ollama/<model>
โมเดลขนาดเล็ก/ที่ถูกควอนไทซ์อย่างมากจะเสี่ยงต่อการแทรกคำสั่งในพรอมต์มากกว่า ใช้โมเดลขนาดใหญ่กับบอตทุกตัวที่เข้าถึงเครื่องมือได้ หากยังคงใช้โมเดลขนาดเล็ก ให้เปิดใช้แซนด์บ็อกซ์และรายการอนุญาตเครื่องมือที่เข้มงวด
เอกสาร: Ollama, โมเดลภายในเครื่อง, ผู้ให้บริการโมเดล, ความปลอดภัย, การใช้แซนด์บ็อกซ์
จะสลับโมเดลทันที (โดยไม่รีสตาร์ต) ได้อย่างไร
ส่ง /model <name> เป็นข้อความเดี่ยว ดู
คำสั่งแบบสแลช สำหรับ
รายการคำสั่งทั้งหมด รวมถึงตัวเลือกแบบมีหมายเลข (/model, /model list, /model 3), /model default สำหรับล้างค่าที่เขียนทับในเซสชัน และ
/model status สำหรับรายละเอียดเอนด์พอยต์/โหมด API
บังคับใช้โปรไฟล์การยืนยันตัวตนที่ระบุในแต่ละเซสชันด้วย @profile:
/model opus@anthropic:default/model opus@anthropic:workหากต้องการเลิกตรึงโปรไฟล์ที่ตั้งด้วย @profile ให้เรียกใช้ /model อีกครั้งโดยไม่มี
ส่วนต่อท้าย (เช่น /model anthropic/claude-opus-4-6) หรือเลือกค่าเริ่มต้นจาก
/model ใช้ /model status เพื่อยืนยันโปรไฟล์การยืนยันตัวตนที่ใช้งานอยู่
หากผู้ให้บริการสองรายมีรหัสโมเดลเดียวกัน /model จะใช้รายใด
/model provider/model จะเลือกเส้นทางของผู้ให้บริการนั้นอย่างเจาะจง ตัวอย่างเช่น
qianfan/deepseek-v4-flash และ deepseek/deepseek-v4-flash เป็นการอ้างอิงที่ต่างกัน
แม้ว่ารหัสโมเดลจะตรงกัน — OpenClaw จะไม่สลับ
ผู้ให้บริการโดยไม่แจ้งให้ทราบเมื่อจับคู่ด้วยรหัสเปล่า
การอ้างอิง /model ที่ผู้ใช้เลือกจะเข้มงวดสำหรับการสำรอง: หาก
ผู้ให้บริการ/โมเดลนั้นไม่พร้อมใช้งาน การตอบกลับจะล้มเหลวอย่างเห็นได้ชัดแทนที่จะ
สำรองไปใช้ agents.defaults.model.fallbacks สายโซ่สำรองที่กำหนดค่าไว้
ยังคงมีผลกับค่าเริ่มต้นที่กำหนดค่า งาน Cron หลัก และ
สถานะสำรองที่เลือกอัตโนมัติ เมื่ออนุญาตให้การเรียกใช้ที่ไม่ได้เขียนทับเฉพาะเซสชัน
ใช้การสำรอง OpenClaw จะลองผู้ให้บริการ/โมเดลที่ร้องขอก่อน จากนั้น
ลองรายการสำรองที่กำหนดค่าไว้ แล้วจึงลองรายการหลักที่กำหนดค่า — ดังนั้นรหัสโมเดลเปล่า
ที่ซ้ำกันจะไม่ข้ามกลับไปยังผู้ให้บริการเริ่มต้นโดยตรง
ดู โมเดล และ การสลับโมเดลเมื่อขัดข้อง
ใช้ GPT 5.5 สำหรับงานประจำวันและ Codex 5.5 สำหรับการเขียนโค้ดได้หรือไม่
ได้ — การเลือกโมเดลและการเลือกรันไทม์แยกจากกัน:
- เอเจนต์เขียนโค้ด Codex แบบเนทีฟ: ตั้งค่า
agents.defaults.model.primaryเป็นopenai/gpt-5.5ลงชื่อเข้าใช้ด้วยopenclaw models auth login --provider openaiสำหรับการยืนยันตัวตนด้วยการสมัครสมาชิก ChatGPT/Codex - งาน OpenAI API โดยตรงนอกลูปของเอเจนต์: กำหนดค่า
OPENAI_API_KEYสำหรับรูปภาพ เอ็มเบดดิง เสียง เรียลไทม์ และ พื้นผิว OpenAI API อื่นที่ไม่ใช่เอเจนต์ - การยืนยันตัวตนด้วยคีย์ API ของเอเจนต์ OpenAI:
/model openai/gpt-5.5พร้อมโปรไฟล์ คีย์ APIopenaiที่เรียงลำดับแล้ว - เอเจนต์ย่อย: กำหนดเส้นทางงานเขียนโค้ดไปยังเอเจนต์ที่เน้น Codex พร้อม
โมเดล
openai/gpt-5.5ของตนเอง
ดู โมเดล และ คำสั่งแบบสแลช
จะกำหนดค่าโหมดเร็วสำหรับ GPT 5.5 ได้อย่างไร
- ต่อเซสชัน: ส่ง
/fast onขณะใช้openai/gpt-5.5 - ค่าเริ่มต้นต่อโมเดล: ตั้งค่า
agents.defaults.models["openai/gpt-5.5"].params.fastModeเป็นtrue - จุดตัดอัตโนมัติ:
/fast autoหรือparams.fastMode: "auto"จะเรียก โมเดลใหม่ในโหมดเร็วจนถึงจุดตัด จากนั้นการลองใหม่ การสำรอง ผลลัพธ์เครื่องมือ หรือการเรียกต่อเนื่องภายหลังจะทำงานโดยไม่มีโหมดเร็ว จุดตัดมีค่าเริ่มต้นที่ 60 วินาที เขียนทับได้ด้วยparams.fastAutoOnSecondsในโมเดล
{ agents: { defaults: { models: { "openai/gpt-5.5": { params: { fastMode: "auto", fastAutoOnSeconds: 30, }, }, }, }, },}โหมดเร็วจะแมปไปยัง service_tier = "priority" ในคำขอ OpenAI Responses แบบเนทีฟ
ค่า service_tier ที่มีอยู่จะยังคงเดิม และโหมดเร็วจะไม่
เขียน reasoning หรือ text.verbosity ใหม่ ค่าที่เขียนทับด้วย /fast ในเซสชันมีลำดับความสำคัญเหนือ
ค่าเริ่มต้นในการกำหนดค่า
ดู การคิดและโหมดเร็ว และส่วนโหมดเร็ว ภายใต้การกำหนดค่าขั้นสูงในหน้า ผู้ให้บริการ OpenAI
เหตุใดจึงเห็น "Model ... is not allowed" แล้วไม่มีการตอบกลับ
หาก agents.defaults.modelPolicy.allow ไม่ว่าง ค่านี้จะกลายเป็น
รายการอนุญาต สำหรับ /model ค่าที่เขียนทับในเซสชัน และ --model การเลือกโมเดลนอกเหนือจากรายการนั้นจะส่งคืน
ข้อความนี้แทนการตอบกลับตามปกติ:
Model override "provider/model" is not allowed by agents.defaults.modelPolicy.allow.วิธีแก้: เพิ่มโมเดลที่ตรงกันทุกประการหรือไวลด์การ์ดของผู้ให้บริการ เช่น "provider/*" ลงใน
รายการ modelPolicy.allow ที่ระบุ ลบ/ทำให้รายการนั้นว่าง หรือเลือกโมเดล
จาก /model list หากคำสั่งมี
--runtime codex ด้วย ให้อัปเดตรายการอนุญาตก่อน แล้วลองใช้
คำสั่ง /model provider/model --runtime codex เดิมอีกครั้ง
เหตุใดจึงเห็น "Unknown model: minimax/MiniMax-M3"
หากใช้ OpenClaw รุ่นเก่า ให้อัปเกรดก่อน (หรือเรียกใช้จากซอร์ส
main) และรีสตาร์ต Gateway — MiniMax-M3 อาจยังไม่อยู่ใน
แค็ตตาล็อกของรุ่นที่ติดตั้ง มิฉะนั้นแสดงว่ายังไม่ได้กำหนดค่าผู้ให้บริการ MiniMax
(ไม่พบรายการผู้ให้บริการหรือโปรไฟล์การยืนยันตัวตน) จึงไม่สามารถ
แก้ไขการอ้างอิงโมเดลได้ ดูส่วนการแก้ไขปัญหาในหน้า
ผู้ให้บริการ MiniMax สำหรับรายการตรวจสอบวิธีแก้ไขทั้งหมด
ตารางรหัสผู้ให้บริการ/โมเดล และตัวอย่างบล็อกการกำหนดค่า
ใช้ MiniMax เป็นค่าเริ่มต้นและ OpenAI สำหรับงานซับซ้อนได้หรือไม่
ได้ ใช้ MiniMax เป็นค่าเริ่มต้นและสลับโมเดลในแต่ละเซสชัน — การสำรอง
มีไว้สำหรับข้อผิดพลาด ไม่ใช่ "งานยาก" ดังนั้นให้ใช้ /model หรือเอเจนต์แยกต่างหาก
ตัวเลือก A: สลับต่อเซสชัน
{ env: { MINIMAX_API_KEY: "sk-...", OPENAI_API_KEY: "sk-..." }, agents: { defaults: { model: { primary: "minimax/MiniMax-M3" }, models: { "minimax/MiniMax-M3": { alias: "minimax" }, "openai/gpt-5.5": { alias: "gpt" }, }, }, },}จากนั้นใช้ /model gpt
ตัวเลือก B: แยกเอเจนต์ — เอเจนต์ A ใช้ MiniMax เป็นค่าเริ่มต้น ส่วนเอเจนต์ B
ใช้ OpenAI เป็นค่าเริ่มต้น กำหนดเส้นทางตามเอเจนต์หรือใช้ /agent เพื่อสลับ
เอกสาร: โมเดล, การกำหนดเส้นทางหลายเอเจนต์, MiniMax, OpenAI
opus / sonnet / gpt เป็นทางลัดในตัวหรือไม่
ใช่ — เป็นชื่อย่อในตัว ซึ่งจะใช้เฉพาะเมื่อมีโมเดลเป้าหมายอยู่ใน
agents.defaults.models:
| นามแฝง | แปลงเป็น |
|---|---|
opus |
anthropic/claude-opus-4-8 |
sonnet |
anthropic/claude-sonnet-4-6 |
gpt |
openai/gpt-5.4 |
gpt-mini |
openai/gpt-5.4-mini |
gpt-nano |
openai/gpt-5.4-nano |
gemini |
google/gemini-3.1-pro-preview |
gemini-flash |
google/gemini-3-flash-preview |
gemini-flash-lite |
google/gemini-3.1-flash-lite |
นามแฝงที่กำหนดเองซึ่งใช้ชื่อเดียวกันจะแทนที่นามแฝงในตัว
จะกำหนด/เขียนทับทางลัดของโมเดล (นามแฝง) ได้อย่างไร
นามแฝงอยู่ที่ agents.defaults.models.<modelId>.alias:
{ agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" }, models: { "anthropic/claude-opus-4-6": { alias: "opus" }, "anthropic/claude-sonnet-4-6": { alias: "sonnet" }, }, }, },}จากนั้น /model sonnet (หรือ /<alias> เมื่อรองรับ) จะแปลงเป็น
รหัสโมเดลนั้น
จะเพิ่มโมเดลจากผู้ให้บริการรายอื่น เช่น OpenRouter หรือ Z.AI ได้อย่างไร
OpenRouter (ชำระตามจำนวนโทเค็น มีหลายโมเดล):
{ agents: { defaults: { model: { primary: "openrouter/anthropic/claude-sonnet-4-6" }, models: { "openrouter/anthropic/claude-sonnet-4-6": {} }, }, }, env: { OPENROUTER_API_KEY: "sk-or-..." },}Z.AI (โมเดล GLM):
{ agents: { defaults: { model: { primary: "zai/glm-5.1" }, models: { "zai/glm-5.1": {} }, }, }, env: { ZAI_API_KEY: "..." },}การไม่มีคีย์ผู้ให้บริการสำหรับผู้ให้บริการ/โมเดลที่อ้างอิงจะทำให้เกิดข้อผิดพลาด
การยืนยันตัวตนขณะรันไทม์ (เช่น No API key found for provider "zai")
ไม่พบคีย์ API สำหรับผู้ให้บริการหลังจากเพิ่มเอเจนต์ใหม่
เอเจนต์ใหม่มีที่เก็บข้อมูลการยืนยันตัวตนว่างเปล่า — การยืนยันตัวตนแยกตามเอเจนต์และจัดเก็บไว้ที่:
~/.openclaw/agents/<agentId>/agent/auth-profiles.jsonการแก้ไข: เรียกใช้ openclaw agents add <id> และกำหนดค่าการยืนยันตัวตนในตัวช่วยสร้าง หรือ
คัดลอกเฉพาะโปรไฟล์ api_key/token แบบคงที่ที่เคลื่อนย้ายได้จากพื้นที่จัดเก็บของ
เอเจนต์หลัก สำหรับ OAuth ให้ลงชื่อเข้าใช้จากเอเจนต์ใหม่เมื่อเอเจนต์นั้นต้องใช้
บัญชีของตนเอง ดูกฎทั้งหมดเกี่ยวกับการนำ agentDir กลับมาใช้และการแชร์ข้อมูลประจำตัวได้ที่
การกำหนดเส้นทางแบบหลายเอเจนต์ — ห้ามนำ
agentDir ไปใช้ซ้ำระหว่างเอเจนต์
การสลับโมเดลเมื่อขัดข้องและ "โมเดลทั้งหมดล้มเหลว"
การสลับเมื่อขัดข้องทำงานอย่างไร
มีสองขั้นตอน:
- การหมุนเวียนโปรไฟล์การยืนยันตัวตน ภายในผู้ให้บริการเดียวกัน
- การใช้โมเดลสำรอง โดยเปลี่ยนไปใช้โมเดลถัดไปใน
agents.defaults.model.fallbacks
โปรไฟล์ที่ล้มเหลวจะถูกพักการใช้งานชั่วคราว (เพิ่มระยะเวลาแบบเอ็กซ์โพเนนเชียล) ทำให้ OpenClaw ยังคงตอบสนองได้เมื่อผู้ให้บริการจำกัดอัตราการใช้งานหรือขัดข้องชั่วคราว
กลุ่มการจำกัดอัตราครอบคลุมมากกว่าเพียง 429: Too many concurrent requests, ThrottlingException, concurrency limit reached, workers_ai ... quota limit exceeded, resource exhausted และขีดจำกัด
หน้าต่างการใช้งานตามรอบ (weekly/monthly limit reached) ล้วนถือเป็น
การจำกัดอัตราที่สมควรสลับไปใช้ตัวเลือกสำรอง
การตอบกลับเกี่ยวกับการเรียกเก็บเงินไม่ได้เป็น 402 เสมอไป และ 402 บางรายการยังคงอยู่ใน
กลุ่มข้อผิดพลาดชั่วคราว/การจำกัดอัตราแทนที่จะอยู่ในกลุ่มการเรียกเก็บเงิน ข้อความ
การเรียกเก็บเงินที่ระบุชัดเจนใน 401/403 ยังสามารถจัดเส้นทางไปยังกลุ่มการเรียกเก็บเงินได้ ส่วนตัวจับคู่
ข้อความเฉพาะผู้ให้บริการ (เช่น Key limit exceeded ของ OpenRouter) จะจำกัดขอบเขตไว้ที่
ผู้ให้บริการของตนเอง 402 ที่มีลักษณะเป็นขีดจำกัดหน้าต่างการใช้งานที่ลองใหม่ได้หรือ
ขีดจำกัดค่าใช้จ่ายขององค์กร/พื้นที่ทำงาน (daily limit reached, resets tomorrow,
organization spending limit exceeded) จะถือเป็น rate_limit ไม่ใช่
การปิดใช้งานระยะยาวเนื่องจากการเรียกเก็บเงิน
ข้อผิดพลาดจากบริบทล้นจะไม่เข้าสู่เส้นทางการใช้ตัวเลือกสำรองโดยสิ้นเชิง — รูปแบบ
เช่น request_too_large, input exceeds the maximum number of tokens,
input token count exceeds the maximum number of input tokens, input is too long for the model หรือ ollama error: context length exceeded จะไปยัง
Compaction/การลองใหม่ แทนการเปลี่ยนไปใช้โมเดลสำรองถัดไป
ขอบเขตของข้อความข้อผิดพลาดเซิร์ฟเวอร์ทั่วไปแคบกว่า "ทุกข้อความที่มี unknown/error
อยู่ภายใน" รูปแบบข้อผิดพลาดชั่วคราวเฉพาะผู้ให้บริการที่นับเป็นสัญญาณให้สลับไปใช้ตัวเลือกสำรอง ได้แก่ An unknown error occurred เปล่าของ Anthropic, Provider returned error เปล่าของ
OpenRouter, ข้อผิดพลาดเหตุผลการหยุด เช่น Unhandled stop reason: error, เพย์โหลด JSON api_error ที่มีข้อความเซิร์ฟเวอร์ชั่วคราว (internal server error, unknown error, 520, upstream error, backend error)
และข้อผิดพลาดผู้ให้บริการไม่ว่าง เช่น ModelNotReadyException เมื่อบริบทของผู้ให้บริการ
ตรงกัน ข้อความสำรองภายในทั่วไป เช่น LLM request failed with an unknown error. จะได้รับการจัดการอย่างระมัดระวังและไม่เรียกใช้การสลับไปยังตัวเลือกสำรอง
ด้วยตัวเอง
ข้อความ "No credentials found for profile anthropic:default" หมายความว่าอย่างไร
รหัสโปรไฟล์การยืนยันตัวตน anthropic:default ไม่มีข้อมูลประจำตัวใน
พื้นที่จัดเก็บการยืนยันตัวตนที่คาดไว้
รายการตรวจสอบเพื่อแก้ไข:
- ยืนยันตำแหน่งของโปรไฟล์ — ตำแหน่งปัจจุบัน:
~/.openclaw/agents/<agentId>/agent/auth-profiles.json; ตำแหน่งเดิม:~/.openclaw/agent/*(ย้ายโดยopenclaw doctor) - ยืนยันว่า Gateway โหลดตัวแปรสภาพแวดล้อมของคุณ
ANTHROPIC_API_KEYที่ตั้งค่าไว้เฉพาะใน เชลล์ของคุณจะไม่ส่งไปถึง Gateway ที่ทำงานผ่าน systemd/launchd — ให้ใส่ไว้ใน~/.openclaw/.envหรือเปิดใช้env.shellEnv - ยืนยันว่าคุณกำลังแก้ไขเอเจนต์ที่ถูกต้อง — การตั้งค่าแบบหลายเอเจนต์มี
ไฟล์
auth-profiles.jsonหลายไฟล์ - เรียกใช้
openclaw models statusเพื่อดูโมเดลที่กำหนดค่าไว้และสถานะ การยืนยันตัวตนของผู้ให้บริการ
สำหรับ "No credentials found for profile anthropic" (ไม่มีส่วนต่อท้ายอีเมล):
การทำงานถูกตรึงไว้กับโปรไฟล์ Anthropic ที่ Gateway หาไม่พบ
-
ใช้ Claude CLI: เรียกใช้
openclaw models auth login --provider anthropic --method cli --set-defaultบนโฮสต์ Gateway -
หากต้องการใช้คีย์ API แทน: ใส่
ANTHROPIC_API_KEYใน~/.openclaw/.envบนโฮสต์ Gateway จากนั้นล้างลำดับที่ตรึงไว้ซึ่ง บังคับให้ใช้โปรไฟล์ที่ไม่มีอยู่:bash openclaw models auth order clear --provider anthropic -
โหมดระยะไกล: โปรไฟล์การยืนยันตัวตนอยู่บนเครื่อง Gateway ไม่ใช่ แล็ปท็อปของคุณ — ยืนยันว่าคุณกำลังเรียกใช้คำสั่งบนเครื่องนั้น
เหตุใดระบบจึงลองใช้ Google Gemini แล้วล้มเหลวด้วย
หากการกำหนดค่าโมเดลของคุณมี Google Gemini เป็นตัวเลือกสำรอง (หรือคุณ
เปลี่ยนไปใช้ชื่อย่อของ Gemini) OpenClaw จะลองใช้โมเดลดังกล่าวระหว่างการสลับไปใช้ตัวเลือกสำรอง หากไม่ได้
กำหนดค่าข้อมูลประจำตัวของ Google จะได้รับ No API key found for provider "google" วิธีแก้ไข: เพิ่มการยืนยันตัวตนของ Google หรือนำโมเดล Google ออกจาก
agents.defaults.model.fallbacks/นามแฝง
คำขอ LLM ถูกปฏิเสธ: ต้องมีลายเซ็นการคิด (Google Antigravity)
สาเหตุ: ประวัติเซสชันมีบล็อกการคิดที่ไม่มีลายเซ็น (มักเกิดจาก
สตรีมที่ถูกยกเลิก/ไม่สมบูรณ์) Google Antigravity กำหนดให้บล็อกการคิด
ต้องมีลายเซ็น OpenClaw จะนำบล็อกการคิดที่ไม่มีลายเซ็นออกสำหรับ Google
Antigravity Claude หากยังพบปัญหา ให้เริ่มเซสชันใหม่หรือตั้งค่า
/thinking off สำหรับเอเจนต์นั้น
โปรไฟล์การยืนยันตัวตน: คืออะไรและจัดการอย่างไร
เนื้อหาที่เกี่ยวข้อง: /concepts/oauth (ขั้นตอน OAuth, การจัดเก็บโทเค็น, รูปแบบการใช้หลายบัญชี)
โปรไฟล์การยืนยันตัวตนคืออะไร
ระเบียนข้อมูลประจำตัวที่มีชื่อ (OAuth หรือคีย์ API) ซึ่งเชื่อมโยงกับผู้ให้บริการและจัดเก็บ ไว้ที่:
~/.openclaw/agents/<agentId>/agent/auth-profiles.jsonตรวจสอบโปรไฟล์ที่บันทึกไว้โดยไม่แสดงข้อมูลลับ: openclaw models auth list (เลือกใช้ --provider <id> หรือ --json เพิ่มเติมได้) ดู
CLI สำหรับโมเดล
รหัสโปรไฟล์ทั่วไปมีรูปแบบใด
มีคำนำหน้าเป็นผู้ให้บริการ: anthropic:default (ใช้ทั่วไปเมื่อไม่มีข้อมูลระบุตัวตนจากอีเมล),
anthropic:<email> สำหรับข้อมูลระบุตัวตน OAuth หรือรหัสแบบกำหนดเองที่คุณ
เลือก (เช่น anthropic:work)
ฉันควบคุมได้หรือไม่ว่าจะลองใช้โปรไฟล์การยืนยันตัวตนใดก่อน
ได้ การกำหนดค่า auth.order.<provider> จะกำหนดลำดับการหมุนเวียนแยกตามผู้ให้บริการ
(เฉพาะข้อมูลเมตา — ไม่มีการจัดเก็บข้อมูลลับ)
OpenClaw อาจข้ามโปรไฟล์ที่อยู่ในช่วง พักการใช้งานชั่วคราว ระยะสั้น (การจำกัดอัตรา,
หมดเวลา, การยืนยันตัวตนล้มเหลว) หรือสถานะ ปิดใช้งาน ระยะยาว
(การเรียกเก็บเงิน/เครดิตไม่เพียงพอ) ตรวจสอบด้วย openclaw models status --json และดู auth.unusableProfiles ช่วงพักการใช้งานจากการจำกัดอัตราอาจ
จำกัดเฉพาะโมเดล — โปรไฟล์ที่พักการใช้งานสำหรับโมเดลหนึ่งยังสามารถให้บริการ
โมเดลอื่นของผู้ให้บริการเดียวกันได้ แต่ช่วงการเรียกเก็บเงิน/การปิดใช้งานจะบล็อก
ทั้งโปรไฟล์
ตั้งค่าลำดับแทนที่แยกตามเอเจนต์ (จัดเก็บใน auth-state.json ของเอเจนต์นั้น):
# ค่าเริ่มต้นคือเอเจนต์เริ่มต้นที่กำหนดค่าไว้ (ละ --agent)openclaw models auth order get --provider anthropic # ล็อกการหมุนเวียนไว้ที่โปรไฟล์เดียวopenclaw models auth order set --provider anthropic anthropic:default # หรือตั้งลำดับอย่างชัดเจน (ใช้ตัวเลือกสำรองภายในผู้ให้บริการ)openclaw models auth order set --provider anthropic anthropic:work anthropic:default # ล้างค่าที่แทนที่ (กลับไปใช้ config auth.order / การหมุนเวียนแบบรอบ)openclaw models auth order clear --provider anthropic # ระบุเอเจนต์ที่ต้องการopenclaw models auth order set --provider anthropic --agent main anthropic:defaultตรวจสอบรายการที่จะถูกลองใช้จริง: openclaw models status --probe โปรไฟล์
ที่จัดเก็บไว้แต่ไม่รวมอยู่ในลำดับที่กำหนดอย่างชัดเจนจะแสดง
excluded_by_auth_order แทนการถูกลองใช้อย่างเงียบ ๆ
OAuth กับคีย์ API แตกต่างกันอย่างไร
- OAuth / การเข้าสู่ระบบผ่าน CLI มักใช้สิทธิ์การเข้าถึงจากการสมัครสมาชิกในกรณีที่
ผู้ให้บริการรองรับ สำหรับ Anthropic แบ็กเอนด์ Claude CLI ของ OpenClaw
ใช้
claude -pของ Claude Code ซึ่งปัจจุบัน Anthropic ถือว่าเป็น การใช้งาน Agent SDK/แบบโปรแกรมที่หักจากขีดจำกัดการใช้งานของการสมัครสมาชิก — ดูสถานะการหยุดเรียกเก็บเงินชั่วคราวในปัจจุบันและลิงก์แหล่งข้อมูลได้ที่ Anthropic - คีย์ API ใช้การเรียกเก็บเงินตามจำนวนโทเค็น
ตัวช่วยสร้างรองรับ Anthropic Claude CLI, OpenAI Codex OAuth และคีย์ API