OpenAI 聊天补全（HTTP）

适用范围

在以下情况使用此页面：

• 集成期望 OpenAI 聊天补全的工具

Moltbot 的网关可以提供一个小型的 OpenAI 兼容聊天补全端点。

此端点 默认禁用。首先在配置中启用它。

• POST /v1/chat/completions
• 与网关相同的端口（WS + HTTP 多路复用）：http://<gateway-host>:<port>/v1/chat/completions

在底层，请求作为正常的网关代理运行执行（与 moltbot agent 相同的代码路径）， 因此路由/权限/配置与您的网关匹配。

身份验证

使用网关身份验证配置。发送不记名令牌：

• Authorization: Bearer <token>

注意：

• 当 gateway.auth.mode="token" 时，使用 gateway.auth.token（或 MOLTBOT_GATEWAY_TOKEN）。
• 当 gateway.auth.mode="password" 时，使用 gateway.auth.password（或 MOLTBOT_GATEWAY_PASSWORD）。

选择代理

不需要自定义标头：在 OpenAI model 字段中编码代理 id：

• model: "moltbot:<agentId>"（示例："moltbot:main"、"moltbot:beta"）
• model: "agent:<agentId>"（别名）

或通过标头定位特定的 Moltbot 代理：

• x-moltbot-agent-id: <agentId>（默认：main）

高级：

• x-moltbot-session-key: <sessionKey> 以完全控制会话路由。

启用端点

将 gateway.http.endpoints.chatCompletions.enabled 设置为 true：

{
  gateway: {
    http: {
      endpoints: {
        chatCompletions: { enabled: true }
      }
    }
  }
}

禁用端点

将 gateway.http.endpoints.chatCompletions.enabled 设置为 false：

{
  gateway: {
    http: {
      endpoints: {
        chatCompletions: { enabled: false }
      }
    }
  }
}

会话行为

默认情况下，端点是 每个请求无状态的（每次调用生成新的会话键）。

如果请求包含 OpenAI user 字符串，网关会从中派生稳定的会话键，以便重复调用可以共享代理会话。

流式传输（SSE）

设置 stream: true 以接收服务器发送事件（SSE）：

• Content-Type: text/event-stream
• 每个事件行是 data: <json>
• 流以 data: [DONE] 结束

示例

非流式传输：

curl -sS http://127.0.0.1:18789/v1/chat/completions \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'x-moltbot-agent-id: main' \
  -d '{
    "model": "moltbot",
    "messages": [{"role":"user","content":"hi"}]
  }'

流式传输：

curl -N http://127.0.0.1:18789/v1/chat/completions \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -H 'x-moltbot-agent-id: main' \
  -d '{
    "model": "moltbot",
    "stream": true,
    "messages": [{"role":"user","content":"hi"}]
  }'