openclaw-trapi-config/README.md

openclaw-trapi-config

用于配置和维护传米科技 trapi 自定义 Provider 的 OpenClaw Skill，支持首次安装、模型增量更新、别名、图像模型、静态验证和故障排查。

服务信息

项目	值
Provider ID	trapi
Base URL	https://lapi.transiglobal.com
API Key 环境变量	TRAPI_API_KEY
默认 API 适配器	anthropic-messages
GPT 模型适配器	openai-responses

trapi 支持模型级 API 适配器，不要求所有模型统一使用 Anthropic Messages。

预置模型

模型 ID	别名	API	输入	上下文	最大输出
GLM-5-Turbo	glm5t	anthropic-messages	文本	200K	64K
GLM-5.2	glm52	anthropic-messages	文本	200K	64K
GLM-4.5-Air	glm45a	anthropic-messages	文本	200K	64K
MiniMax-M2	mxm2	anthropic-messages	文本	200K	64K
MiniMax-M2.7	mxm27	anthropic-messages	文本	200K	64K
MiniMax-M3	mxm3	anthropic-messages	文本、图片	1M	131K
kimi-for-coding	kimi	anthropic-messages	文本、图片	262K	32K
GLM-5V-Turbo	glm5v	anthropic-messages	文本、图片	200K	64K
PaddleOCR-VL-1.5	pocr	anthropic-messages	文本、图片	131K	8K
deepseek-v4-pro	dsv4p	anthropic-messages	文本	1M	384K
deepseek-v4-flash	dsv4f	anthropic-messages	文本	1M	384K
gpt-5.5	gpt55	openai-responses	文本	200K	65K
gpt-5.6-sol	g56s	openai-responses	文本、图片	372K	128K
gpt-5.6-terra	g56t	openai-responses	文本、图片	372K	128K
gpt-5.6-luna	g56l	openai-responses	文本、图片	372K	128K
mimo-v2.5-pro	mimo25p	anthropic-messages	文本	200K	64K
mimo-v2.5	mimo25	anthropic-messages	文本、图片、视频、音频	200K	64K
claude-opus-4.7	opus47	anthropic-messages	文本	300K	64K
qwen3.7-max	qwn37	anthropic-messages	文本	1M	100K
qwen3.6-plus	qwn36	anthropic-messages	文本、图片	1M	100K

模型目录不设置 reasoning 字段，费用元数据暂时全部保持为 0。

使用方式

在 OpenClaw 对话中说：

配置 trapi

Skill 会执行以下流程：

1. 检查 OpenClaw 版本、Schema 和现有 trapi 配置。
2. 对照预置目录生成新增、更新、保留和额外模型差异。
3. 保留已有认证；首次配置时优先使用 TRAPI_API_KEY SecretRef。
4. 展示变更方案，获得确认后使用 CLI --merge 安全增量写入。
5. 注册缺失别名，并按需配置 imageModel。
6. 执行配置、模型、别名和 Gateway 静态验证。
7. 经用户确认后，只对本次变更模型执行最小实时调用。

不会使用不完整的 gateway config.patch 覆盖模型数组，也不会自动删除目录外模型、覆盖默认模型或重写已有 imageModel。

切换模型

在对话中使用 /model <alias>：

/model glm5t
/model mxm3
/model g56s
/model g56t
/model g56l

不能直接使用 /<alias> 切换模型。

图像模型

建议链仅引用已配置且认证可用的 trapi 模型：

1. trapi/kimi-for-coding
2. trapi/qwen3.6-plus
3. trapi/mimo-v2.5
4. trapi/GLM-5V-Turbo
5. trapi/MiniMax-M3

Skill 默认保留现有 imageModel；只有用户明确要求，或当前未配置且用户接受建议时才写入。

安全说明

• 不在聊天、命令参数、日志或文档中回显 API Key。
• 优先使用环境变量 SecretRef，不把真实 Key 明文写入 openclaw.json。
• 所有持久配置变更先展示差异并等待确认。
• 不使用 --replace 绕过 OpenClaw 的配置防覆盖保护。
• 不默认调用付费模型；实时验证前说明范围并征得确认。

详细参数见 references/custom-provider-config.md。

许可证

MIT