Skip to content
OpenClaw Docs

OpenAI

OpenAI 提供用於 GPT 模型的開發者 API，且透過 OpenAI 的 Codex 客戶端，Codex 也可作為 ChatGPT 方案的程式設計代理程式使用。OpenClaw 將這些介面分開，以便設定保持可預測。

OpenClaw 使用 openai/* 作為標準的 OpenAI 模型路由。內嵌代理預設開啟透過原生 Codex 應用程式伺服器執行時執行的 OpenAI 模型；針對圖片、嵌入、語音和即時功能等非代理 OpenAI 介面，直接 OpenAI API 金鑰驗證仍可使用。

  • 代理模型 - 透過 Codex 執行時使用的 openai/* 模型；登入 Codex 驗證以使用 ChatGPT/Codex 訂閱，或者當您有意使用 API 金鑰驗證時，設定相容 Codex 的 OpenAI API 金鑰備份。
  • 非代理 OpenAI API - 透過 OPENAI_API_KEY 或 OpenAI API 金鑰加入直接存取 OpenAI Platform，並採用隨用隨付計費。
  • 舊版設定 - openclaw doctor --fix 會將 openai-codex/* 模型參照修復為 openai/* 加上 Codex 執行時。

OpenAI 明確支援在外部工具和工作流程（如 OpenClaw）中使用訂閱 OAuth。

提供商、模型、運行時和通道是分離的層級。如果這些標籤混淆在一起，請在變更設定前先閱讀 Agent runtimes。

快速選擇

Section titled “快速選擇”
目標使用備註
使用原生 Codex 執行時的 ChatGPT/Codex 訂閱openai/gpt-5.5預設的 OpenAI 代理設定。使用 Codex 驗證登入。
代理模型的直接 API 金鑰計費openai/gpt-5.5 加上相容 Codex 的 API 金鑰設定檔使用 auth.order.openai 將備份放置在訂閱驗證之後。
透過明確 PI 的直接 API 金鑰計費openai/gpt-5.5 加上提供者/模型執行時 pi選擇一個正常的 openai API 金鑰設定檔。
最新的 ChatGPT Instant API 別名openai/chat-latest僅限直接 API 金鑰。用於實驗的變動別名，非預設值。
透過明確 PI 的 ChatGPT/Codex 訂閱驗證openai/gpt-5.5 加上提供者/模型執行時 pi為相容性路由選擇一個 openai-codex 驗證設定檔。
圖片生成或編輯openai/gpt-image-2適用於 OPENAI_API_KEY 或 OpenAI Codex OAuth。
透明背景圖片openai/gpt-image-1.5使用 outputFormat=png 或 webp 和 openai.background=transparent。

命名對照

Section titled “命名對照”

名稱相似但不可互換：

您看到的名稱層級含義
openai供應商前綴標準的 OpenAI 模型路由；代理回合使用 Codex 執行時。
openai-codex舊版驗證/設定檔前綴較舊的 OpenAI Codex OAuth/訂閱設定檔命名空間。現有的設定檔和 auth.order.openai-codex 仍然可以使用。
codex 外掛程式外掛內建的 OpenClaw 外掛程式，提供原生 Codex 應用程式伺服器執行階段和 /codex 聊天控制項。
provider/model agentRuntime.id: codex代理執行時為匹配的內嵌回合強制使用原生 Codex 應用伺服器框架。
/codex ...聊天指令集從對話中綁定/控制 Codex 應用伺服器執行緒。
runtime: "acp", agentId: "codex"ACP 會話路由透過 ACP/acpx 執行 Codex 的明確備援路徑。

這意味著組態可以刻意包含 openai/* 模型參照，而驗證設定檔仍指向 Codex 相容的認證資訊。對於新的組態，建議優先使用 auth.order.openai；現有的 openai-codex:* 設定檔和 auth.order.openai-codex 仍然受支援。openclaw doctor --fix 會將舊版的 openai-codex/* 模型參照重寫為標準的 OpenAI 模型路由。

OpenClaw 功能支援

Section titled “OpenClaw 功能支援”
OpenAI 功能OpenClaw 介面狀態
聊天 / 回應openai/<model> 模型提供者是
Codex 訂閱模型openai/<model> 搭配 openai-codex OAuth是
傳統 Codex 模型參照openai-codex/<model> 或 codex-cli/<model>由 doctor 修復至 openai/<model>
Codex app-server 掛接openai/<model> 且省略執行時或提供者/模型 agentRuntime.id: codex是
伺服器端網路搜尋原生 OpenAI Responses 工具是，當啟用網路搜尋且未釘選提供者時
圖片image_generate是
影片video_generate是
文字轉語音messages.tts.provider: "openai" / tts是
批次語音轉文字tools.media.audio / 媒體理解是
串流語音轉文字語音通話 streaming.provider: "openai"是
即時語音語音通話 realtime.provider: "openai" / 控制介面交談是
嵌入向量記憶體嵌入向量提供者是

記憶體嵌入向量

Section titled “記憶體嵌入向量”

OpenClaw 可以使用 OpenAI 或 OpenAI 相容的嵌入端點來進行 memory_search 索引和查詢嵌入：

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

對於需要非對稱嵌入標籤的 OpenAI 相容端點，請在 memorySearch 下設定 queryInputType 和 documentInputType。OpenClaw 會將這些作為提供商特定的 input_type 請求欄位進行轉發：查詢嵌入使用 queryInputType；索引記憶區塊和批次索引使用 documentInputType。請參閱 Memory configuration reference 以取得完整範例。

快速入門

Section titled “快速入門”

選擇您偏好的驗證方法並依照設定步驟操作。

最適用於： 直接 API 存取和用量計費。

  1. Get your API key

    從 OpenAI Platform 儀表板 建立或複製 API 金鑰。

  2. Run onboarding

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

    或直接傳遞金鑰：

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

  3. Verify the model is available

    Terminal window
    openclaw models list --provider openai

路由摘要

Section titled “路由摘要”
模型參考執行時期組態路由驗證
openai/gpt-5.5omitted / provider/model agentRuntime.id: "codex"Codex app-server harnessCodex 相容的 OpenAI 設定檔
openai/gpt-5.4-miniomitted / provider/model agentRuntime.id: "codex"Codex app-server harnessCodex 相容的 OpenAI 設定檔
openai/gpt-5.5provider/model agentRuntime.id: "pi"PI 嵌入式執行時期openai 設定檔或選定的 openai-codex 設定檔

組態範例

Section titled “組態範例”
{
  env: { OPENAI_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "openai/gpt-5.5" } } },
}

若要從 OpenAI API 嘗試 ChatGPT 目前的 Instant 模型，請將模型 設定為 openai/chat-latest：

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

chat-latest 是一個浮動別名。OpenAI 將其記錄為 ChatGPT 中使用的最新 Instant 模型，並建議 gpt-5.5 用於生產 API 使用，因此除非您明確想要該 別名行為，否則請將 openai/gpt-5.5 保留為穩定的預設值。該別名目前僅接受 medium 文字詳細程度，因此 OpenClaw 會針對此模型標準化不相容的 OpenAI 文字詳細程度覆寫。

原生 Codex 應用伺服器驗證

Section titled “原生 Codex 應用伺服器驗證”

原生的 Codex 應用程式伺服器配接器使用 openai/* 模型參照加上省略的 執行時設定或提供者/模型 agentRuntime.id: "codex"，但其驗證 仍基於帳戶。OpenClaw 依以下順序選擇驗證方式：

  1. 為代理程式排序的 OpenAI 驗證設定檔，最好位於 auth.order.openai 之下。現有的 openai-codex:* 設定檔和 auth.order.openai-codex 對於較舊的安裝仍然有效。
  2. 應用伺服器的現有帳戶，例如本機 Codex CLI ChatGPT 登入。
  3. 僅針對本地 stdio 應用程式伺服器啟動，當應用程式伺服器回報沒有帳戶且仍需要 OpenAI 驗證時，優先使用 CODEX_API_KEY，然後是 OPENAI_API_KEY。

這意味著本地的 ChatGPT/Codex 訂閱登入不會僅因為閘道程序也擁有用於直接 OpenAI 模型 或嵌入的 OPENAI_API_KEY 就被替換。環境變數 API 金鑰回退僅是本地 stdio 無帳戶路徑；它 不會發送到 WebSocket 應用程式伺服器連線。當選擇了訂閱風格的 Codex 設定檔時，OpenClaw 也會將 CODEX_API_KEY 和 OPENAI_API_KEY 排除在產生的 stdio 應用程式伺服器子程序之外，並透過應用程式伺服器登入 RPC 發送選定的憑證。 當該訂閱設定檔被 Codex 使用限制封鎖時，OpenClaw 可以輪替到下一個排序的 openai:* API 金鑰 設定檔，而無需變更選定的模型或退出 Codex 配接器。一旦訂閱重設時間通過，訂閱設定檔將再次符合資格。

影像生成

Section titled “影像生成”

內建的 openai 外掛程式透過 image_generate 工具註冊圖片生成功能。 它支援透過同一個 openai/gpt-image-2 模型參照進行 OpenAI API 金鑰圖片生成和 Codex OAuth 圖片 生成。

功能OpenAI API 金鑰Codex OAuth
模型引用openai/gpt-image-2openai/gpt-image-2
驗證OPENAI_API_KEYOpenAI Codex OAuth 登入
傳輸OpenAI Images APICodex Responses 後端
每次請求最大影像數44
編輯模式已啟用（最多 5 張參考影像）已啟用（最多 5 張參考影像）
尺寸覆寫支援，包括 2K/4K 尺寸支援，包括 2K/4K 尺寸
長寬比 / 解析度不轉發至 OpenAI Images API安全時對應至支援的尺寸
{
  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 輸出；目前的 gpt-image-2 API 會拒絕 background: "transparent"。

對於透明背景的要求，代理程式應呼叫帶有 model: "openai/gpt-image-1.5"、outputFormat: "png" 或 "webp" 以及 background: "transparent" 的 image_generate；較舊的 openai.background 提供者選項仍被接受。OpenClaw 也透過將預設的 openai/gpt-image-2 透明要求重寫為 gpt-image-1.5，來保護公開的 OpenAI 和 OpenAI Codex OAuth 路由；Azure 和自訂的 OpenAI 相容端點則會保留其設定的部署/模型名稱。

相同的設置也會公開用於無頭 CLI 執行：

Terminal window
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 仍可作為 OpenAI 專用的別名使用。

對於 Codex OAuth 安裝，請保留相同的 openai/gpt-image-2 參照。當設定 openai-codex OAuth 設定檔時，OpenClaw 會解析該儲存的 OAuth 存取權杖，並透過 Codex Responses 後端傳送圖片請求。它不會先嘗試 OPENAI_API_KEY 或對該請求靜默回退至 API 金鑰。當您想要改用直接的 OpenAI Images API 路由時，請使用 API 金鑰、自訂基礎 URL 或 Azure 端點明確設定 models.providers.openai。如果該自訂圖片端點位於受信任的 LAN/私人位址，也請設定 browser.ssrfPolicy.dangerouslyAllowPrivateNetwork: true；除非存在此選擇加入設定，否則 OpenClaw 會保持封鎖私人/內部 OpenAI 相容圖片端點。

生成：

/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

視訊生成

Section titled “視訊生成”

內建的 openai 外掛程式透過 video_generate 工具註冊視訊生成。

功能值
預設模型openai/sora-2
模式文字生成影片、圖片生成影片、單一影片編輯
參考輸入1 張圖片或 1 部影片
尺寸覆寫支援
其他覆寫aspectRatio、resolution、audio、watermark 將被忽略，並伴隨工具警告
{
  agents: {
    defaults: {
      videoGenerationModel: { primary: "openai/sora-2" },
    },
  },
}

GPT-5 提示詞貢獻

Section titled “GPT-5 提示詞貢獻”

OpenClaw 針對 OpenClaw 組合的提示詞介面上的 GPT-5 系列執行，新增了一個共享的 GPT-5 提示詞貢獻。它依據模型 ID 套用，因此舊版修復前的參照 (openai-codex/gpt-5.5)、openrouter/openai/gpt-5.5、opencode/gpt-5.5 以及其他相容的 GPT-5 參照都會收到相同的覆蓋內容。較舊的 GPT-4.x 模型則不會。

隨附的原生 Codex 組件不會透過 Codex 應用伺服器開發者指令接收此 OpenClaw GPT-5 覆蓋內容。原生 Codex 保留 Codex 擁有的基礎、模型、個性和專案文件行為；OpenClaw 僅貢獻執行階段內容，例如管道交付、OpenClaw 動態工具、ACP 委派、工作區內容和 OpenClaw 技能。

GPT-5 貢獻內容會為匹配的 OpenClaw 組合提示詞新增一個標記的行為契約，涵蓋角色持久性、執行安全性、工具紀律、輸出形狀、完成檢查和驗證。特定管道的回覆和無訊息行為保留在共享的 OpenClaw 系統提示詞和輸出交付原則中。友善的互動風格層則是分開且可設定的。

值效果
"friendly" (預設)啟用友善互動樣式層
"on""friendly" 的別名
"off"僅停用友善樣式層
{
  agents: {
    defaults: {
      promptOverlays: {
        gpt5: { personality: "friendly" },
      },
    },
  },
}

語音與語音合成

Section titled “語音與語音合成”
語音合成 (TTS)

隨附的 openai 外掛程式會為 messages.tts 介面註冊語音合成功能。

設定配置路徑預設值
模型messages.tts.providers.openai.modelgpt-4o-mini-tts
語音messages.tts.providers.openai.voicecoral
速度messages.tts.providers.openai.speed(未設定)
指示messages.tts.providers.openai.instructions(未設定，僅限 gpt-4o-mini-tts)
格式messages.tts.providers.openai.responseFormat語音備忘錄為 opus，檔案為 mp3
API 金鑰messages.tts.providers.openai.apiKey會回退至 OPENAI_API_KEY
基礎 URLmessages.tts.providers.openai.baseUrlhttps://api.openai.com/v1
額外內容messages.tts.providers.openai.extraBody / extra_body(未設定)

可用模型：gpt-4o-mini-tts、tts-1、tts-1-hd。可用語音：alloy、ash、ballad、cedar、coral、echo、fable、juniper、marin、onyx、nova、sage、shimmer、verse。

extraBody 會在 OpenClaw 產生的欄位之後合併到 /audio/speech 要求 JSON 中，因此請將其用於需要額外金鑰（例如 lang）的 OpenAI 相容端點。原型金鑰會被忽略。

{
  messages: {
    tts: {
      providers: {
        openai: { model: "gpt-4o-mini-tts", voice: "coral" },
      },
    },
  },
}
語音轉文字

內建的 openai 外掛程式透過 OpenClaw 的媒體理解轉錄表面註冊批次語音轉文字功能。

  • 預設模型：gpt-4o-transcribe
  • 端點：OpenAI REST /v1/audio/transcriptions
  • 輸入路徑：multipart 音訊檔案上傳
  • OpenClaw 在任何使用 tools.media.audio 進行輸入音訊轉錄的地方皆提供支援，包括 Discord 語音頻道區段和頻道音訊附件

若要強制對輸入音訊轉錄使用 OpenAI：

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

當由共享音訊媒體配置或單次轉錄請求提供時，語言和提示提示會轉送至 OpenAI。

即時轉錄

內建的 openai 外掛程式為語音通話外掛程式註冊即時轉錄功能。

設定配置路徑預設值
模型plugins.entries.voice-call.config.streaming.providers.openai.modelgpt-4o-transcribe
語言...openai.language(未設定)
提示...openai.prompt(未設定)
靜音持續時間...openai.silenceDurationMs800
VAD 臨界值...openai.vadThreshold0.5
驗證...openai.apiKey、OPENAI_API_KEY 或 openai-codex OAuthAPI 金鑰直接連線；OAuth 會產生即時轉錄用戶端密鑰
Realtime voice

內建的 openai 外掛為 Voice Call 外掛註冊即時語音功能。

設定設定路徑預設值
模型plugins.entries.voice-call.config.realtime.providers.openai.modelgpt-realtime-2
語音...openai.voicealloy
溫度 (Azure 部署橋接器)...openai.temperature0.8
VAD 臨界值...openai.vadThreshold0.5
靜音持續時間...openai.silenceDurationMs500
前綴填充...openai.prefixPaddingMs300
推理力...openai.reasoningEffort(未設定)
驗證...openai.apiKey、OPENAI_API_KEY 或 openai-codex OAuthBrowser Talk 與非 Azure 後端橋接器可使用 Codex OAuth

gpt-realtime-2 可用的內建 Realtime 語音：alloy、ash、 ballad、coral、echo、sage、shimmer、verse、marin、cedar。 OpenAI 建議使用 marin 和 cedar 以獲得最佳 Realtime 品質。這 與上述的文字轉語音語音是不同的集合；請勿假設 TTS 語音（例如 fable、nova 或 onyx）適用於 Realtime 會話。

Azure OpenAI 端點

Section titled “Azure OpenAI 端點”

內建的 openai 提供者可以透過覆寫基礎 URL，將目標設為 Azure OpenAI 資源以進行影像生成。在影像生成路徑上，OpenClaw 會偵測 models.providers.openai.baseUrl 上的 Azure 主機名稱，並自動切換至 Azure 的請求形態。

在以下情況使用 Azure OpenAI：

  • 您已經擁有 Azure OpenAI 訂閱、配額或企業合約
  • 您需要 Azure 提供的區域資料常駐或合規性控制
  • 您希望讓流量保留在現有的 Azure 租用戶內

設定

Section titled “設定”

若要透過內建的 openai 提供者進行 Azure 影像生成，請將 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
  • 使用部署範圍的路徑 (/openai/deployments/{deployment}/...)
  • 將 ?api-version=... 附加至每個請求
  • 對於 Azure 影像生成呼叫，使用 600 秒的預設請求逾時。 每次呼叫的 timeoutMs 值仍會覆寫此預設值。

其他基礎 URL（公開的 OpenAI、OpenAI 相容的 Proxy）則會保持標準的 OpenAI 影像請求格式。

API 版本

Section titled “API 版本”

設定 AZURE_OPENAI_API_VERSION 以釘選 Azure 影像生成路徑的特定 Azure 預覽版或正式發行 (GA) 版本：

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

當未設定變數時，預設值為 2024-12-01-preview。

模型名稱即為部署名稱

Section titled “模型名稱即為部署名稱”

Azure OpenAI 會將模型繫結至部署。對於透過內建的 openai 提供者路由的 Azure 影像生成請求，OpenClaw 中的 model 欄位必須是您在 Azure 入口網站中設定的 Azure 部署名稱，而非 公開的 OpenAI 模型 ID。

如果您建立名為 gpt-image-2-prod 的部署以提供 gpt-image-2：

/tool image_generate model=openai/gpt-image-2-prod prompt="A clean poster" size=1024x1024 count=1

相同的部署名稱規則也適用於透過內建的 openai 提供者路由的圖像生成呼叫。

區域可用性

Section titled “區域可用性”

Azure 圖像生成目前僅在部分區域可用（例如 eastus2、swedencentral、polandcentral、westus3、uaenorth）。在建立部署之前，請查看 Microsoft 目前的區域列表，並確認您的區域提供特定模型。

參數差異

Section titled “參數差異”

Azure OpenAI 和公開 OpenAI 並不總是接受相同的圖像參數。Azure 可能會拒絕公開 OpenAI 允許的選項（例如 gpt-image-2 上的某些 background 值），或僅在特定模型版本上公開這些選項。這些差異來自 Azure 和基礎模型，而非 OpenClaw。如果 Azure 請求因驗證錯誤而失敗，請在 Azure 入口網站中檢查您的特定部署和 API 版本支援的參數集。

進階設定

Section titled “進階設定”
傳輸 (WebSocket vs SSE)

OpenClaw 對於 openai/* 優先使用 WebSocket，並在需要時回退至 SSE ("auto")。

在 "auto" 模式下，OpenClaw：

  • 在回退至 SSE 之前會重試一次早期的 WebSocket 失敗
  • 失敗後，將 WebSocket 標記為降級約 60 秒，並在冷卻期間使用 SSE
  • 附加穩定的會話和輪次標識頭以進行重試和重新連線
  • 跨傳輸變體標準化使用計數器 (input_tokens / prompt_tokens)
數值行為
"auto" (預設)WebSocket 優先，SSE 回退
"sse"僅強制使用 SSE
"websocket"僅強制使用 WebSocket
{
  agents: {
    defaults: {
      models: {
        "openai/gpt-5.5": {
          params: { transport: "auto" },
        },
      },
    },
  },
}

相關的 OpenAI 文件：

快速模式

OpenClaw 為 openai/* 提供了一個共用的快速模式切換開關：

  • 聊天/UI： /fast status|on|off
  • 設定： `agents.defaults.models[”

/

“].params.fastMode`

啟用後，OpenClaw 會將快速模式對應至 OpenAI 優先處理 (`service_tier = "priority"`)。現有的 `service_tier` 值會被保留，且快速模式不會改寫 `reasoning` 或 `text.verbosity`。


```json5
{
  agents: {
    defaults: {
      models: {
        "openai/gpt-5.5": { params: { fastMode: true } },
      },
    },
  },
}
```
優先處理 (service_tier)

OpenAI 的 API 透過 service_tier 公開優先處理功能。在 OpenClaw 中針對每個模型進行設定：

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

支援的值：auto、default、flex、priority。

伺服器端壓縮 (Responses API)

對於直接的 OpenAI Responses 模型 (openai/* 於 api.openai.com)，OpenAI 外掛程式的 Pi-harness 串流包裝器會自動啟用伺服器端壓縮：

  • 強制執行 store: true (除非模型相容性設定了 supportsStore: false)
  • 注入 context_management: [{ type: "compaction", compact_threshold: ... }]
  • 預設 compact_threshold：contextWindow 的 70% (若無法取得則為 80000)

這適用於內建 Pi harness 路徑以及嵌入式執行所使用的 OpenAI 提供者 hooks。原生的 Codex app-server harness 透過 Codex 管理其自己的內容，並由 OpenAI 的預設代理程式路由或提供者/模型執行時期原則進行設定。

適用於相容的端點，例如 Azure OpenAI Responses：

{
  agents: {
    defaults: {
      models: {
        "azure-openai-responses/gpt-5.5": {
          params: { responsesServerCompaction: true },
        },
      },
    },
  },
}
嚴格代理式 GPT 模式

對於 openai/* 上的 GPT-5 系列執行，OpenClaw 可以使用更嚴格的嵌入式執行合約：

{
  agents: {
    defaults: {
      embeddedPi: { executionContract: "strict-agentic" },
    },
  },
}

啟用 strict-agentic 後，OpenClaw 將：

  • 不再在工具動作可用時將僅計劃的回合視為成功的進度
  • 使用立即行動導引重試該回合
  • 針對大量工作自動啟用 update_plan
  • 如果模型持續計劃而不採取行動，則顯示明確的封鎖狀態
原生路徑與 OpenAI 相容路徑

OpenClaw 會將直接連接的 OpenAI、Codex 與 Azure OpenAI 端點，與一般的 OpenAI 相容 /v1 代理伺服器區別對待：

原生路徑（openai/*、Azure OpenAI）：

  • 僅針對支援 OpenAI none 方案的模型保留 reasoning: { effort: "none" }
  • 針對拒絕 reasoning.effort: "none" 的模型或代理伺服器，省略停用的推論功能
  • 預設將工具架構設為嚴格模式
  • 僅在驗證過的原生主機上附加隱藏的歸因標頭
  • 保留 OpenAI 專用的請求修飾（service_tier、store、reasoning-compat、prompt-cache 提示）

代理伺服器/相容路徑：

  • 使用較寬鬆的相容行為
  • 從非原生的 openai-completions 載荷中移除 Completions store
  • 針對 OpenAI 相容的 Completions 代理伺服器，接受進階的 params.extra_body/params.extraBody 穿透式 JSON
  • 針對 vLLM 等與 OpenAI 相容的 Completions 代理伺服器接受 params.chat_template_kwargs
  • 不強制執行嚴格的工具架構或僅限原生的標頭

Azure OpenAI 使用原生傳輸和相容行為，但不會接收隱藏的歸因標頭。

相關

Section titled “相關”
Model selection

選擇提供者、模型參照和故障轉移行為。

Image generation

共用的影像工具參數和提供者選擇。

Video generation

共用的影片工具參數和提供者選擇。

OAuth 和 auth

Auth 詳細資訊與憑證重用規則。