คำถามที่พบบ่อย: โมเดลและการตรวจสอบสิทธิ์

โมเดลเริ่มต้นของ OpenClaw คือสิ่งที่คุณตั้งค่าไว้เป็น:

agents.defaults.model.primary

โมเดลจะถูกอ้างอิงเป็น provider/model (ตัวอย่าง: openai/gpt-5.5 หรือ anthropic/claude-sonnet-4-6) หากคุณละเว้นผู้ให้บริการ OpenClaw จะลองใช้ alias ก่อน จากนั้นจึงลองจับคู่ผู้ให้บริการที่กำหนดค่าไว้แบบไม่ซ้ำสำหรับ id โมเดลนั้นแบบตรงตัว และหลังจากนั้นจึงย้อนกลับไปใช้ผู้ให้บริการเริ่มต้นที่กำหนดค่าไว้ในฐานะเส้นทางความเข้ากันได้ที่เลิกใช้แล้วเท่านั้น หากผู้ให้บริการนั้นไม่เปิดเผยโมเดลเริ่มต้นที่กำหนดค่าไว้อีกต่อไป OpenClaw จะย้อนกลับไปใช้ผู้ให้บริการ/โมเดลแรกที่กำหนดค่าไว้แทนที่จะแสดงค่าเริ่มต้นของผู้ให้บริการที่ถูกลบซึ่งล้าสมัยแล้ว คุณยังควรตั้งค่า provider/model อย่างชัดเจน

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

MiniMax มีเอกสารของตัวเอง: MiniMax และ โมเดลภายในเครื่อง

หลักคร่าว ๆ: ใช้ โมเดลที่ดีที่สุดที่คุณจ่ายไหว สำหรับงานที่มีความเสี่ยงสูง และใช้โมเดลที่ถูกกว่า สำหรับแชททั่วไปหรือการสรุป คุณสามารถกำหนดเส้นทางโมเดลต่อเอเจนต์และใช้เอเจนต์ย่อยเพื่อ ทำงานยาว ๆ แบบขนานได้ (เอเจนต์ย่อยแต่ละตัวใช้โทเค็น) ดู โมเดล และ เอเจนต์ย่อย

คำเตือนสำคัญ: โมเดลที่อ่อนกว่าหรือถูกควอนไทซ์มากเกินไปเสี่ยงต่อ prompt injection และพฤติกรรมที่ไม่ปลอดภัยมากกว่า ดู ความปลอดภัย

บริบทเพิ่มเติม: โมเดล

ใช้ คำสั่งโมเดล หรือแก้ไขเฉพาะฟิลด์ model หลีกเลี่ยงการแทนที่ config ทั้งหมด

ตัวเลือกที่ปลอดภัย:

• /model ในแชท (รวดเร็ว ต่อเซสชัน)
• openclaw models set ... (อัปเดตเฉพาะ config โมเดล)
• openclaw configure --section model (โต้ตอบได้)
• แก้ไข agents.defaults.model ใน ~/.openclaw/openclaw.json

หลีกเลี่ยง config.apply กับอ็อบเจกต์บางส่วน เว้นแต่คุณตั้งใจจะแทนที่ config ทั้งหมด สำหรับการแก้ไขผ่าน RPC ให้ตรวจสอบด้วย config.schema.lookup ก่อนและควรใช้ config.patch payload การ lookup จะให้ path ที่ normalize แล้ว เอกสาร/ข้อจำกัดของ schema แบบตื้น และสรุปลูกโดยตรง สำหรับการอัปเดตบางส่วน หากคุณเขียนทับ config ไปแล้ว ให้กู้คืนจากข้อมูลสำรองหรือรัน openclaw doctor อีกครั้งเพื่อซ่อมแซม

เอกสาร: โมเดล, กำหนดค่า, Config, Doctor

ได้ Ollama เป็นเส้นทางที่ง่ายที่สุดสำหรับโมเดลภายในเครื่อง

การตั้งค่าที่เร็วที่สุด:

1. ติดตั้ง Ollama จาก https://ollama.com/download
2. ดึงโมเดลภายในเครื่อง เช่น ollama pull gemma4
3. หากคุณต้องการโมเดลคลาวด์ด้วย ให้รัน ollama signin
4. รัน openclaw onboard และเลือก Ollama
5. เลือก Local หรือ Cloud + Local

หมายเหตุ:

• Cloud + Local ให้ทั้งโมเดลคลาวด์และโมเดล Ollama ภายในเครื่องของคุณ
• โมเดลคลาวด์ เช่น kimi-k2.5:cloud ไม่จำเป็นต้องดึงมาไว้ในเครื่อง
• สำหรับการสลับด้วยตนเอง ให้ใช้ openclaw models list และ openclaw models set ollama/<model>

หมายเหตุด้านความปลอดภัย: โมเดลที่เล็กกว่าหรือถูกควอนไทซ์อย่างหนักเสี่ยงต่อ prompt injection มากกว่า เราแนะนำอย่างยิ่งให้ใช้ โมเดลขนาดใหญ่ สำหรับบอตใด ๆ ที่สามารถใช้เครื่องมือได้ หากคุณยังต้องการใช้โมเดลขนาดเล็ก ให้เปิดใช้ sandboxing และ allowlist เครื่องมือแบบเข้มงวด

เอกสาร: Ollama, โมเดลภายในเครื่อง, ผู้ให้บริการโมเดล, ความปลอดภัย, Sandboxing

• การดีพลอยเหล่านี้อาจแตกต่างกันและอาจเปลี่ยนแปลงได้ตามเวลา ไม่มีคำแนะนำผู้ให้บริการแบบตายตัว
• ตรวจสอบการตั้งค่ารันไทม์ปัจจุบันในแต่ละ Gateway ด้วย openclaw models status
• สำหรับเอเจนต์ที่ไวต่อความปลอดภัย/เปิดใช้เครื่องมือ ให้ใช้โมเดลรุ่นล่าสุดที่ทรงพลังที่สุดซึ่งมีอยู่

ใช้คำสั่ง /model เป็นข้อความเดี่ยว:

/model sonnet/model opus/model gpt/model gpt-mini/model gemini/model gemini-flash/model gemini-flash-lite

รายการเหล่านี้คือ alias ในตัว สามารถเพิ่ม alias แบบกำหนดเองผ่าน agents.defaults.models ได้

คุณสามารถแสดงรายการโมเดลที่ใช้ได้ด้วย /model, /model list หรือ /model status

/model (และ /model list) แสดงตัวเลือกแบบกระชับพร้อมหมายเลข เลือกด้วยหมายเลข:

/model 3

คุณยังสามารถบังคับใช้โปรไฟล์การยืนยันตัวตนเฉพาะสำหรับผู้ให้บริการได้ (ต่อเซสชัน):

/model opus@anthropic:default/model opus@anthropic:work

เคล็ดลับ: /model status แสดงว่าเอเจนต์ใด active อยู่ ไฟล์ auth-profiles.json ใดกำลังถูกใช้ และโปรไฟล์การยืนยันตัวตนใดจะถูกลองถัดไป นอกจากนี้ยังแสดง endpoint ของผู้ให้บริการที่กำหนดค่าไว้ (baseUrl) และโหมด API (api) เมื่อมี

ฉันจะยกเลิกการปักหมุดโปรไฟล์ที่ตั้งด้วย @profile ได้อย่างไร?

รัน /model อีกครั้ง โดยไม่มี suffix @profile:

/model anthropic/claude-opus-4-6

หากคุณต้องการกลับไปใช้ค่าเริ่มต้น ให้เลือกจาก /model (หรือส่ง /model <default provider/model>) ใช้ /model status เพื่อยืนยันว่าโปรไฟล์การยืนยันตัวตนใด active อยู่

/model provider/model จะเลือกเส้นทางผู้ให้บริการนั้นแบบตรงตัวสำหรับเซสชัน

ตัวอย่างเช่น qianfan/deepseek-v4-flash และ deepseek/deepseek-v4-flash เป็น model ref คนละตัวกัน แม้ว่าทั้งคู่จะมี deepseek-v4-flash อยู่ก็ตาม OpenClaw ไม่ควรสลับจากผู้ให้บริการหนึ่งไปยังอีกรายแบบเงียบ ๆ เพียงเพราะ id โมเดลแบบเปล่าตรงกัน

ref ของ /model ที่ผู้ใช้เลือกยังเข้มงวดสำหรับนโยบาย fallback ด้วย หากผู้ให้บริการ/โมเดลที่เลือกนั้นไม่พร้อมใช้งาน การตอบกลับจะล้มเหลวให้เห็นชัด แทนที่จะตอบจาก agents.defaults.model.fallbacks เชน fallback ที่กำหนดค่าไว้ยังคงใช้กับค่าเริ่มต้นที่กำหนดค่าไว้ primary ของงาน cron และสถานะ fallback ที่เลือกอัตโนมัติ

หากการรันที่เริ่มจาก override ที่ไม่ใช่เซสชันได้รับอนุญาตให้ใช้ fallback ได้ OpenClaw จะลองผู้ให้บริการ/โมเดลที่ร้องขอก่อน จากนั้นลอง fallback ที่กำหนดค่าไว้ และหลังจากนั้นจึงลอง primary ที่กำหนดค่าไว้ วิธีนี้ป้องกันไม่ให้ id โมเดลแบบเปล่าที่ซ้ำกันกระโดดกลับไปยังผู้ให้บริการเริ่มต้นโดยตรง

ดู โมเดล และ Model failover

ได้ ให้แยกการเลือกโมเดลออกจากการเลือกรันไทม์:

• เอเจนต์เขียนโค้ด Codex แบบเนทีฟ: ตั้ง agents.defaults.model.primary เป็น openai/gpt-5.5 ลงชื่อเข้าใช้ด้วย openclaw models auth login --provider openai-codex เมื่อคุณต้องการการยืนยันตัวตนด้วยการสมัครสมาชิก ChatGPT/Codex
• งาน Direct OpenAI API นอกลูปเอเจนต์: กำหนดค่า OPENAI_API_KEY สำหรับรูปภาพ embeddings เสียง realtime และพื้นผิว OpenAI API อื่น ๆ ที่ไม่ใช่เอเจนต์
• การยืนยันตัวตนด้วย API key สำหรับเอเจนต์ OpenAI: ใช้ /model openai/gpt-5.5 กับโปรไฟล์ API key ของ openai-codex แบบมีลำดับ
• เอเจนต์ย่อย: กำหนดเส้นทางงานเขียนโค้ดไปยังเอเจนต์ที่เน้น Codex ซึ่งมีโมเดล openai/gpt-5.5 ของตัวเอง

ดู โมเดล และ คำสั่ง Slash

ใช้ได้ทั้ง toggle ต่อเซสชันหรือค่าเริ่มต้นใน config:

• ต่อเซสชัน: ส่ง /fast on ขณะที่เซสชันใช้ openai/gpt-5.5
• ค่าเริ่มต้นต่อโมเดล: ตั้ง agents.defaults.models["openai/gpt-5.5"].params.fastMode เป็น true

ตัวอย่าง:

{  agents: {    defaults: {      models: {        "openai/gpt-5.5": {          params: {            fastMode: true,          },        },      },    },  },}

สำหรับ OpenAI โหมดเร็วจะ map เป็น service_tier = "priority" บนคำขอ Responses แบบเนทีฟที่รองรับ override /fast ของเซสชันจะมีผลเหนือค่าเริ่มต้นใน config

ดู การคิดและโหมดเร็ว และ โหมดเร็วของ OpenAI

หากตั้งค่า agents.defaults.models ไว้ รายการนั้นจะกลายเป็น allowlist สำหรับ /model และ override ใด ๆ ของเซสชัน การเลือกโมเดลที่ไม่อยู่ในรายการนั้นจะส่งคืน:

Model "provider/model" is not allowed. Use /models to list providers, or /models <provider> to list models.Add it with: openclaw config set agents.defaults.models '{"provider/model":{}}' --strict-json --merge

ข้อผิดพลาดนั้นจะถูกส่งคืน แทนที่ การตอบกลับปกติ วิธีแก้: เพิ่มโมเดลแบบตรงตัวลงใน agents.defaults.models, เพิ่ม wildcard ของผู้ให้บริการ เช่น "provider/*": {} สำหรับแค็ตตาล็อกผู้ให้บริการแบบไดนามิก ลบ allowlist หรือเลือกโมเดลจาก /model list หากคำสั่งนั้นมี --runtime codex ด้วย ให้อัปเดต allowlist ก่อนแล้วลองคำสั่ง /model provider/model --runtime codex เดิมอีกครั้ง

หมายความว่า ยังไม่ได้กำหนดค่าผู้ให้บริการ (ไม่พบ config ผู้ให้บริการ MiniMax หรือโปรไฟล์การยืนยันตัวตน) จึง resolve โมเดลไม่ได้

checklist สำหรับการแก้ไข:

1. อัปเกรดเป็น OpenClaw รุ่นปัจจุบัน (หรือรันจากซอร์ส main) แล้วรีสตาร์ท Gateway

2. ตรวจสอบว่า MiniMax ถูกกำหนดค่าแล้ว (wizard หรือ JSON) หรือมีการยืนยันตัวตนของ MiniMax อยู่ใน env/โปรไฟล์การยืนยันตัวตน เพื่อให้สามารถ inject ผู้ให้บริการที่ตรงกันได้ (MINIMAX_API_KEY สำหรับ minimax, MINIMAX_OAUTH_TOKEN หรือ OAuth ของ MiniMax ที่จัดเก็บไว้สำหรับ minimax-portal)

3. ใช้ id โมเดลแบบตรงตัว (คำนึงถึงตัวพิมพ์เล็ก/ใหญ่) สำหรับเส้นทางการยืนยันตัวตนของคุณ: minimax/MiniMax-M2.7 หรือ minimax/MiniMax-M2.7-highspeed สำหรับการตั้งค่า API key หรือ minimax-portal/MiniMax-M2.7 / minimax-portal/MiniMax-M2.7-highspeed สำหรับการตั้งค่า OAuth

4. รัน:

   openclaw models list

   แล้วเลือกจากรายการ (หรือ /model list ในแชท)

ดู MiniMax และ โมเดล

ได้ ใช้ MiniMax เป็นค่าเริ่มต้น และสลับโมเดล ต่อเซสชัน เมื่อจำเป็น fallback มีไว้สำหรับ ข้อผิดพลาด ไม่ใช่ "งานยาก" ดังนั้นให้ใช้ /model หรือเอเจนต์แยกต่างหาก

ตัวเลือก A: สลับต่อเซสชัน

{  env: { MINIMAX_API_KEY: "sk-...", OPENAI_API_KEY: "sk-..." },  agents: {    defaults: {      model: { primary: "minimax/MiniMax-M2.7" },      models: {        "minimax/MiniMax-M2.7": { alias: "minimax" },        "openai/gpt-5.5": { alias: "gpt" },      },    },  },}

จากนั้น:

/model gpt

ตัวเลือก B: เอเจนต์แยกต่างหาก

• ค่าเริ่มต้นของเอเจนต์ A: MiniMax
• ค่าเริ่มต้นของเอเจนต์ B: OpenAI
• กำหนดเส้นทางตามเอเจนต์หรือใช้ /agent เพื่อสลับ

เอกสาร: โมเดล, การกำหนดเส้นทางหลายเอเจนต์, MiniMax, OpenAI

ใช่ OpenClaw มาพร้อมคำย่อเริ่มต้นบางรายการ (จะนำไปใช้เฉพาะเมื่อโมเดลมีอยู่ใน agents.defaults.models):

• opus → anthropic/claude-opus-4-7
• 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-preview

หากคุณตั้งนามแฝงของคุณเองด้วยชื่อเดียวกัน ค่าของคุณจะมีผลเหนือกว่า

นามแฝงมาจาก 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" },        "anthropic/claude-haiku-4-5": { alias: "haiku" },      },    },  },}

จากนั้น /model sonnet (หรือ /<alias> เมื่อรองรับ) จะถูก resolve เป็น ID โมเดลนั้น

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" },      models: { "zai/glm-5": {} },    },  },  env: { ZAI_API_KEY: "..." },}

หากคุณอ้างอิงผู้ให้บริการ/โมเดล แต่ไม่มีคีย์ผู้ให้บริการที่จำเป็น คุณจะได้รับข้อผิดพลาด auth ขณะรันไทม์ (เช่น No API key found for provider "zai")

ไม่พบคีย์ API สำหรับผู้ให้บริการหลังจากเพิ่มเอเจนต์ใหม่

โดยทั่วไปหมายความว่า เอเจนต์ใหม่ มี auth store ว่างเปล่า auth เป็นแบบแยกต่อเอเจนต์และ จัดเก็บอยู่ใน:

~/.openclaw/agents/<agentId>/agent/auth-profiles.json

ตัวเลือกการแก้ไข:

• รัน openclaw agents add <id> และกำหนดค่า auth ระหว่างวิซาร์ด
• หรือคัดลอกเฉพาะโปรไฟล์ api_key / token แบบสแตติกที่ย้ายข้ามได้จาก auth store ของเอเจนต์หลักไปยัง auth store ของเอเจนต์ใหม่
• สำหรับโปรไฟล์ OAuth ให้ลงชื่อเข้าใช้จากเอเจนต์ใหม่เมื่อเอเจนต์นั้นต้องใช้บัญชีของตัวเอง มิฉะนั้น OpenClaw สามารถอ่านผ่านไปยังเอเจนต์ค่าเริ่มต้น/หลักได้โดยไม่ต้องโคลน refresh token

อย่าใช้ agentDir ซ้ำข้ามเอเจนต์ เพราะจะทำให้ auth/session ชนกัน

การสำรองเมื่อเกิดข้อผิดพลาดเกิดขึ้นเป็นสองขั้นตอน:

1. การหมุนเวียนโปรไฟล์ auth ภายในผู้ให้บริการเดียวกัน
2. การถอยกลับของโมเดล ไปยังโมเดลถัดไปใน agents.defaults.model.fallbacks

คูลดาวน์จะมีผลกับโปรไฟล์ที่ล้มเหลว (exponential backoff) ดังนั้น OpenClaw จึงยังตอบสนองต่อได้แม้ผู้ให้บริการถูกจำกัดอัตราหรือล้มเหลวชั่วคราว

บักเก็ต rate-limit รวมมากกว่าการตอบกลับ 429 แบบทั่วไป OpenClaw ยังถือว่าข้อความอย่าง Too many concurrent requests, ThrottlingException, concurrency limit reached, workers_ai ... quota limit exceeded, resource exhausted และขีดจำกัด ช่วงเวลาการใช้งานเป็นระยะ (weekly/monthly limit reached) เป็น rate limit ที่ควรทำการสำรองเมื่อเกิดข้อผิดพลาด

การตอบกลับบางรายการที่ดูเหมือนเกี่ยวกับการเรียกเก็บเงินไม่ใช่ 402 และการตอบกลับ HTTP 402 บางรายการก็ยังอยู่ในบักเก็ตชั่วคราวนั้นเช่นกัน หากผู้ให้บริการส่งคืน ข้อความการเรียกเก็บเงินที่ชัดเจนบน 401 หรือ 403 OpenClaw ยังสามารถเก็บรายการนั้นไว้ใน ช่องทางการเรียกเก็บเงินได้ แต่ตัวจับคู่ข้อความเฉพาะผู้ให้บริการจะยังคงจำกัดอยู่กับ ผู้ให้บริการที่เป็นเจ้าของตัวจับคู่นั้น (เช่น OpenRouter Key limit exceeded) หากข้อความ 402 ดูเหมือนเป็นขีดจำกัดหน้าต่างการใช้งานที่ลองใหม่ได้ หรือ ขีดจำกัดค่าใช้จ่ายระดับองค์กร/เวิร์กสเปซ (daily limit reached, resets tomorrow, organization spending limit exceeded) แทน OpenClaw จะถือว่าเป็น rate_limit ไม่ใช่การปิดใช้งานการเรียกเก็บเงินระยะยาว

ข้อผิดพลาด context-overflow ต่างออกไป: ลายเซ็นเช่น 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 อยู่ในนั้น" OpenClaw ถือว่า transient shape ที่จำกัดตามผู้ให้บริการ เช่น Anthropic แบบเปล่า An unknown error occurred, OpenRouter แบบเปล่า Provider returned error, ข้อผิดพลาด stop-reason เช่น Unhandled stop reason: error, payload JSON api_error พร้อมข้อความเซิร์ฟเวอร์ชั่วคราว (internal server error, unknown error, 520, upstream error, backend error) และข้อผิดพลาด provider-busy เช่น ModelNotReadyException เป็น สัญญาณหมดเวลา/โอเวอร์โหลดที่ควรสำรองเมื่อเกิดข้อผิดพลาด เมื่อ context ของผู้ให้บริการ ตรงกัน ข้อความถอยกลับภายในทั่วไป เช่น LLM request failed with an unknown error. จะยังคงอนุรักษ์นิยมและไม่ทริกเกอร์การถอยกลับของโมเดลด้วยตัวเอง

หมายความว่าระบบพยายามใช้ ID โปรไฟล์ auth anthropic:default แต่ไม่พบข้อมูลประจำตัวของโปรไฟล์นั้นใน auth store ที่คาดไว้

เช็กลิสต์การแก้ไข:

• ยืนยันว่าโปรไฟล์ auth อยู่ที่ใด (พาธใหม่เทียบกับพาธเดิม)
  • ปัจจุบัน: ~/.openclaw/agents/<agentId>/agent/auth-profiles.json
  • เดิม: ~/.openclaw/agent/* (ย้ายโดย openclaw doctor)
• ยืนยันว่า env var ของคุณถูกโหลดโดย Gateway
  • หากคุณตั้ง ANTHROPIC_API_KEY ใน shell ของคุณ แต่รัน Gateway ผ่าน systemd/launchd อาจไม่ได้สืบทอดค่านั้น ให้ใส่ไว้ใน ~/.openclaw/.env หรือเปิดใช้งาน env.shellEnv
• ตรวจสอบให้แน่ใจว่าคุณกำลังแก้ไขเอเจนต์ที่ถูกต้อง
  • การตั้งค่าแบบหลายเอเจนต์หมายความว่าอาจมีไฟล์ auth-profiles.json หลายไฟล์
• ตรวจสอบสถานะโมเดล/auth แบบคร่าว ๆ
  • ใช้ openclaw models status เพื่อดูโมเดลที่กำหนดค่าไว้และดูว่าผู้ให้บริการผ่านการรับรองตัวตนแล้วหรือไม่

เช็กลิสต์การแก้ไขสำหรับ "ไม่พบข้อมูลประจำตัวสำหรับโปรไฟล์ anthropic"

หมายความว่าการรันถูกตรึงไว้กับโปรไฟล์ auth ของ Anthropic แต่ Gateway หาโปรไฟล์นั้นไม่พบใน auth store ของตน

• ใช้ Claude CLI

  • รัน openclaw models auth login --provider anthropic --method cli --set-default บนโฮสต์ Gateway

• หากคุณต้องการใช้คีย์ API แทน

  • ใส่ ANTHROPIC_API_KEY ใน ~/.openclaw/.env บน โฮสต์ Gateway

  • ล้างลำดับที่ตรึงไว้ซึ่งบังคับใช้โปรไฟล์ที่หายไป:

    openclaw models auth order clear --provider anthropic

• ยืนยันว่าคุณกำลังรันคำสั่งบนโฮสต์ Gateway

  • ในโหมดระยะไกล โปรไฟล์ auth จะอยู่บนเครื่อง Gateway ไม่ใช่แล็ปท็อปของคุณ

หากการกำหนดค่าโมเดลของคุณมี Google Gemini เป็นตัวสำรอง (หรือคุณสลับไปใช้ชอร์ตแฮนด์ Gemini) OpenClaw จะลองใช้ระหว่างการถอยกลับของโมเดล หากคุณยังไม่ได้กำหนดค่าข้อมูลประจำตัว Google คุณจะเห็น No API key found for provider "google"

วิธีแก้: ให้ข้อมูล auth ของ Google หรือเอา/หลีกเลี่ยงโมเดล Google ใน agents.defaults.model.fallbacks / นามแฝง เพื่อไม่ให้การถอยกลับ route ไปที่นั่น

คำขอ LLM ถูกปฏิเสธ: ต้องมี thinking signature (Google Antigravity)

สาเหตุ: ประวัติเซสชันมี thinking blocks ที่ไม่มีลายเซ็น (มักมาจาก สตรีมที่ถูกยกเลิก/ไม่สมบูรณ์) Google Antigravity ต้องใช้ลายเซ็นสำหรับ thinking blocks

วิธีแก้: ตอนนี้ OpenClaw จะตัด thinking blocks ที่ไม่มีลายเซ็นออกสำหรับ Google Antigravity Claude หากยังปรากฏอยู่ ให้เริ่ม เซสชันใหม่ หรือตั้ง /thinking off สำหรับเอเจนต์นั้น

โปรไฟล์ auth คือระเบียนข้อมูลประจำตัวที่มีชื่อ (OAuth หรือคีย์ API) ซึ่งผูกกับผู้ให้บริการ โปรไฟล์อยู่ใน:

~/.openclaw/agents/<agentId>/agent/auth-profiles.json

หากต้องการตรวจสอบโปรไฟล์ที่บันทึกไว้โดยไม่ dump ข้อมูลลับ ให้รัน openclaw models auth list (เลือกใช้ --provider <id> หรือ --json ได้) ดูรายละเอียดใน Models CLI

OpenClaw ใช้ ID ที่มีคำนำหน้าผู้ให้บริการ เช่น:

• anthropic:default (พบได้บ่อยเมื่อไม่มีอัตลักษณ์อีเมล)
• anthropic:<email> สำหรับอัตลักษณ์ OAuth
• ID แบบกำหนดเองที่คุณเลือก (เช่น anthropic:work)

ได้ การกำหนดค่ารองรับ metadata ทางเลือกสำหรับโปรไฟล์และลำดับต่อผู้ให้บริการ (auth.order.<provider>) สิ่งนี้ ไม่ จัดเก็บข้อมูลลับ แต่แมป ID ไปยังผู้ให้บริการ/โหมด และตั้งลำดับการหมุนเวียน

OpenClaw อาจข้ามโปรไฟล์ชั่วคราวหากอยู่ใน คูลดาวน์ ระยะสั้น (rate limits/timeouts/auth failures) หรืออยู่ในสถานะ ปิดใช้งาน ที่ยาวกว่า (การเรียกเก็บเงิน/เครดิตไม่เพียงพอ) หากต้องการตรวจสอบ ให้รัน openclaw models status --json และตรวจสอบ auth.unusableProfiles การปรับแต่ง: auth.cooldowns.billingBackoffHours*

คูลดาวน์ rate-limit สามารถจำกัดตามโมเดลได้ โปรไฟล์ที่กำลังคูลดาวน์ สำหรับโมเดลหนึ่งอาจยังใช้งานได้กับโมเดลพี่น้องบนผู้ให้บริการเดียวกัน ขณะที่ช่วงเวลาการเรียกเก็บเงิน/ปิดใช้งานยังคงบล็อกทั้งโปรไฟล์

คุณยังสามารถตั้งการแทนที่ลำดับ ต่อเอเจนต์ (จัดเก็บใน auth-state.json ของเอเจนต์นั้น) ผ่าน CLI ได้:

# Defaults to the configured default agent (omit --agent)openclaw models auth order get --provider anthropic # Lock rotation to a single profile (only try this one)openclaw models auth order set --provider anthropic anthropic:default # Or set an explicit order (fallback within provider)openclaw models auth order set --provider anthropic anthropic:work anthropic:default # Clear override (fall back to config auth.order / round-robin)openclaw models auth order clear --provider anthropic

หากต้องการระบุเอเจนต์เฉพาะ:

openclaw models auth order set --provider anthropic --agent main anthropic:default

หากต้องการตรวจสอบว่าจะลองอะไรจริง ๆ ให้ใช้:

openclaw models status --probe

หากโปรไฟล์ที่จัดเก็บไว้ถูกละไว้จากลำดับที่ระบุอย่างชัดเจน probe จะรายงาน excluded_by_auth_order สำหรับโปรไฟล์นั้นแทนการลองแบบเงียบ ๆ

OpenClaw รองรับทั้งสองแบบ:

• OAuth มักใช้ประโยชน์จากการเข้าถึงแบบสมัครสมาชิก (เมื่อใช้ได้)
• คีย์ API ใช้การเรียกเก็บเงินแบบจ่ายตามโทเค็น

วิซาร์ดรองรับ Anthropic Claude CLI, OpenAI Codex OAuth และคีย์ API อย่างชัดเจน