คำถามที่พบบ่อย: โมเดลและการยืนยันตัวตน

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

agents.defaults.model.primary

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

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

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

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

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

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

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

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

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

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

เอกสาร: โมเดล, กำหนดค่า, การกำหนดค่า, 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 มากกว่า เราแนะนำอย่างยิ่งให้ใช้ โมเดลขนาดใหญ่ สำหรับบอตใด ๆ ที่ใช้เครื่องมือได้ หากคุณยังต้องการใช้โมเดลขนาดเล็ก ให้เปิดใช้แซนด์บ็อกซ์และรายการอนุญาตเครื่องมือที่เข้มงวด

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

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

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

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

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

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

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

/model 3

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

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

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

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

รัน /model อีกครั้ง โดยไม่ใส่ ส่วนต่อท้าย @profile:

/model anthropic/claude-opus-4-6

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

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

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

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

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

ดู โมเดล และ การสลับเมื่อโมเดลล้มเหลว

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

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

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

ใช้ได้ทั้งตัวสลับต่อเซสชันหรือค่าเริ่มต้นในการกำหนดค่า:

• ต่อเซสชัน: ส่ง /fast on ขณะที่เซสชันกำลังใช้ openai/gpt-5.5
• ค่าเริ่มต้นต่อโมเดล: ตั้ง agents.defaults.models["openai/gpt-5.5"].params.fastMode เป็น true
• จุดตัดอัตโนมัติ: ใช้ /fast auto หรือ params.fastMode: "auto" เพื่อเริ่มการเรียกโมเดลใหม่แบบเร็วไปจนถึงจุดตัดอัตโนมัติ จากนั้นเริ่มการลองใหม่ fallback ผลลัพธ์เครื่องมือ หรือการเรียกต่อเนื่องภายหลังโดยไม่ใช้โหมดเร็ว ค่าเริ่มต้นของจุดตัดคือ 60 วินาที ตั้ง params.fastAutoOnSeconds บนโมเดลที่ใช้งานอยู่เพื่อเปลี่ยนค่านี้

ตัวอย่าง:

{  agents: {    defaults: {      models: {        "openai/gpt-5.5": {          params: {            fastMode: "auto",            fastAutoOnSeconds: 30,          },        },      },    },  },}

สำหรับ OpenAI โหมดเร็วแมปเป็น service_tier = "priority" บนคำขอ Responses แบบเนทีฟที่รองรับ การแทนที่ด้วย /fast ของเซสชันมีลำดับเหนือค่าเริ่มต้นในการกำหนดค่า เทิร์นของ app-server ของ Codex รับระดับได้เฉพาะตอนเริ่มเทิร์น ดังนั้น auto จึงมีผลกับเทิร์นโมเดลถัดไปที่ OpenClaw เริ่ม แทนที่จะมีผลภายในเทิร์น app-server ที่กำลังรันอยู่แล้ว

ดู Thinking และโหมดเร็ว และ โหมดเร็วของ OpenAI

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

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 เพิ่มไวลด์การ์ดผู้ให้บริการ เช่น "provider/*": {} สำหรับแค็ตตาล็อกผู้ให้บริการแบบไดนามิก ลบรายการอนุญาต หรือเลือกโมเดลจาก /model list หากคำสั่งมี --runtime codex ด้วย ให้อัปเดตรายการอนุญาตก่อน แล้วจึงลองคำสั่ง /model provider/model --runtime codex เดิมอีกครั้ง

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

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

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

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

3. ใช้รหัสโมเดลแบบตรงตัว (คำนึงถึงตัวพิมพ์เล็ก/ใหญ่) สำหรับเส้นทางการตรวจสอบสิทธิ์ของคุณ: minimax/MiniMax-M3, minimax/MiniMax-M2.7 หรือ minimax/MiniMax-M2.7-highspeed สำหรับการตั้งค่าด้วย API key หรือ minimax-portal/MiniMax-M3, 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-M3" },      models: {        "minimax/MiniMax-M3": { 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-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

หากคุณตั้ง alias ของคุณเองด้วยชื่อเดียวกัน ค่าของคุณจะถูกใช้ก่อน

Alias มาจาก 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> เมื่อรองรับ) จะ 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 key สำหรับผู้ให้บริการหลังจากเพิ่มเอเจนต์ใหม่

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

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

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

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

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

Failover เกิดขึ้นสองขั้นตอน:

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

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

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

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

ข้อผิดพลาด context-overflow แตกต่างออกไป: signature เช่น 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/retry แทนที่จะเลื่อนไปยัง model fallback

ข้อความ server-error ทั่วไปตั้งใจให้แคบกว่า "อะไรก็ตามที่มี unknown/error อยู่ในนั้น" OpenClaw ถือว่า 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 เป็น สัญญาณ timeout/overloaded ที่ควร failover เมื่อบริบทผู้ให้บริการ ตรงกัน ข้อความ fallback ภายในทั่วไปอย่าง LLM request failed with an unknown error. จะยังคงตีความแบบระมัดระวังและไม่ trigger model fallback ด้วยตัวเอง

หมายความว่าระบบพยายามใช้ ID โปรไฟล์ auth anthropic:default แต่ไม่พบ credentials สำหรับโปรไฟล์นั้นในที่เก็บ auth ที่คาดไว้

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

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

เช็กลิสต์การแก้ไขสำหรับ "No credentials found for profile anthropic"

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

• ใช้ Claude CLI

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

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

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

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

    openclaw models auth order clear --provider anthropic

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

คุณยังสามารถตั้ง override ลำดับแบบ ต่อเอเจนต์ (จัดเก็บใน 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

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

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

• OAuth / CLI login มักใช้ประโยชน์จากการเข้าถึงแบบ subscription เมื่อ ผู้ให้บริการรองรับ สำหรับ Anthropic แบ็กเอนด์ Claude CLI ของ OpenClaw ใช้ Claude Code claude -p; ปัจจุบัน Anthropic ถือว่าสิ่งนั้นเป็นการใช้งาน Agent SDK/แบบ programmatic Anthropic หยุดชั่วคราวการเปลี่ยนแปลงเครดิต Agent SDK แยกต่างหากในวันที่ 15 มิถุนายน 2026 ดังนั้นตอนนี้จึงยังดึงจากขีดจำกัดการใช้งานแบบ subscription ดู บทความแผน Agent SDK ของ Anthropic สำหรับประกาศหยุดชั่วคราวล่าสุด
• API keys ใช้การคิดเงินแบบจ่ายตามโทเค็น

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