82 lines
2.7 KiB
Markdown
82 lines
2.7 KiB
Markdown
# Council Plan — openclaw-claude-code MiniMax 路由补丁设计
|
||
|
||
> Round 1 — 2026-04-14
|
||
> Branch: council/PM → main
|
||
> 状态：**规划中**
|
||
|
||
---
|
||
|
||
## 任务背景
|
||
|
||
**问题**：插件 `@enderfga/openclaw-claude-code` 的 proxy 层将 Claude Code 请求路由到各 AI Provider，目前所有 `sonnet`/`opus`/`haiku` 模型都被硬编码映射到 `provider: 'anthropic'`（走真实 Anthropic API），但用户环境是 MiniMax 的 Anthropic 兼容端点，导致路由失效。
|
||
|
||
**目标**：设计一个可配置、符合 OpenClaw 插件最佳实践的方案。
|
||
|
||
---
|
||
|
||
## 4 Q 任务分配
|
||
|
||
| Q | 任务描述 | Owner | 预期输出 |
|
||
|---|---|---|---|
|
||
| Q1 | 插件 proxy handler 如何优雅地读取 provider URL 配置？ | council/Backend | 配置读取方案（环境变量 / OpenClaw config / 插件独立配置） |
|
||
| Q2 | models.js 的 provider 映射如何支持配置覆盖？ | council/Architect | 架构设计（外部配置注入机制） |
|
||
| Q3 | 配置项应该放在 OpenClaw 配置的哪个 section？命名规范？ | council/PM | 配置结构建议（providers/defaults/ext 位置） |
|
||
| Q4 | 综合推荐方案（配置文件结构、修改文件列表、回滚步骤、注释） | council/Architect | 最终方案文档 |
|
||
|
||
---
|
||
|
||
## 原则
|
||
|
||
1. **配置优先**：从 OpenClaw 配置或环境变量读取，不硬编码
|
||
2. **向后兼容**：不配置默认走原有逻辑（Anthropic 官方）
|
||
3. **可还原**：通过 OpenClaw 配置层注入，不改 node_modules
|
||
4. **显眼易懂**：配置项有注释说明
|
||
|
||
---
|
||
|
||
## 关键参考
|
||
|
||
OpenClaw 配置示例（`~/.openclaw/openclaw.json`）：
|
||
```json
|
||
{
|
||
"providers": {
|
||
"minimax-portal": {
|
||
"baseUrl": "https://api.minimaxi.com/anthropic",
|
||
"apiKey": "minimax-oauth",
|
||
"api": "anthropic-messages"
|
||
}
|
||
},
|
||
"defaults": {
|
||
"model": { "primary": "minimax-portal/MiniMax-M2.7" }
|
||
}
|
||
}
|
||
```
|
||
|
||
插件文件：
|
||
- proxy handler: `node_modules/@enderfga/openclaw-claude-code/dist/src/proxy/handler.js`
|
||
- 模型注册表: `node_modules/@enderfga/openclaw-claude-code/dist/src/models.js`
|
||
|
||
---
|
||
|
||
## Claim Status
|
||
|
||
| Task | Owner | Status |
|
||
|---|---|---|
|
||
| Q1: 配置读取方案 | council/Backend | `[Claimed: council/Backend]` |
|
||
| Q2: 架构设计 | council/Architect | `[Claimed: council/Architect]` |
|
||
| Q3: 配置结构 | council/PM | `[Claimed: council/PM]` |
|
||
| Q4: 综合方案 | council/Architect | `[Pending]` |
|
||
|
||
---
|
||
|
||
## Phase Breakdown
|
||
|
||
| Phase | 内容 | 目标时间 |
|
||
|---|---|---|
|
||
| **Draft** (本轮) | Backend/Architect/PM 分别输出 Q1-Q3 讨论结论 | Round 1 |
|
||
| **Review** | 交叉评审，Architect 整合 Q4 综合方案 | Round 2 |
|
||
| **Finalize** | 合并到 main，投票 | Round 2 |
|
||
|
||
---
|
||
|
||
**[CONSENSUS: NO]** — Round 1 规划完成，等待 Backend/Architect/PM 执行 Q1-Q3 |