chore(i18n): refresh zh-CN translations
This commit is contained in:
parent
6c246ae5c7
commit
3bb12ba2b8
@ -1,39 +1,39 @@
|
||||
---
|
||||
read_when:
|
||||
- 你想在 OpenClaw 中使用 OpenAI 模型
|
||||
- 你想使用 Codex 订阅认证,而不是 API 密钥
|
||||
- 你想使用 Codex 订阅凭证,而不是 API 密钥
|
||||
- 你需要更严格的 GPT-5 智能体执行行为
|
||||
summary: 在 OpenClaw 中使用 OpenAI API 密钥或 Codex 订阅
|
||||
summary: 在 OpenClaw 中使用 OpenAI 的 API 密钥或 Codex 订阅
|
||||
title: OpenAI
|
||||
x-i18n:
|
||||
generated_at: "2026-04-21T01:38:03Z"
|
||||
generated_at: "2026-04-21T01:47:06Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 4db510f037ec0dab5c2b419b242f182324543ad7feeaba515f71ed17f05a9486
|
||||
source_hash: 348c864a1bcdec93534dd1a08748788013abf530ac91823fa5f0deb95b20a72c
|
||||
source_path: providers/openai.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# OpenAI
|
||||
|
||||
OpenAI 提供用于 GPT 模型的开发者 API。OpenClaw 支持两种认证方式:
|
||||
OpenAI 提供用于 GPT 模型的开发者 API。OpenClaw 支持两种凭证方式:
|
||||
|
||||
- **API 密钥** — 直接访问 OpenAI Platform,并按用量计费(`openai/*` 模型)
|
||||
- **Codex 订阅** — 通过 ChatGPT/Codex 登录,并使用订阅访问(`openai-codex/*` 模型)
|
||||
- **API 密钥** — 直接访问 OpenAI Platform,并按量计费(`openai/*` 模型)
|
||||
- **Codex 订阅** — 使用 ChatGPT/Codex 登录并通过订阅访问(`openai-codex/*` 模型)
|
||||
|
||||
OpenAI 明确支持在 OpenClaw 这类外部工具和工作流中使用订阅 OAuth。
|
||||
|
||||
## 入门指南
|
||||
|
||||
选择你偏好的认证方式,并按照设置步骤操作。
|
||||
选择你偏好的凭证方式,并按步骤完成设置。
|
||||
|
||||
<Tabs>
|
||||
<Tab title="API 密钥(OpenAI Platform)">
|
||||
**最适合:** 直接 API 访问和按用量计费。
|
||||
**最适合:** 直接 API 访问和按量计费。
|
||||
|
||||
<Steps>
|
||||
<Step title="获取你的 API 密钥">
|
||||
在 [OpenAI Platform 控制台](https://platform.openai.com/api-keys) 中创建或复制一个 API 密钥。
|
||||
在 [OpenAI Platform 控制台](https://platform.openai.com/api-keys) 创建或复制 API 密钥。
|
||||
</Step>
|
||||
<Step title="运行新手引导">
|
||||
```bash
|
||||
@ -53,9 +53,9 @@ OpenAI 明确支持在 OpenClaw 这类外部工具和工作流中使用订阅 OA
|
||||
</Step>
|
||||
</Steps>
|
||||
|
||||
### 路由概览
|
||||
### 路由摘要
|
||||
|
||||
| Model ref | 路由 | 认证 |
|
||||
| Model ref | 路由 | 凭证 |
|
||||
|-----------|-------|------|
|
||||
| `openai/gpt-5.4` | 直接 OpenAI Platform API | `OPENAI_API_KEY` |
|
||||
| `openai/gpt-5.4-pro` | 直接 OpenAI Platform API | `OPENAI_API_KEY` |
|
||||
@ -74,13 +74,13 @@ OpenAI 明确支持在 OpenClaw 这类外部工具和工作流中使用订阅 OA
|
||||
```
|
||||
|
||||
<Warning>
|
||||
OpenClaw **不会** 在直接 API 路径上公开 `openai/gpt-5.3-codex-spark`。实际的 OpenAI API 请求会拒绝该模型。Spark 仅限 Codex。
|
||||
OpenClaw **不会** 在直接 API 路径上暴露 `openai/gpt-5.3-codex-spark`。实时 OpenAI API 请求会拒绝该模型。Spark 仅限 Codex。
|
||||
</Warning>
|
||||
|
||||
</Tab>
|
||||
|
||||
<Tab title="Codex 订阅">
|
||||
**最适合:** 使用你的 ChatGPT/Codex 订阅,而不是单独的 API 密钥。Codex cloud 需要 ChatGPT 登录。
|
||||
**最适合:** 使用你的 ChatGPT/Codex 订阅,而不是单独的 API 密钥。Codex 云端需要使用 ChatGPT 登录。
|
||||
|
||||
<Steps>
|
||||
<Step title="运行 Codex OAuth">
|
||||
@ -106,15 +106,15 @@ OpenAI 明确支持在 OpenClaw 这类外部工具和工作流中使用订阅 OA
|
||||
</Step>
|
||||
</Steps>
|
||||
|
||||
### 路由概览
|
||||
### 路由摘要
|
||||
|
||||
| Model ref | 路由 | 认证 |
|
||||
| Model ref | 路由 | 凭证 |
|
||||
|-----------|-------|------|
|
||||
| `openai-codex/gpt-5.4` | ChatGPT/Codex OAuth | Codex 登录 |
|
||||
| `openai-codex/gpt-5.3-codex-spark` | ChatGPT/Codex OAuth | Codex 登录(取决于 entitlement) |
|
||||
|
||||
<Note>
|
||||
这一路由与 `openai/gpt-5.4` 是有意分开的。直接 Platform 访问请使用带 API 密钥的 `openai/*`,Codex 订阅访问请使用 `openai-codex/*`。
|
||||
这一路径与 `openai/gpt-5.4` 是有意分开的。要直接访问 Platform,请将 API 密钥用于 `openai/*`;要使用 Codex 订阅访问,请使用 `openai-codex/*`。
|
||||
</Note>
|
||||
|
||||
### 配置示例
|
||||
@ -126,7 +126,7 @@ OpenAI 明确支持在 OpenClaw 这类外部工具和工作流中使用订阅 OA
|
||||
```
|
||||
|
||||
<Tip>
|
||||
如果新手引导复用了现有的 Codex CLI 登录,这些凭证将继续由 Codex CLI 管理。凭证过期后,OpenClaw 会先重新读取外部 Codex 来源,再把刷新后的凭证写回 Codex 存储。
|
||||
如果新手引导复用了现有的 Codex CLI 登录,这些凭证会继续由 Codex CLI 管理。过期后,OpenClaw 会先重新读取外部 Codex 来源,再将刷新后的凭证写回 Codex 存储。
|
||||
</Tip>
|
||||
|
||||
### 上下文窗口上限
|
||||
@ -138,7 +138,7 @@ OpenAI 明确支持在 OpenClaw 这类外部工具和工作流中使用订阅 OA
|
||||
- 原生 `contextWindow`:`1050000`
|
||||
- 默认运行时 `contextTokens` 上限:`272000`
|
||||
|
||||
实际使用中,较小的默认上限通常具有更好的延迟和质量表现。你可以通过 `contextTokens` 覆盖它:
|
||||
在实际使用中,较小的默认上限通常具有更好的延迟和质量表现。你可以通过 `contextTokens` 覆盖它:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -163,13 +163,13 @@ OpenAI 明确支持在 OpenClaw 这类外部工具和工作流中使用订阅 OA
|
||||
|
||||
内置的 `openai` 插件通过 `image_generate` 工具注册图像生成功能。
|
||||
|
||||
| 能力 | 值 |
|
||||
| Capability | Value |
|
||||
| ------------------------- | ---------------------------------- |
|
||||
| 默认模型 | `openai/gpt-image-1` |
|
||||
| 每次请求的最大图像数 | 4 |
|
||||
| 编辑模式 | 已启用(最多 5 张参考图像) |
|
||||
| 尺寸覆盖 | 支持 |
|
||||
| 宽高比 / 分辨率 | 不会转发到 OpenAI Images API |
|
||||
| 默认模型 | `openai/gpt-image-1` |
|
||||
| 每次请求的最大图像数 | 4 |
|
||||
| 编辑模式 | 已启用(最多 5 张参考图像) |
|
||||
| 尺寸覆盖 | 支持 |
|
||||
| 宽高比 / 分辨率 | 不会转发到 OpenAI Images API |
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -182,20 +182,20 @@ OpenAI 明确支持在 OpenClaw 这类外部工具和工作流中使用订阅 OA
|
||||
```
|
||||
|
||||
<Note>
|
||||
有关共享工具参数、提供商选择和故障切换行为,请参阅 [图像生成](/zh-CN/tools/image-generation)。
|
||||
有关共享工具参数、提供商选择和故障切换行为,参见 [图像生成](/zh-CN/tools/image-generation)。
|
||||
</Note>
|
||||
|
||||
## 视频生成
|
||||
|
||||
内置的 `openai` 插件通过 `video_generate` 工具注册视频生成功能。
|
||||
|
||||
| 能力 | 值 |
|
||||
| Capability | Value |
|
||||
| ---------------- | --------------------------------------------------------------------------------- |
|
||||
| 默认模型 | `openai/sora-2` |
|
||||
| 模式 | 文本生成视频、图像生成视频、单视频编辑 |
|
||||
| 参考输入 | 1 张图像或 1 个视频 |
|
||||
| 尺寸覆盖 | 支持 |
|
||||
| 其他覆盖项 | `aspectRatio`、`resolution`、`audio`、`watermark` 会被忽略,并给出工具警告 |
|
||||
| 默认模型 | `openai/sora-2` |
|
||||
| 模式 | 文本生成视频、图像生成视频、单视频编辑 |
|
||||
| 参考输入 | 1 张图像或 1 个视频 |
|
||||
| 尺寸覆盖 | 支持 |
|
||||
| 其他覆盖项 | `aspectRatio`、`resolution`、`audio`、`watermark` 会被忽略,并附带工具警告 |
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -208,20 +208,20 @@ OpenAI 明确支持在 OpenClaw 这类外部工具和工作流中使用订阅 OA
|
||||
```
|
||||
|
||||
<Note>
|
||||
有关共享工具参数、提供商选择和故障切换行为,请参阅 [视频生成](/zh-CN/tools/video-generation)。
|
||||
有关共享工具参数、提供商选择和故障切换行为,参见 [视频生成](/zh-CN/tools/video-generation)。
|
||||
</Note>
|
||||
|
||||
## GPT-5 提示词贡献
|
||||
|
||||
OpenClaw 会为 `openai/*` 和 `openai-codex/*` 的 GPT-5 系列运行添加一个 OpenAI 专用的 GPT-5 提示词贡献。它位于内置的 OpenAI 插件中,适用于 `gpt-5`、`gpt-5.2`、`gpt-5.4` 和 `gpt-5.4-mini` 等模型 id,不适用于较旧的 GPT-4.x 模型。
|
||||
OpenClaw 会为 `openai/*` 和 `openai-codex/*` 的 GPT-5 系列运行添加一个 OpenAI 专用的 GPT-5 提示词贡献。它位于内置的 OpenAI 插件中,适用于 `gpt-5`、`gpt-5.2`、`gpt-5.4` 和 `gpt-5.4-mini` 等模型 id,不适用于较早的 GPT-4.x 模型。
|
||||
|
||||
GPT-5 贡献默认会添加简洁的输出形式、工具调用和执行倾向指导。对于匹配的 GPT-5 模型,这些指导始终启用。友好交互风格层是单独的,并且可配置。
|
||||
GPT-5 提示词贡献默认会添加一组带标签的行为约定,用于约束输出形态、工具持续执行、依赖检查、并行查找、完成检查、验证和自主性。对于匹配的 GPT-5 模型,这些指导始终启用。友好交互风格层是独立的,并且可配置。
|
||||
|
||||
| 值 | 效果 |
|
||||
| ---------------------- | ------------------------------------------- |
|
||||
| `"friendly"`(默认) | 启用友好交互风格层 |
|
||||
| `"on"` | `"friendly"` 的别名 |
|
||||
| `"off"` | 仅禁用友好风格层 |
|
||||
| Value | Effect |
|
||||
| ---------------------- | ------------------------------ |
|
||||
| `"friendly"` (default) | 启用友好交互风格层 |
|
||||
| `"on"` | `"friendly"` 的别名 |
|
||||
| `"off"` | 仅禁用友好风格层 |
|
||||
|
||||
<Tabs>
|
||||
<Tab title="配置">
|
||||
@ -243,26 +243,26 @@ GPT-5 贡献默认会添加简洁的输出形式、工具调用和执行倾向
|
||||
</Tabs>
|
||||
|
||||
<Tip>
|
||||
运行时值不区分大小写,因此 `"Off"` 和 `"off"` 都会禁用友好风格层。
|
||||
这些值在运行时不区分大小写,因此 `"Off"` 和 `"off"` 都会禁用友好风格层。
|
||||
</Tip>
|
||||
|
||||
## 语音与语音处理
|
||||
|
||||
<AccordionGroup>
|
||||
<Accordion title="语音合成(TTS)">
|
||||
内置的 `openai` 插件为 `messages.tts` 接口注册了语音合成功能。
|
||||
内置的 `openai` 插件为 `messages.tts` 接口注册语音合成功能。
|
||||
|
||||
| 设置 | 配置路径 | 默认值 |
|
||||
| Setting | Config path | Default |
|
||||
|---------|------------|---------|
|
||||
| 模型 | `messages.tts.providers.openai.model` | `gpt-4o-mini-tts` |
|
||||
| 语音 | `messages.tts.providers.openai.voice` | `coral` |
|
||||
| 声音 | `messages.tts.providers.openai.voice` | `coral` |
|
||||
| 速度 | `messages.tts.providers.openai.speed` | (未设置) |
|
||||
| 指令 | `messages.tts.providers.openai.instructions` | (未设置,仅 `gpt-4o-mini-tts` 支持) |
|
||||
| 指令 | `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` |
|
||||
| Base URL | `messages.tts.providers.openai.baseUrl` | `https://api.openai.com/v1` |
|
||||
|
||||
可用模型:`gpt-4o-mini-tts`、`tts-1`、`tts-1-hd`。可用语音:`alloy`、`ash`、`ballad`、`cedar`、`coral`、`echo`、`fable`、`juniper`、`marin`、`onyx`、`nova`、`sage`、`shimmer`、`verse`。
|
||||
可用模型:`gpt-4o-mini-tts`、`tts-1`、`tts-1-hd`。可用声音:`alloy`、`ash`、`ballad`、`cedar`、`coral`、`echo`、`fable`、`juniper`、`marin`、`onyx`、`nova`、`sage`、`shimmer`、`verse`。
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -277,15 +277,15 @@ GPT-5 贡献默认会添加简洁的输出形式、工具调用和执行倾向
|
||||
```
|
||||
|
||||
<Note>
|
||||
设置 `OPENAI_TTS_BASE_URL` 可以覆盖 TTS 的 Base URL,而不会影响聊天 API 端点。
|
||||
设置 `OPENAI_TTS_BASE_URL` 可覆盖 TTS 的 Base URL,而不会影响聊天 API 端点。
|
||||
</Note>
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="实时转录">
|
||||
内置的 `openai` 插件为语音通话插件注册了实时转录功能。
|
||||
<Accordion title="实时转写">
|
||||
内置的 `openai` 插件为 Voice Call 插件注册实时转写功能。
|
||||
|
||||
| 设置 | 配置路径 | 默认值 |
|
||||
| Setting | Config path | Default |
|
||||
|---------|------------|---------|
|
||||
| 模型 | `plugins.entries.voice-call.config.streaming.providers.openai.model` | `gpt-4o-transcribe` |
|
||||
| 静音时长 | `...openai.silenceDurationMs` | `800` |
|
||||
@ -293,18 +293,18 @@ GPT-5 贡献默认会添加简洁的输出形式、工具调用和执行倾向
|
||||
| API 密钥 | `...openai.apiKey` | 回退到 `OPENAI_API_KEY` |
|
||||
|
||||
<Note>
|
||||
使用 WebSocket 连接到 `wss://api.openai.com/v1/realtime`,并采用 G.711 u-law 音频。
|
||||
使用 WebSocket 连接到 `wss://api.openai.com/v1/realtime`,并使用 G.711 u-law 音频。
|
||||
</Note>
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="实时语音">
|
||||
内置的 `openai` 插件为语音通话插件注册了实时语音功能。
|
||||
内置的 `openai` 插件为 Voice Call 插件注册实时语音功能。
|
||||
|
||||
| 设置 | 配置路径 | 默认值 |
|
||||
| Setting | Config path | Default |
|
||||
|---------|------------|---------|
|
||||
| 模型 | `plugins.entries.voice-call.config.realtime.providers.openai.model` | `gpt-realtime` |
|
||||
| 语音 | `...openai.voice` | `alloy` |
|
||||
| 声音 | `...openai.voice` | `alloy` |
|
||||
| Temperature | `...openai.temperature` | `0.8` |
|
||||
| VAD 阈值 | `...openai.vadThreshold` | `0.5` |
|
||||
| 静音时长 | `...openai.silenceDurationMs` | `500` |
|
||||
@ -320,18 +320,18 @@ GPT-5 贡献默认会添加简洁的输出形式、工具调用和执行倾向
|
||||
## 高级配置
|
||||
|
||||
<AccordionGroup>
|
||||
<Accordion title="传输协议(WebSocket 与 SSE)">
|
||||
OpenClaw 对 `openai/*` 和 `openai-codex/*` 都采用优先 WebSocket、回退 SSE(`"auto"`)的方式。
|
||||
<Accordion title="传输方式(WebSocket 与 SSE)">
|
||||
对于 `openai/*` 和 `openai-codex/*`,OpenClaw 都默认优先使用 WebSocket,并在失败时回退到 SSE(`"auto"`)。
|
||||
|
||||
在 `"auto"` 模式下,OpenClaw 会:
|
||||
- 在回退到 SSE 之前,重试一次早期 WebSocket 失败
|
||||
- 失败后,将 WebSocket 标记为降级约 60 秒,并在冷却期间使用 SSE
|
||||
- 为重试和重连附加稳定的会话和轮次标识头
|
||||
- 在不同传输变体之间规范化用量计数器(`input_tokens` / `prompt_tokens`)
|
||||
- 发生失败后,将 WebSocket 标记为降级约 60 秒,并在冷却期间使用 SSE
|
||||
- 为重试和重连附加稳定的会话与轮次标识头
|
||||
- 在不同传输变体之间统一使用量计数器(`input_tokens` / `prompt_tokens`)
|
||||
|
||||
| 值 | 行为 |
|
||||
| Value | Behavior |
|
||||
|-------|----------|
|
||||
| `"auto"`(默认) | 优先 WebSocket,回退到 SSE |
|
||||
| `"auto"` (default) | 优先 WebSocket,失败时回退到 SSE |
|
||||
| `"sse"` | 仅强制使用 SSE |
|
||||
| `"websocket"` | 仅强制使用 WebSocket |
|
||||
|
||||
@ -356,7 +356,7 @@ GPT-5 贡献默认会添加简洁的输出形式、工具调用和执行倾向
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="WebSocket 预热">
|
||||
OpenClaw 默认对 `openai/*` 启用 WebSocket 预热,以降低首轮延迟。
|
||||
对于 `openai/*`,OpenClaw 默认启用 WebSocket 预热,以减少首轮延迟。
|
||||
|
||||
```json5
|
||||
// 禁用预热
|
||||
@ -376,12 +376,12 @@ GPT-5 贡献默认会添加简洁的输出形式、工具调用和执行倾向
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="快速模式">
|
||||
OpenClaw 为 `openai/*` 和 `openai-codex/*` 提供共享的快速模式开关:
|
||||
OpenClaw 为 `openai/*` 和 `openai-codex/*` 提供了一个共享的快速模式开关:
|
||||
|
||||
- **聊天 / UI:** `/fast status|on|off`
|
||||
- **配置:** `agents.defaults.models["<provider>/<model>"].params.fastMode`
|
||||
|
||||
启用后,OpenClaw 会将快速模式映射为 OpenAI 优先处理(`service_tier = "priority"`)。现有的 `service_tier` 值会被保留,快速模式不会改写 `reasoning` 或 `text.verbosity`。
|
||||
启用后,OpenClaw 会将快速模式映射为 OpenAI 的优先处理(`service_tier = "priority"`)。现有的 `service_tier` 值会被保留,快速模式也不会重写 `reasoning` 或 `text.verbosity`。
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -397,13 +397,13 @@ GPT-5 贡献默认会添加简洁的输出形式、工具调用和执行倾向
|
||||
```
|
||||
|
||||
<Note>
|
||||
会话覆盖优先于配置。在 Sessions UI 中清除会话覆盖后,该会话会恢复为配置的默认值。
|
||||
会话覆盖优先于配置。在 Sessions UI 中清除会话覆盖后,会话会恢复为配置中的默认值。
|
||||
</Note>
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="优先处理(service_tier)">
|
||||
OpenAI 的 API 通过 `service_tier` 提供优先处理能力。你可以在 OpenClaw 中按模型设置它:
|
||||
OpenAI 的 API 通过 `service_tier` 提供优先处理能力。你可以在 OpenClaw 中按模型设置:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -421,21 +421,21 @@ GPT-5 贡献默认会添加简洁的输出形式、工具调用和执行倾向
|
||||
支持的值:`auto`、`default`、`flex`、`priority`。
|
||||
|
||||
<Warning>
|
||||
`serviceTier` 仅会转发到原生 OpenAI 端点(`api.openai.com`)和原生 Codex 端点(`chatgpt.com/backend-api`)。如果你通过代理路由任一提供商,OpenClaw 会保持 `service_tier` 不变。
|
||||
`serviceTier` 只会转发到原生 OpenAI 端点(`api.openai.com`)和原生 Codex 端点(`chatgpt.com/backend-api`)。如果你通过代理路由任一提供商,OpenClaw 会保持 `service_tier` 不变。
|
||||
</Warning>
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="服务器端压缩(Responses API)">
|
||||
对于直接 OpenAI Responses 模型(位于 `api.openai.com` 上的 `openai/*`),OpenClaw 会自动启用服务器端压缩:
|
||||
<Accordion title="服务端压缩(Responses API)">
|
||||
对于直接使用 OpenAI Responses 模型(`api.openai.com` 上的 `openai/*`),OpenClaw 会自动启用服务端压缩:
|
||||
|
||||
- 强制设置 `store: true`(除非模型兼容性将 `supportsStore: false`)
|
||||
- 强制设置 `store: true`(除非模型兼容性设置了 `supportsStore: false`)
|
||||
- 注入 `context_management: [{ type: "compaction", compact_threshold: ... }]`
|
||||
- 默认 `compact_threshold`:`contextWindow` 的 70%(如果不可用则为 `80000`)
|
||||
- 默认 `compact_threshold`:`contextWindow` 的 70%(不可用时为 `80000`)
|
||||
|
||||
<Tabs>
|
||||
<Tab title="显式启用">
|
||||
对 Azure OpenAI Responses 这类兼容端点很有用:
|
||||
适用于 Azure OpenAI Responses 这类兼容端点:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -487,13 +487,13 @@ GPT-5 贡献默认会添加简洁的输出形式、工具调用和执行倾向
|
||||
</Tabs>
|
||||
|
||||
<Note>
|
||||
`responsesServerCompaction` 仅控制 `context_management` 注入。直接 OpenAI Responses 模型仍会强制设置 `store: true`,除非兼容性将 `supportsStore: false`。
|
||||
`responsesServerCompaction` 仅控制 `context_management` 的注入。直接 OpenAI Responses 模型仍会强制设置 `store: true`,除非兼容性设置了 `supportsStore: false`。
|
||||
</Note>
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="严格智能体式 GPT 模式">
|
||||
对于 `openai/*` 和 `openai-codex/*` 上的 GPT-5 系列运行,OpenClaw 可以使用更严格的内嵌执行契约:
|
||||
<Accordion title="严格智能体 GPT 模式">
|
||||
对于 `openai/*` 和 `openai-codex/*` 上的 GPT-5 系列运行,OpenClaw 可以使用更严格的嵌入式执行约定:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -506,29 +506,29 @@ GPT-5 贡献默认会添加简洁的输出形式、工具调用和执行倾向
|
||||
```
|
||||
|
||||
使用 `strict-agentic` 时,OpenClaw 会:
|
||||
- 当工具操作可用时,不再将仅计划的轮次视为成功推进
|
||||
- 通过立即行动的引导重试该轮次
|
||||
- 对于实质性工作自动启用 `update_plan`
|
||||
- 如果模型持续规划而不行动,则显示明确的受阻状态
|
||||
- 当工具操作可用时,不再将仅规划的轮次视为成功推进
|
||||
- 使用“立即行动”的引导重试该轮次
|
||||
- 对于较大的工作自动启用 `update_plan`
|
||||
- 如果模型持续只做规划而不行动,则显式显示阻塞状态
|
||||
|
||||
<Note>
|
||||
仅适用于 OpenAI 和 Codex 的 GPT-5 系列运行。其他提供商和较旧的模型系列会保持默认行为。
|
||||
仅适用于 OpenAI 和 Codex 的 GPT-5 系列运行。其他提供商和较旧的模型系列仍保持默认行为。
|
||||
</Note>
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="原生路由与 OpenAI-compatible 路由">
|
||||
OpenClaw 会区别对待直接 OpenAI、Codex 和 Azure OpenAI 端点,以及通用 OpenAI-compatible `/v1` 代理:
|
||||
OpenClaw 会将直接 OpenAI、Codex 和 Azure OpenAI 端点,与通用的 OpenAI-compatible `/v1` 代理区别对待:
|
||||
|
||||
**原生路由**(`openai/*`、`openai-codex/*`、Azure OpenAI):
|
||||
- 当明确禁用推理时,保留 `reasoning: { effort: "none" }`
|
||||
- 当显式禁用推理时,保留 `reasoning: { effort: "none" }`
|
||||
- 默认将工具 schema 设为严格模式
|
||||
- 仅在已验证的原生主机上附加隐藏归因头
|
||||
- 保留 OpenAI 专用的请求整形(`service_tier`、`store`、reasoning 兼容性、提示缓存提示)
|
||||
- 保留 OpenAI 专属的请求整形(`service_tier`、`store`、reasoning 兼容性、提示词缓存提示)
|
||||
|
||||
**代理 / 兼容路由:**
|
||||
- 使用更宽松的兼容行为
|
||||
- 不会强制使用严格工具 schema 或原生专用请求头
|
||||
- 不强制严格工具 schema 或原生专属头
|
||||
|
||||
Azure OpenAI 使用原生传输和兼容行为,但不会接收隐藏归因头。
|
||||
|
||||
@ -547,7 +547,7 @@ GPT-5 贡献默认会添加简洁的输出形式、工具调用和执行倾向
|
||||
<Card title="视频生成" href="/zh-CN/tools/video-generation" icon="video">
|
||||
共享视频工具参数和提供商选择。
|
||||
</Card>
|
||||
<Card title="OAuth 和认证" href="/zh-CN/gateway/authentication" icon="key">
|
||||
认证细节和凭证复用规则。
|
||||
<Card title="OAuth 和凭证" href="/zh-CN/gateway/authentication" icon="key">
|
||||
凭证细节和凭证复用规则。
|
||||
</Card>
|
||||
</CardGroup>
|
||||
|
||||
Loading…
Reference in New Issue
Block a user