Skip to content

Commit c5cec17

Browse files
committed
docs(contentpipe): document agent-first gateway routing
1 parent 57463b2 commit c5cec17

2 files changed

Lines changed: 9 additions & 3 deletions

File tree

README.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -279,6 +279,10 @@ your-openclaw-workspace/
279279

280280
ContentPipe 通过 Gateway 的 `/v1/chat/completions` 端点调用 LLM。如果你的 Gateway 是默认配置,**这个端点可能没有启用**
281281

282+
> 新版 Gateway(2026.3.24+)采用 **agent-first model contract**
283+
> - 请求体 `model` 应传 `openclaw/<agentId>``openclaw/default`
284+
> - 具体 provider/model(如 `dashscope/qwen3.5-plus`)应放在 `x-openclaw-model` header
285+
282286
检查方法:
283287
```bash
284288
curl -s -o /dev/null -w "%{http_code}" http://localhost:18789/v1/chat/completions

docs/ARCHITECTURE.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -38,15 +38,16 @@
3838
├─────────────────────────────────────────────────────────┤
3939
│ LLM Gateway │
4040
│ OpenClaw Gateway (localhost:18789) │
41-
provider models + explicit blank-agent routing
41+
agent-first model contract + explicit blank-agent 路由
4242
└─────────────────────────────────────────────────────────┘
4343
```
4444

4545
### 2.1 blank-agent 执行平面(v0.7.1)
4646

4747
为降低 OpenClaw 常规 agent 提示词/工作区污染,Gateway 模式下新增一条显式执行平面:
4848

49-
- ContentPipe 通过 `x-openclaw-agent-id: contentpipe-blank` 路由到空白 agent
49+
- ContentPipe 通过 OpenAI-compatible `model: openclaw/contentpipe-blank` 路由到空白 agent
50+
- 若节点声明具体底层模型(如 `dashscope/qwen3.5-plus`),则通过 `x-openclaw-model` 传递 backend model override
5051
- 同时保留独立 `x-openclaw-session-key`,保证每个 run / node 的上下文隔离
5152
- blank-agent 的职责是承载节点的**正式产物修改**(初始执行 + 后续审核追问)
5253
- 节点收到命令后先自行执行任务并尝试修改自己的正式产物文件
@@ -99,7 +100,8 @@ output/runs/{run_id}/
99100
典型 Gateway 路由键:
100101

101102
```text
102-
x-openclaw-agent-id: contentpipe-blank
103+
model: openclaw/contentpipe-blank
104+
x-openclaw-model: dashscope/qwen3.5-plus
103105
x-openclaw-session-key: contentpipe:{run_id}:{node_id}:main
104106
```
105107

0 commit comments

Comments
 (0)