OpenAI

OpenClaw ใช้ ID ผู้ให้บริการเดียวคือ openai สำหรับทั้งการยืนยันตัวตนด้วยคีย์ API โดยตรงและ การยืนยันตัวตนด้วยการสมัครสมาชิก ChatGPT/Codex โดย openai/* คือเส้นทางโมเดลมาตรฐาน สำหรับรอบการทำงานของเอเจนต์แบบฝังตัวที่ไม่ได้กำหนดนโยบายรันไทม์หรือกำหนดเป็น auto ข้อมูลเส้นทาง ของ OpenAI จะกำหนดว่า OpenClaw สามารถเลือกรันไทม์เซิร์ฟเวอร์แอป Codex ที่ให้มาพร้อมกัน โดยปริยายได้หรือไม่ คำนำหน้า openai/* เพียงอย่างเดียวไม่ได้เลือกรันไทม์

• โมเดลเอเจนต์ - openai/* ผ่านรันไทม์ที่เลือกโดยการกำหนดค่า agentRuntime อย่างชัดเจนหรือนโยบายเส้นทางโดยปริยายของ OpenAI ลงชื่อเข้าใช้ด้วยการยืนยันตัวตน Codex เพื่อใช้การสมัครสมาชิก ChatGPT/Codex หรือกำหนดค่าโปรไฟล์การยืนยันตัวตนด้วยคีย์ API เมื่อต้องการการเรียกเก็บเงินตามคีย์
• API ของ OpenAI ที่ไม่ใช่เอเจนต์ - การเข้าถึง OpenAI Platform โดยตรง โดยคิดค่าบริการตามการใช้งาน ผ่าน OPENAI_API_KEY หรือโปรไฟล์การยืนยันตัวตนด้วยคีย์ API openai
• การกำหนดค่าเดิม - การอ้างอิง codex/* และ openai-codex/* จะได้รับการซ่อมแซมเป็น openai/* พร้อม agentRuntime.id: "codex" ที่มีขอบเขตระดับโมเดลโดย openclaw doctor --fix

OpenAI รองรับการใช้ OAuth ของการสมัครสมาชิกในเครื่องมือภายนอกและ เวิร์กโฟลว์อย่าง OpenClaw อย่างชัดเจน

การติดตามการใช้งานและค่าใช้จ่าย

OpenClaw แยกโควตาการสมัครสมาชิกออกจากการเรียกเก็บเงินของ Platform API:

• OAuth ของ ChatGPT/Codex แสดงแผนการสมัครสมาชิก ช่วงโควตา และยอดเครดิตคงเหลือ
• OPENAI_ADMIN_KEY แสดงค่าใช้จ่ายขององค์กรและการใช้งาน completions ที่ผู้ให้บริการรายงานในช่วง 30 วันใน Usage ของ Control UI ซึ่งรวมถึงค่าใช้จ่ายรายวัน ยอดรวมคำขอ/โทเค็น โมเดลที่ใช้มากที่สุด และหมวดหมู่ค่าใช้จ่าย
• OPENAI_PROJECT_ID สามารถจำกัดขอบเขตประวัติ Admin API ให้เหลือโครงการเดียวได้
• OpenClaw จะไม่ส่ง OPENAI_API_KEY หรือโปรไฟล์การอนุมาน openai ไปยัง API ระดับองค์กร เนื่องจากข้อมูลประจำตัวเหล่านั้นอาจเป็นของปลายทางแบบกำหนดเอง, Azure หรือปลายทางภายในเอเจนต์

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

เอกสาร แดชบอร์ดการใช้งาน API ของ OpenAI อธิบายข้อกำหนดเกี่ยวกับการเป็นเจ้าขององค์กรและสิทธิ์ Usage Dashboard ที่ต้องกำหนดอย่างชัดเจนเพื่อเข้าถึงข้อมูลการใช้งาน

ผู้ให้บริการ โมเดล รันไทม์ และช่องทางเป็นคนละชั้นกัน หากป้ายกำกับเหล่านี้ ปะปนกัน โปรดอ่าน รันไทม์ของเอเจนต์ ก่อน เปลี่ยนการกำหนดค่า

ตัวเลือกด่วน

ผังชื่อ

รันไทม์เอเจนต์โดยปริยาย

เมื่อนโยบาย agentRuntime ของผู้ให้บริการ/โมเดลไม่ได้กำหนดหรือเป็น auto นโยบายเส้นทาง ที่ผู้ให้บริการ OpenAI เป็นเจ้าของจะเลือกรันไทม์โดยปริยายจาก ปลายทางและอะแดปเตอร์ที่มีผล:

agentRuntime.id ของผู้ให้บริการ/โมเดลที่ระบุชัดเจนและไม่ใช่ค่าเริ่มต้นยังคงมีผลสูงสุด ตัวอย่างเช่น agentRuntime.id: "openclaw" จะคงเส้นทางที่มีสิทธิ์ใช้ Codex ไว้บน OpenClaw ขณะที่ agentRuntime.id: "codex" กำหนดให้ใช้ Codex และจะหยุดทำงานโดยปฏิเสธ เมื่อเส้นทางที่มีผลไม่ได้รับการประกาศว่ารองรับ Codex การเลือกรันไทม์ไม่เปลี่ยนประเภทข้อมูลประจำตัวหรือการเรียกเก็บเงิน การยืนยันตัวตนด้วยคีย์ API ของ Platform และการยืนยันตัวตนด้วยการสมัครสมาชิก ChatGPT/Codex ยังคงแยกจากกัน

openclaw doctor --fix ย้ายการอ้างอิงโมเดล codex/* และ openai-codex/* แบบเดิม ID โปรไฟล์การยืนยันตัวตน Codex แบบเดิม และรายการลำดับการยืนยันตัวตน Codex แบบเดิมไปยัง เส้นทางมาตรฐาน openai การอ้างอิงโมเดลที่ย้ายแล้วจะได้รับ agentRuntime.id: "codex" ที่มีขอบเขตระดับโมเดล ใช้ auth.order.openai สำหรับการกำหนดค่าลำดับการยืนยันตัวตนใหม่

GPT-5.6 รุ่นตัวอย่างแบบจำกัด

OpenClaw รู้จัก ID โมเดล openai/gpt-5.6-sol, openai/gpt-5.6-terra และ openai/gpt-5.6-luna ที่ตรงกันทุกประการ ทั้งสามรายการรองรับ การให้เหตุผลแบบ xhigh และ max ในแค็ตตาล็อกปัจจุบัน OpenAI อธิบายว่า Sol เป็น ระดับเรือธง Terra เป็นระดับสมดุล และ Luna เป็นระดับที่รวดเร็ว และมีต้นทุนต่ำกว่า ดู ประกาศเปิดตัว GPT-5.6 และคู่มือการเข้าถึง

เมื่อใช้การยืนยันตัวตนด้วยคีย์ API ของ OpenAI โดยตรง ID openai/gpt-5.6 แบบไม่ระบุส่วนต่อท้ายเป็นนามแฝงของ Sol และเป็นค่าเริ่มต้นสำหรับการตั้งค่าใหม่ แค็ตตาล็อก Codex แบบเนทีฟจะไม่นำนามแฝง API โดยตรงนั้น มาใช้ฝั่งไคลเอนต์ โดยอาจแสดง ID ของ Sol, Terra และ Luna ที่ตรงกันทุกประการ ตามสิทธิ์เข้าถึงของเวิร์กสเปซ ดังนั้นการตั้งค่า OAuth ของ ChatGPT/Codex ใหม่ จึงใช้ openai/gpt-5.6-sol ตรวจสอบบัญชีปัจจุบันด้วย:

openclaw models list --provider openai

สิทธิ์เข้าถึงขององค์กร API และเวิร์กสเปซ Codex อาจแตกต่างกัน หาก GPT-5.6 ไม่พร้อมใช้งาน ให้เลือก GPT-5.5 อย่างชัดเจน:

openclaw models set openai/gpt-5.5

OpenClaw จะแสดงข้อผิดพลาดการเข้าถึงจากต้นทางและจะไม่แทนที่ ตัวเลือก GPT-5.6 ด้วย GPT-5.5 โดยไม่แจ้ง

ความครอบคลุมฟีเจอร์ของ OpenClaw

เอ็มเบดดิงหน่วยความจำ

OpenClaw สามารถใช้ OpenAI หรือเอนด์พอยต์เอ็มเบดดิงที่เข้ากันได้กับ OpenAI สำหรับ การจัดทำดัชนี memory_search และเอ็มเบดดิงคำค้น:

{  agents: {    defaults: {      memorySearch: {        provider: "openai",        model: "text-embedding-3-small",      },    },  },}

สำหรับเอนด์พอยต์ที่เข้ากันได้กับ OpenAI ซึ่งต้องใช้ป้ายกำกับเอ็มเบดดิงแบบอสมมาตร ให้ตั้งค่า queryInputType และ documentInputType ภายใต้ memorySearch OpenClaw จะส่งต่อค่าเหล่านี้เป็นฟิลด์คำขอ input_type เฉพาะผู้ให้บริการ: เอ็มเบดดิง คำค้นใช้ queryInputType; ส่วนชิ้นข้อมูลหน่วยความจำที่จัดทำดัชนีและการจัดทำดัชนีแบบแบตช์ใช้ documentInputType ดูตัวอย่างฉบับเต็มได้ใน ข้อมูลอ้างอิงการกำหนดค่าหน่วยความจำ

เริ่มต้นใช้งาน

openclaw onboard --auth-choice openai-api-key

openclaw onboard --openai-api-key "$OPENAI_API_KEY"

openclaw models list --provider openai

{  env: { OPENAI_API_KEY: "example-openai-key-not-real" },  agents: { defaults: { model: { primary: "openai/gpt-5.6" } } },}

{  env: { OPENAI_API_KEY: "example-openai-key-not-real" },  agents: { defaults: { model: { primary: "openai/chat-latest" } } },}

openclaw onboard --auth-choice openai

openclaw models auth login --provider openai

openclaw models auth login --provider openai --device-code

openclaw config set agents.defaults.model.primary openai/gpt-5.6-sol

openclaw models list --provider openai

{  plugins: { entries: { codex: { enabled: true } } },  agents: {    defaults: {      model: { primary: "openai/gpt-5.6-sol" },    },  },}

{  plugins: { entries: { codex: { enabled: true } } },  agents: {    defaults: {      model: { primary: "openai/gpt-5.6-sol" },    },  },  auth: {    order: {      openai: [        "openai:user@example.com",        "openai:api-key-backup",      ],    },  },}

openclaw models statusopenclaw models auth list --provider openaiopenclaw config get agents.defaults.model --jsonopenclaw config get models.providers.openai.agentRuntime --json

openclaw models status --agent <id>openclaw models auth list --agent <id> --provider openai

openclaw doctor --fixopenclaw config validate

openclaw models auth login --provider openaiopenclaw models status --probe --probe-provider openai

openclaw models auth login --provider openai --profile-id openai:ritsukoopenclaw models auth login --provider openai --profile-id openai:lain

{  models: {    providers: {      openai: {        models: [{ id: "gpt-5.5", contextTokens: 160000 }],      },    },  },}

การยืนยันตัวตนของ app-server Codex แบบเนทีฟ

ชุดควบคุม app-server Codex แบบเนทีฟใช้การอ้างอิงโมเดล openai/* เมื่อเส้นทาง HTTPS ทางการแบบตรงกันทุกประการที่มีสิทธิ์เลือกใช้งานโดยนัย หรือเมื่อ agentRuntime.id: "codex" ของผู้ให้บริการ/โมเดลเลือกใช้งานอย่างชัดเจน การยืนยันตัวตนยังคง อิงตามบัญชี OpenClaw เลือกการยืนยันตัวตนตามลำดับนี้:

1. โปรไฟล์การยืนยันตัวตน OpenAI ที่จัดลำดับไว้สำหรับเอเจนต์ โดยควรอยู่ภายใต้ auth.order.openai เรียกใช้ openclaw doctor --fix เพื่อย้าย ID โปรไฟล์ การยืนยันตัวตน Codex แบบเดิมและลำดับการยืนยันตัวตน
2. บัญชีที่มีอยู่ของ app-server เช่น การลงชื่อเข้าใช้ ChatGPT ใน Codex CLI ภายในเครื่อง สำหรับโฮมเอเจนต์แบบแยกที่เป็นค่าเริ่มต้น OpenClaw จะเชื่อมบัญชี CLI แบบเนทีฟนั้นเข้าสู่ app-server ผ่าน RPC การเข้าสู่ระบบ โดยจะไม่ใช้การกำหนดค่า Plugin หรือที่จัดเก็บเธรดของ CLI ร่วมกัน
3. เฉพาะการเปิด app-server ผ่าน stdio ภายในเครื่อง และเฉพาะเมื่อ app-server รายงานว่าไม่มีบัญชี: CODEX_API_KEY แล้วจึง OPENAI_API_KEY

การลงชื่อเข้าใช้การสมัครสมาชิก ChatGPT/Codex ภายในเครื่องจะไม่ถูกแทนที่เพียงเพราะ กระบวนการ Gateway มี OPENAI_API_KEY สำหรับโมเดล OpenAI โดยตรงหรือ การฝังด้วย การใช้คีย์ API จากสภาพแวดล้อมเป็นทางเลือกสำรองจะใช้เฉพาะเส้นทาง stdio ภายในเครื่อง ที่ไม่มีบัญชีเท่านั้น และจะไม่ถูกส่งผ่านการเชื่อมต่อ app-server แบบ WebSocket เมื่อเลือก โปรไฟล์ Codex แบบการสมัครสมาชิก OpenClaw จะกัน CODEX_API_KEY และ OPENAI_API_KEY ออกจากโปรเซสลูก app-server แบบ stdio ที่เรียกขึ้นมา และส่งข้อมูลประจำตัวที่เลือกผ่าน RPC การเข้าสู่ระบบของ app-server แทน

เมื่อโปรไฟล์การสมัครสมาชิกดังกล่าวถูกบล็อกโดยขีดจำกัดการใช้งาน Codex OpenClaw จะทำเครื่องหมายโปรไฟล์ว่าถูกบล็อกจนถึงเวลารีเซ็ตที่ Codex ประกาศ และให้ลำดับ การยืนยันตัวตนหมุนไปยังโปรไฟล์ openai:* ถัดไป โดยไม่เปลี่ยนโมเดลที่เลือก หรือออกจากชุดควบคุม Codex เมื่อพ้นเวลารีเซ็ตแล้ว โปรไฟล์การสมัครสมาชิกจะมีสิทธิ์ใช้งานอีกครั้ง

การสร้างรูปภาพ

Plugin openai ที่รวมมาให้จะลงทะเบียนการสร้างรูปภาพผ่านเครื่องมือ image_generate โดยรองรับทั้งการสร้างรูปภาพด้วยคีย์ API ของ OpenAI และ OAuth ของ Codex ผ่านการอ้างอิงโมเดล openai/gpt-image-2 เดียวกัน

{  agents: {    defaults: {      imageGenerationModel: { primary: "openai/gpt-image-2" },    },  },}

gpt-image-2 เป็นค่าเริ่มต้นสำหรับการสร้างรูปภาพจากข้อความและการแก้ไข รูปภาพของ OpenAI ส่วน gpt-image-1.5, gpt-image-1 และ gpt-image-1-mini ยังคงใช้งานได้ โดยระบุเป็นการเขียนทับโมเดลอย่างชัดเจน ใช้ openai/gpt-image-1.5 สำหรับ เอาต์พุต PNG/WebP ที่มีพื้นหลังโปร่งใส โดย API gpt-image-2 ปัจจุบันปฏิเสธ background: "transparent"

สำหรับคำขอพื้นหลังโปร่งใส ให้เรียก image_generate โดยใช้ model: "openai/gpt-image-1.5", outputFormat: "png" หรือ "webp" และ background: "transparent" ทั้งนี้ตัวเลือกผู้ให้บริการ openai.background แบบเก่า ยังคงได้รับการยอมรับ OpenClaw ยังปกป้องเส้นทางสาธารณะของ OpenAI และ OAuth ของ OpenAI Codex โดยเขียนคำขอโปร่งใส openai/gpt-image-2 เริ่มต้นใหม่เป็น gpt-image-1.5 ส่วน Azure และปลายทางที่เข้ากันได้กับ OpenAI แบบกำหนดเองจะคง ชื่อดีพลอยเมนต์/โมเดลที่กำหนดค่าไว้

การตั้งค่าเดียวกันนี้มีให้ใช้กับการทำงาน CLI แบบไม่มีส่วนติดต่อด้วย:

openclaw infer image generate \  --model openai/gpt-image-1.5 \  --output-format png \  --background transparent \  --prompt "วงกลมสีแดงเรียบง่ายในรูปแบบสติกเกอร์บนพื้นหลังโปร่งใส" \  --json

ใช้แฟล็ก --output-format และ --background เดียวกันกับ openclaw infer image edit เมื่อเริ่มจากไฟล์อินพุต --openai-background ยังคงใช้ได้ในฐานะชื่อแทนเฉพาะของ OpenAI ใช้ --quality low|medium|high|auto เพื่อควบคุมคุณภาพและค่าใช้จ่ายของ OpenAI Images ใช้ --openai-moderation low|auto เพื่อส่งคำใบ้การกลั่นกรองของ OpenAI จาก image generate หรือ image edit

สำหรับการติดตั้งด้วย OAuth ของ ChatGPT/Codex ให้คงการอ้างอิง openai/gpt-image-2 เดิมไว้ เมื่อ กำหนดค่าโปรไฟล์ OAuth openai แล้ว OpenClaw จะแก้ไขโทเค็นการเข้าถึง OAuth ที่จัดเก็บไว้และส่งคำขอรูปภาพผ่านแบ็กเอนด์ Codex Responses โดยจะ ไม่ลองใช้ OPENAI_API_KEY ก่อนหรือสลับไปใช้คีย์ API โดยไม่แจ้ง กำหนดค่า models.providers.openai อย่างชัดเจนด้วยคีย์ API, URL ฐานแบบกำหนดเอง หรือปลายทาง Azure เมื่อต้องการใช้เส้นทาง OpenAI Images API โดยตรง แทน หากปลายทางรูปภาพแบบกำหนดเองดังกล่าวอยู่ใน LAN/ที่อยู่ส่วนตัวที่เชื่อถือได้ ให้ตั้งค่า browser.ssrfPolicy.dangerouslyAllowPrivateNetwork: true ด้วย OpenClaw จะบล็อกปลายทางรูปภาพที่เข้ากันได้กับ OpenAI แบบส่วนตัว/ภายใน เว้นแต่จะมี การเลือกเข้าร่วมนี้

สร้าง:

/tool image_generate model=openai/gpt-image-2 prompt="โปสเตอร์เปิดตัว OpenClaw บน macOS ที่สวยงามประณีต" size=3840x2160 count=1

สร้าง PNG โปร่งใส:

/tool image_generate model=openai/gpt-image-1.5 prompt="วงกลมสีแดงเรียบง่ายในรูปแบบสติกเกอร์บนพื้นหลังโปร่งใส" outputFormat=png background=transparent

แก้ไข:

/tool image_generate model=openai/gpt-image-2 prompt="คงรูปร่างของวัตถุไว้ เปลี่ยนวัสดุเป็นแก้วโปร่งแสง" image=/path/to/reference.png size=1024x1536

การสร้างวิดีโอ

Plugin openai ที่รวมมาให้จะลงทะเบียนการสร้างวิดีโอผ่านเครื่องมือ video_generate

คำขอแปลงรูปภาพเป็นวิดีโอของ OpenAI ใช้ POST /v1/videos พร้อมรูปภาพ input_reference การแก้ไขวิดีโอรายการเดียวใช้ POST /v1/videos/edits พร้อมวิดีโอที่ อัปโหลดในฟิลด์ video

{  agents: {    defaults: {      videoGenerationModel: { primary: "openai/sora-2" },    },  },}

การเพิ่มเนื้อหาในพรอมต์ GPT-5

OpenClaw เพิ่มเนื้อหาในพรอมต์ GPT-5 ที่ใช้ร่วมกันสำหรับโมเดลตระกูล GPT-5 บน ผู้ให้บริการ openai (รวมถึงการอ้างอิง Codex แบบเดิมก่อนการซ่อมแซม ซึ่งจะถูกทำให้เป็นมาตรฐาน เป็น openai/*) ผู้ให้บริการอื่นที่ให้บริการรหัสโมเดลตระกูล GPT-5 เช่นกัน เช่น OpenRouter หรือเส้นทาง opencode จะไม่ได้รับโอเวอร์เลย์นี้ เนื่องจากจะตรวจสอบ รหัสผู้ให้บริการ openai ไม่ใช่เฉพาะรหัสโมเดล โมเดล GPT-4.x รุ่นเก่า จะไม่ได้รับเนื้อหานี้เลย

ชุดทดสอบ app-server ของแอป Codex แบบเนทีฟจะไม่ได้รับสัญญาพฤติกรรมด้านบุคลิก/ระเบียบวินัย การใช้เครื่องมือหรือโอเวอร์เลย์รูปแบบการโต้ตอบที่เป็นมิตรผ่าน คำสั่งสำหรับนักพัฒนา โดย Codex แบบเนทีฟจะคงพฤติกรรมพื้นฐาน โมเดล และ เอกสารโครงการที่ Codex เป็นเจ้าของไว้ และ OpenClaw จะปิดใช้งานบุคลิกภาพในตัวของ Codex สำหรับเธรดแบบเนทีฟ เพื่อให้ไฟล์บุคลิกภาพในพื้นที่ทำงานของเอเจนต์ยังคงเป็นแหล่งข้อมูลหลัก OpenClaw เพิ่มเฉพาะบริบทรันไทม์ให้เธรด Codex แบบเนทีฟ ได้แก่ การส่งผ่านช่องทาง เครื่องมือแบบไดนามิกของ OpenClaw การมอบหมายผ่าน ACP บริบทพื้นที่ทำงาน และ Skills ของ OpenClaw ข้อความแนะแนว Heartbeat จากเนื้อหาที่เพิ่มชุดเดียวกันนี้เป็น ข้อยกเว้นเพียงอย่างเดียว กล่าวคือ รอบ Heartbeat ของ Codex แบบเนทีฟจะได้รับข้อความนี้ โดยแทรกเป็นคำสั่งการทำงานร่วมกันโดยเฉพาะ แทนที่จะผ่านฮุก การเพิ่มเนื้อหาในพรอมต์ที่ใช้ร่วมกัน

เนื้อหาที่เพิ่มสำหรับ GPT-5 จะเพิ่มสัญญาพฤติกรรมที่มีแท็กสำหรับการคงอยู่ของบุคลิก ความปลอดภัยในการดำเนินงาน ระเบียบวินัยในการใช้เครื่องมือ รูปแบบผลลัพธ์ การตรวจสอบ ความสมบูรณ์ และการยืนยันผลในพรอมต์ที่ OpenClaw ประกอบขึ้นและตรงตามเงื่อนไข พฤติกรรม การตอบกลับเฉพาะช่องทางและข้อความแบบเงียบยังคงอยู่ในพรอมต์ระบบ OpenClaw ที่ใช้ร่วมกัน และนโยบายการส่งออก เลเยอร์รูปแบบการโต้ตอบที่เป็นมิตรแยกออกมาต่างหากและกำหนดค่าได้

{  agents: {    defaults: {      promptOverlays: {        gpt5: { personality: "friendly" },      },    },  },}

openclaw config set agents.defaults.promptOverlays.gpt5.personality off

เสียงพูดและการถอดเสียง

{  messages: {    tts: {      providers: {        openai: { model: "gpt-4o-mini-tts", speakerVoice: "coral" },      },    },  },}

{  tools: {    media: {      audio: {        models: [          {            type: "provider",            provider: "openai",            model: "gpt-4o-transcribe",          },        ],      },    },  },}

ปลายทาง Azure OpenAI

ผู้ให้บริการ openai ที่รวมมาให้สามารถกำหนดเป้าหมายไปยังทรัพยากร Azure OpenAI สำหรับการสร้าง รูปภาพได้โดยแทนที่ URL ฐาน ในเส้นทางการสร้างรูปภาพ OpenClaw จะตรวจจับชื่อโฮสต์ Azure ใน models.providers.openai.baseUrl และเปลี่ยนไปใช้ รูปแบบคำขอของ Azure โดยอัตโนมัติ

ใช้ Azure OpenAI เมื่อ:

• มีการสมัครใช้งาน Azure OpenAI โควตา หรือข้อตกลง ระดับองค์กรอยู่แล้ว
• ต้องการการจัดเก็บข้อมูลตามภูมิภาคหรือการควบคุมการปฏิบัติตามข้อกำหนดที่ Azure มีให้
• ต้องการให้ทราฟฟิกอยู่ภายใน Azure tenancy ที่มีอยู่

การกำหนดค่า

สำหรับการสร้างรูปภาพผ่าน Azure โดยใช้ผู้ให้บริการ openai ที่รวมมาให้ ให้ชี้ models.providers.openai.baseUrl ไปยังทรัพยากร Azure และตั้งค่า apiKey เป็น คีย์ Azure OpenAI (ไม่ใช่คีย์ OpenAI Platform):

{  models: {    providers: {      openai: {        baseUrl: "https://<your-resource>.openai.azure.com",        apiKey: "<azure-openai-api-key>",      },    },  },}

OpenClaw รู้จักส่วนต่อท้ายโฮสต์ Azure ต่อไปนี้สำหรับเส้นทางการสร้างรูปภาพ ของ Azure:

• *.openai.azure.com
• *.services.ai.azure.com
• *.cognitiveservices.azure.com

สำหรับคำขอสร้างรูปภาพบนโฮสต์ Azure ที่รู้จัก OpenClaw จะ:

• ส่งส่วนหัว api-key แทน Authorization: Bearer
• ใช้พาธที่กำหนดขอบเขตตาม deployment (/openai/deployments/{deployment}/...)
• ต่อท้าย ?api-version=... ในแต่ละคำขอ
• ใช้ค่า timeout เริ่มต้นของคำขอที่ 600s สำหรับการเรียกสร้างรูปภาพผ่าน Azure ค่า timeoutMs ของแต่ละการเรียกยังคงแทนที่ค่าเริ่มต้นนี้ได้

URL ฐานอื่นๆ (OpenAI สาธารณะและพร็อกซีที่เข้ากันได้กับ OpenAI) จะยังคงใช้ รูปแบบคำขอรูปภาพมาตรฐานของ OpenAI

เวอร์ชัน API

ตั้งค่า AZURE_OPENAI_API_VERSION เพื่อตรึงเวอร์ชัน Azure แบบพรีวิวหรือ GA ที่ระบุ สำหรับเส้นทางการสร้างรูปภาพผ่าน Azure:

export AZURE_OPENAI_API_VERSION="2024-12-01-preview"

ค่าเริ่มต้นคือ 2024-12-01-preview เมื่อตัวแปรไม่ได้ถูกตั้งค่า

ชื่อโมเดลคือชื่อ deployment

Azure OpenAI ผูกโมเดลเข้ากับ deployment สำหรับคำขอสร้างรูปภาพผ่าน Azure ที่กำหนดเส้นทางผ่านผู้ให้บริการ openai ที่รวมมาให้ ฟิลด์ model ใน OpenClaw ต้องเป็น ชื่อ deployment ของ Azure ที่กำหนดค่าไว้ในพอร์ทัล Azure ไม่ใช่ ID โมเดล OpenAI สาธารณะ

หากสร้าง deployment ชื่อ gpt-image-2-prod ที่ให้บริการ gpt-image-2:

/tool image_generate model=openai/gpt-image-2-prod prompt="โปสเตอร์เรียบสะอาด" size=1024x1024 count=1

กฎการใช้ชื่อ deployment เดียวกันนี้มีผลกับการเรียกสร้างรูปภาพทั้งหมดที่กำหนดเส้นทาง ผ่านผู้ให้บริการ openai ที่รวมมาให้

ความพร้อมใช้งานตามภูมิภาค

ขณะนี้การสร้างรูปภาพผ่าน Azure ใช้งานได้เฉพาะในบางภูมิภาค (เช่น eastus2, swedencentral, polandcentral, westus3, uaenorth) ตรวจสอบรายการภูมิภาคล่าสุดของ Microsoft ก่อนสร้าง deployment และยืนยันว่าโมเดลที่ระบุมีให้บริการในภูมิภาคของคุณ

ความแตกต่างของพารามิเตอร์

Azure OpenAI และ OpenAI สาธารณะไม่ได้ยอมรับพารามิเตอร์รูปภาพชุดเดียวกันเสมอไป Azure อาจปฏิเสธตัวเลือกที่ OpenAI สาธารณะอนุญาต (เช่น ค่า background บางค่าบน gpt-image-2) หรือเปิดให้ใช้เฉพาะในโมเดล บางเวอร์ชัน ความแตกต่างเหล่านี้มาจาก Azure และโมเดลพื้นฐาน ไม่ใช่ OpenClaw หากคำขอ Azure ล้มเหลวด้วยข้อผิดพลาดในการตรวจสอบความถูกต้อง ให้ตรวจสอบ ชุดพารามิเตอร์ที่ deployment และเวอร์ชัน API ของคุณรองรับใน พอร์ทัล Azure

การกำหนดค่าขั้นสูง

ตัวอย่าง params แยกตามโมเดลด้านล่างกำหนดรูปแบบคำขอของผู้ให้บริการแบบฝังของ OpenClaw การกำหนดค่าตัวอย่างเหล่านี้ถือเป็นพฤติกรรมของคำขอที่ผู้ใช้กำหนด ดังนั้นเส้นทาง auto ที่เข้าเกณฑ์ในด้านอื่นจะยังคงทำงานบน OpenClaw แทนที่จะเลือก Codex โดยปริยาย ชุดทดสอบ app-server แบบเนทีฟของ Codex จัดการการรับส่งข้อมูลและการตั้งค่าคำขอของตนเอง ส่วน agentRuntime.id: "codex" แบบระบุชัดเจนจะหยุดอย่างปลอดภัยเมื่อเส้นทางที่มีผลไม่ได้ประกาศว่า เข้ากันได้กับ Codex

{  agents: {    defaults: {      models: {        "openai/gpt-5.5": {          params: { transport: "auto" },        },      },    },  },}

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

{  agents: {    defaults: {      models: {        "openai/gpt-5.5": { params: { serviceTier: "priority" } },      },    },  },}

{  agents: {    defaults: {      models: {        "azure-openai-responses/gpt-5.5": {          params: { responsesServerCompaction: true },        },      },    },  },}

{  agents: {    defaults: {      models: {        "openai/gpt-5.5": {          params: {            responsesServerCompaction: true,            responsesCompactThreshold: 120000,          },        },      },    },  },}

{  agents: {    defaults: {      models: {        "openai/gpt-5.5": {          params: { responsesServerCompaction: false },        },      },    },  },}

{  agents: {    defaults: {      embeddedAgent: { executionContract: "default" },    },  },}

ที่เกี่ยวข้อง