Docs: update zh-CN translations and pipeline

What:
- update zh-CN glossary, TM, and translator prompt
- regenerate zh-CN docs and apply targeted fixes
- add zh-CN AGENTS pipeline guidance

Why:
- address terminology/spacing feedback from #6995

Tests:
- pnpm build && pnpm check && pnpm test
This commit is contained in:
Josh Palmer
2026-02-03 13:23:00 -08:00
parent 9f03791aa9
commit a3ec2d0734
228 changed files with 10651 additions and 10475 deletions
+20 -20
View File
@@ -1,53 +1,53 @@
---
read_when:
- 集成需要 OpenAI Chat Completions 的工具
summary: 从 Gateway网关暴露一个兼容 OpenAI 的 /v1/chat/completions HTTP 端点
summary: 从 Gateway 网关暴露 OpenAI 兼容的 /v1/chat/completions HTTP 端点
title: OpenAI Chat Completions
x-i18n:
generated_at: "2026-02-01T20:35:14Z"
generated_at: "2026-02-03T07:48:15Z"
model: claude-opus-4-5
provider: pi
source_hash: 6f935777f489bff925a3bf18b1e4b7493f83ae7b1e581890092e5779af59b732
source_path: gateway/openai-http-api.md
workflow: 14
workflow: 15
---
# OpenAI Chat Completions (HTTP)
# OpenAI Chat CompletionsHTTP
OpenClaw 的 Gateway网关可以提供一个小型的兼容 OpenAI Chat Completions 端点。
OpenClaw 的 Gateway 网关可以提供一个小型的 OpenAI 兼容 Chat Completions 端点。
此端点**默认禁用**。请先在配置中启用它。
- `POST /v1/chat/completions`
- 与 Gateway网关使用相同端口(WS + HTTP 多路复用):`http://<gateway-host>:<port>/v1/chat/completions`
- 与 Gateway 网关相同端口(WS + HTTP 多路复用):`http://<gateway-host>:<port>/v1/chat/completions`
底层,请求作为普通的 Gateway网关智能体运行执行(与 `openclaw agent` 相同的代码路径),因此路由/权限/配置与你的 Gateway网关保持一致。
底层实现中,请求作为普通的 Gateway 网关智能体运行执行(与 `openclaw agent` 相同的代码路径),因此路由/权限/配置与你的 Gateway 网关一致。
## 认证
使用 Gateway网关认证配置。发送 Bearer 令牌:
使用 Gateway 网关认证配置。发送 bearer 令牌:
- `Authorization: Bearer <token>`
注意:
注意事项
-`gateway.auth.mode="token"` 时,使用 `gateway.auth.token`(或 `OPENCLAW_GATEWAY_TOKEN`)。
-`gateway.auth.mode="password"` 时,使用 `gateway.auth.password`(或 `OPENCLAW_GATEWAY_PASSWORD`)。
## 选择智能体
无需自定义请求头:在 OpenAI `model` 字段中编码智能体 ID
无需自定义头:在 OpenAI `model` 字段中编码智能体 ID
- `model: "openclaw:<agentId>"`例:`"openclaw:main"``"openclaw:beta"`
- `model: "openclaw:<agentId>"`(例`"openclaw:main"``"openclaw:beta"`
- `model: "agent:<agentId>"`(别名)
或通过请求头指定特定的 OpenClaw 智能体:
或通过头指定特定的 OpenClaw 智能体:
- `x-openclaw-agent-id: <agentId>`(默认`main`
- `x-openclaw-agent-id: <agentId>`(默认:`main`
高级用法
高级选项
- `x-openclaw-session-key: <sessionKey>` 用于完全控制会话路由。
- `x-openclaw-session-key: <sessionKey>` 完全控制会话路由。
## 启用端点
@@ -83,16 +83,16 @@ OpenClaw 的 Gateway网关可以提供一个小型的兼容 OpenAI 的 Chat Comp
## 会话行为
默认情况下,端点**每请求无状态**(每次调用生成一个新的会话密钥)。
默认情况下,端点**每请求无状态**(每次调用生成新的会话)。
如果请求包含 OpenAI `user` 字符串,Gateway网关会根据它派生一个稳定的会话密钥,这样重复调用可以共享同一个智能体会话。
如果请求包含 OpenAI `user` 字符串,Gateway 网关会从中派生一个稳定的会话键,因此重复调用可以共享智能体会话。
## 流式传输 (SSE)
## 流式传输SSE
设置 `stream: true` 以接收服务器发送事件 (SSE)
设置 `stream: true` 以接收 Server-Sent EventsSSE
- `Content-Type: text/event-stream`
- 每个事件行格式为 `data: <json>`
- 每个事件行 `data: <json>`
- 流以 `data: [DONE]` 结束
## 示例