OpenAI

OpenAI มี API สำหรับนักพัฒนาสำหรับโมเดล GPT และ Codex ยังพร้อมใช้งานเป็น เอเจนต์เขียนโค้ดในแผน ChatGPT ผ่านไคลเอนต์ Codex ของ OpenAI ด้วย OpenClaw ใช้ provider id เดียวคือ openai สำหรับรูปแบบการยืนยันตัวตนทั้งสองแบบ

OpenClaw ใช้ openai/* เป็นเส้นทางโมเดล OpenAI ตามมาตรฐาน เทิร์นของเอเจนต์แบบฝัง บนโมเดล OpenAI จะรันผ่านรันไทม์ app-server ของ Codex แบบเนทีฟโดย ค่าเริ่มต้น; การยืนยันตัวตนด้วยคีย์ OpenAI API โดยตรงยังพร้อมใช้งานสำหรับพื้นผิว OpenAI ที่ไม่ใช่เอเจนต์ เช่น รูปภาพ, embeddings, เสียงพูด และ realtime

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

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

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

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

แผนที่ชื่อ

ชื่อคล้ายกันแต่ใช้แทนกันไม่ได้:

หมายความว่าคอนฟิกสามารถตั้งใจมี refs โมเดล openai/* ขณะที่โปรไฟล์การยืนยันตัวตน ชี้ไปยังข้อมูลประจำตัวแบบคีย์ API หรือ ChatGPT/Codex OAuth ก็ได้ ใช้ auth.order.openai สำหรับคอนฟิก; openclaw doctor --fix เขียน refs โมเดล Codex เดิม, ids โปรไฟล์การยืนยันตัวตน Codex เดิม และ ลำดับการยืนยันตัวตน Codex เดิมใหม่เป็นเส้นทาง OpenAI ตามมาตรฐาน

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

Embeddings หน่วยความจำ

OpenClaw สามารถใช้ OpenAI หรือปลายทาง embedding ที่เข้ากันได้กับ OpenAI สำหรับ การทำดัชนี memory_search และ embeddings คำค้น:

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

สำหรับปลายทางที่เข้ากันได้กับ OpenAI ซึ่งต้องใช้ป้ายกำกับ embedding แบบอสมมาตร ให้ตั้งค่า queryInputType และ documentInputType ใต้ memorySearch OpenClaw ส่งต่อ ค่าเหล่านั้นเป็นฟิลด์คำขอ input_type เฉพาะผู้ให้บริการ: embeddings ของคำค้นใช้ 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.5" } } },}

{  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.5

openclaw models list --provider openai

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

{  plugins: { entries: { codex: { enabled: true } } },  agents: {    defaults: {      model: { primary: "openai/gpt-5.5" },    },  },  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 }],      },    },  },}

การตรวจสอบสิทธิ์แอปเซิร์ฟเวอร์ Codex แบบเนทีฟ

harness แอปเซิร์ฟเวอร์ Codex แบบเนทีฟใช้การอ้างอิงโมเดล openai/* พร้อม การตั้งค่า runtime ที่ละไว้ หรือ provider/model agentRuntime.id: "codex" แต่การตรวจสอบสิทธิ์ยังคง อิงตามบัญชี OpenClaw เลือกการตรวจสอบสิทธิ์ตามลำดับนี้:

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

นั่นหมายความว่าการลงชื่อเข้าใช้การสมัครสมาชิก ChatGPT/Codex ในเครื่องจะไม่ถูกแทนที่เพียง เพราะ process ของ Gateway มี OPENAI_API_KEY สำหรับโมเดล OpenAI โดยตรง หรือ embeddings ด้วย fallback คีย์ API จาก env เป็นเฉพาะเส้นทาง local stdio ที่ไม่มีบัญชีเท่านั้น และจะไม่ถูกส่งไปยังการเชื่อมต่อแอปเซิร์ฟเวอร์ WebSocket เมื่อเลือกโปรไฟล์ Codex แบบสมัครสมาชิก OpenClaw จะกัน CODEX_API_KEY และ OPENAI_API_KEY ออกจาก child แอปเซิร์ฟเวอร์ stdio ที่ spawn ขึ้นด้วย และส่งข้อมูลรับรองที่เลือก ผ่าน RPC login ของแอปเซิร์ฟเวอร์ เมื่อโปรไฟล์สมัครสมาชิกนั้นถูกบล็อกด้วย ขีดจำกัดการใช้งาน Codex OpenClaw สามารถหมุนไปยังโปรไฟล์คีย์ API openai:* รายการถัดไปที่จัดลำดับไว้ได้โดยไม่เปลี่ยนโมเดลที่เลือกหรือออกจาก harness ของ 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 ยังคงใช้งานได้เป็น override โมเดลอย่างชัดเจน ใช้ openai/gpt-image-1.5 สำหรับเอาต์พุต PNG/WebP พื้นหลังโปร่งใส; API gpt-image-2 ปัจจุบันปฏิเสธ background: "transparent".

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

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

openclaw infer image generate \  --model openai/gpt-image-1.5 \  --output-format png \  --background transparent \  --prompt "A simple red circle sticker on a transparent background" \  --json

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

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

สร้าง:

/tool image_generate model=openai/gpt-image-2 prompt="A polished launch poster for OpenClaw on macOS" size=3840x2160 count=1

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

/tool image_generate model=openai/gpt-image-1.5 prompt="A simple red circle sticker on a transparent background" outputFormat=png background=transparent

แก้ไข:

/tool image_generate model=openai/gpt-image-2 prompt="Preserve the object shape, change the material to translucent glass" 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" },    },  },}

การเพิ่ม prompt สำหรับ GPT-5

OpenClaw เพิ่มการเพิ่ม prompt ร่วมสำหรับการรันตระกูล GPT-5 บนพื้นผิว prompt ที่ OpenClaw ประกอบขึ้น โดยใช้ตาม model id ดังนั้นเส้นทาง OpenClaw/provider เช่น ref ก่อนซ่อมแซมแบบ legacy (ref GPT-5.5 ของ Codex แบบ legacy), openrouter/openai/gpt-5.5, opencode/gpt-5.5 และ ref GPT-5 อื่น ๆ ที่เข้ากันได้จะได้รับ overlay เดียวกัน โมเดล GPT-4.x ที่เก่ากว่าจะไม่ได้รับ

harness Codex แบบ native ที่รวมมาให้จะไม่ได้รับ overlay GPT-5 ของ OpenClaw นี้ผ่านคำสั่ง developer ของ Codex app-server Codex แบบ native จะคงพฤติกรรม base, model และ project-doc ที่ Codex เป็นเจ้าของไว้ ขณะที่ OpenClaw ปิด personality ในตัวของ Codex สำหรับ thread แบบ native เพื่อให้ไฟล์ personality ของ workspace agent ยังคงเป็นแหล่งอ้างอิงหลัก OpenClaw เพิ่มเฉพาะบริบท runtime เช่น การส่งผ่านช่องทาง เครื่องมือแบบไดนามิกของ OpenClaw การ delegate ผ่าน ACP บริบท workspace และ OpenClaw Skills

การเพิ่ม GPT-5 เพิ่มสัญญาพฤติกรรมแบบติดแท็กสำหรับการคงอยู่ของ persona ความปลอดภัยในการดำเนินการ วินัยการใช้เครื่องมือ รูปร่างเอาต์พุต การตรวจสอบความเสร็จสิ้น และการยืนยันบน prompt ที่ OpenClaw ประกอบขึ้นซึ่งตรงกัน พฤติกรรมการตอบกลับเฉพาะช่องทางและข้อความเงียบยังอยู่ใน system prompt ร่วมของ 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",          },        ],      },    },  },}

endpoint ของ Azure OpenAI

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

ใช้ Azure OpenAI เมื่อ:

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

การกำหนดค่า

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

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

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

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

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

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

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

เวอร์ชัน API

ตั้งค่า AZURE_OPENAI_API_VERSION เพื่อตรึงเวอร์ชัน preview หรือ GA ของ Azure สำหรับเส้นทางการสร้างภาพของ 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="A clean poster" 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

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

{  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: "strict-agentic" },    },  },}

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