OpenAI

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

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

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

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

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

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

# แผนที่ชื่อ

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

ซึ่งหมายความว่า config หนึ่งสามารถตั้งใจมีทั้ง refs โมเดล openai/* และโปรไฟล์การยืนยันตัวตน openai-codex ได้ openclaw doctor --fix จะเขียน refs โมเดลเดิม openai-codex/* ใหม่เป็นเส้นทางโมเดล OpenAI มาตรฐาน

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

# Embeddings ของหน่วยความจำ

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

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

สำหรับ endpoints ที่เข้ากันได้กับ 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: "sk-..." },
  agents: { defaults: { model: { primary: "openai/gpt-5.5" } } },
}

{
  env: { OPENAI_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "openai/chat-latest" } } },
}

openclaw onboard --auth-choice openai-codex

openclaw models auth login --provider openai-codex

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

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

openclaw models list --provider openai-codex

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

openclaw models status
openclaw models auth list --provider openai-codex
openclaw config get agents.defaults.model --json
openclaw config get agents.defaults.agentRuntime --json

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

openclaw doctor --fix
openclaw config validate

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

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

# การยืนยันตัวตน app-server Codex ดั้งเดิม

ชุดควบคุม app-server Codex ดั้งเดิมใช้อ้างอิงโมเดล openai/* พร้อมกับ การละเว้นการกำหนดค่า runtime หรือ agentRuntime.id: "codex" แต่การยืนยันตัวตนยังคง อิงตามบัญชี OpenClaw เลือกการยืนยันตัวตนตามลำดับนี้:

1. โปรไฟล์การยืนยันตัวตน openai-codex ของ OpenClaw ที่ผูกกับเอเจนต์อย่างชัดเจน.
2. บัญชีที่มีอยู่ของ app-server เช่น การลงชื่อเข้าใช้ ChatGPT ของ Codex CLI ในเครื่อง.
3. สำหรับการเปิด app-server แบบ local stdio เท่านั้น ให้ใช้ CODEX_API_KEY แล้วจึง OPENAI_API_KEY เมื่อ app-server รายงานว่าไม่มีบัญชีและยังต้องใช้ การยืนยันตัวตน OpenAI.

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

# การสร้างภาพ

Plugin openai ที่รวมมาให้ลงทะเบียนการสร้างภาพผ่านเครื่องมือ image_generate. รองรับทั้งการสร้างภาพด้วย OpenAI API-key และการสร้างภาพด้วย Codex OAuth ผ่านอ้างอิงโมเดล 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"; ตัวเลือก provider openai.background รุ่นเก่า ยังคงยอมรับ OpenClaw ยังปกป้องเส้นทาง OpenAI สาธารณะและ OpenAI Codex OAuth โดยเขียนคำขอโปร่งใส openai/gpt-image-2 เริ่มต้นใหม่ เป็น gpt-image-1.5; Azure และ endpoint แบบกำหนดเองที่เข้ากันได้กับ OpenAI จะคง ชื่อ deployment/โมเดลที่กำหนดค่าไว้.

การตั้งค่าเดียวกันนี้เปิดเผยสำหรับการรัน CLI แบบ headless ด้วย:

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.

สำหรับการติดตั้ง Codex OAuth ให้ใช้อ้างอิง openai/gpt-image-2 เดิม เมื่อมีการกำหนดค่า โปรไฟล์ OAuth openai-codex OpenClaw จะ resolve โทเค็นการเข้าถึง OAuth ที่เก็บไว้และส่งคำขอภาพผ่าน backend Codex Responses โดยจะไม่ลองใช้ OPENAI_API_KEY ก่อนหรือ fallback เป็น API key อย่างเงียบๆ สำหรับคำขอนั้น กำหนดค่า models.providers.openai อย่างชัดเจนด้วย API key, URL ฐานแบบกำหนดเอง หรือ Azure endpoint เมื่อคุณต้องการเส้นทาง OpenAI Images API โดยตรงแทน. หาก endpoint ภาพแบบกำหนดเองนั้นอยู่บน LAN/ที่อยู่ส่วนตัวที่เชื่อถือได้ ให้ตั้งค่า browser.ssrfPolicy.dangerouslyAllowPrivateNetwork: true ด้วย; OpenClaw จะยังคง บล็อก endpoint ภาพที่เข้ากันได้กับ OpenAI แบบส่วนตัว/ภายใน เว้นแต่จะมี 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.

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

# การมีส่วนร่วมพรอมป์ GPT-5

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

ชุดควบคุม Codex ดั้งเดิมที่รวมมาให้ใช้พฤติกรรม GPT-5 และ overlay Heartbeat เดียวกันผ่านคำสั่งสำหรับนักพัฒนาของ app-server Codex ดังนั้นเซสชัน openai/gpt-5.x ที่ถูกบังคับผ่าน agentRuntime.id: "codex" จะยังคงคำแนะนำเรื่องการติดตามงานให้จบและ Heartbeat เชิงรุกแบบเดิม แม้ว่า Codex จะเป็นเจ้าของส่วนที่เหลือของพรอมป์ชุดควบคุม.

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

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

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

# เสียงและคำพูด

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

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

# Endpoint ของ Azure OpenAI

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

ใช้ Azure OpenAI เมื่อ:

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

# การกำหนดค่า

สำหรับการสร้างรูปภาพ 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 จะรู้จัก suffix ของ host Azure ต่อไปนี้สำหรับ route การสร้างรูปภาพของ Azure:

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

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

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

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

# เวอร์ชัน API

ตั้งค่า AZURE_OPENAI_API_VERSION เพื่อ pin เวอร์ชัน preview หรือ GA ของ Azure ที่เฉพาะเจาะจง สำหรับพาธการสร้างรูปภาพของ Azure:

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

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

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

Azure OpenAI ผูกโมเดลกับ deployment สำหรับคำขอสร้างรูปภาพของ Azure ที่ route ผ่านผู้ให้บริการ openai ที่รวมมาให้ ฟิลด์ model ใน OpenClaw ต้องเป็น ชื่อ deployment ของ Azure ที่คุณกำหนดค่าใน Azure portal ไม่ใช่ 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 เดียวกันนี้ใช้กับการเรียกสร้างรูปภาพที่ route ผ่าน ผู้ให้บริการ openai ที่รวมมาให้

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

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

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

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

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

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

// Disable warm-up
{
  agents: {
    defaults: {
      models: {
        "openai/gpt-5.5": {
          params: { openaiWsWarmup: false },
        },
      },
    },
  },
}

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

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

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