# openclaw-trapi-config

OpenClaw 技能（Skill）：配置传米科技 trapi 自定义 Provider 及模型。

## 简介

trapi 是传米科技（Transiglobal）提供的大模型中转 API 服务，统一使用 Anthropic Messages 格式。本技能帮助用户在任意 OpenClaw 实例上一键配置 trapi Provider，包含预置模型和别名，并支持动态添加新模型。

## 服务信息

| 项目 | 值 |
|------|-----|
| Provider 名称 | `trapi` |
| API 地址 | `https://lapi.transiglobal.com` |
| API 格式 | `anthropic-messages` |
| 运营方 | 传米科技 |

## 预置模型

| 模型 ID | 别名 | 输入类型 | 上下文窗口 | 最大输出 |
|---------|------|---------|-----------|---------|
| GLM-5-Turbo | `glm5t` | 文本 | 200K | 64K |
| GLM-5.1 | `glm51` | 文本 | 200K | 64K |
| GLM-4.5-Air | `glm45a` | 文本 | 200K | 64K |
| MiniMax-M2 | `mxm2` | 文本 | 200K | 64K |
| MiniMax-M2.7 | `mxm27` | 文本 | 200K | 64K |
| kimi-for-coding | `kimi` | 文本 + 图片 | 262K | 32K |
| deepseek-v4-pro | `dsv4p` | 文本 | 1M | 384K |
| deepseek-v4-flash | `dsv4f` | 文本 | 1M | 384K |
| gpt-5.5 | `gpt55` | 文本 | 200K | 65K |
| GLM-5V-Turbo | `glm5v` | 文本 + 图片 | 200K | 64K |
| PaddleOCR-VL-1.5 | `pocr` | 文本 + 图片 | 131K | 8K |
| mimo-v2.5-pro | `mimo25p` | 文本 | 200K | 64K |
| mimo-v2.5 | `mimo25` | 文本 + 图片 + 视频 + 音频 | 200K | 64K |
| claude-opus-4.7 | `opus47` | 文本 | 300K | 64K |
| qwen3.7-max | `qwn37` | 文本 | 1M | 100K |
| qwen3.6-plus | `qwn36` | 文本 + 图片 | 1M | 100K |

## 快捷切换模型

```
/glm45a   → GLM-4.5-Air（轻量）
/glm5t    → GLM-5-Turbo（高性价比）
/glm51    → GLM-5.1（旗舰）
/mxm2     → MiniMax-M2
/mxm27    → MiniMax-M2.7
/kimi     → kimi-for-coding（支持图片）
/dsv4p    → DeepSeek V4 Pro（1M上下文）
/dsv4f    → DeepSeek V4 Flash（1M上下文，快速）
/gpt55    → GPT-5.5
/glm5v    → GLM-5V-Turbo（支持图片）
/pocr     → PaddleOCR-VL-1.5（OCR识别）
/mimo25p  → MiMo 2.5 Pro
/mimo25   → MiMo 2.5（全模态：文本+图片+视频+音频）
/opus47    → Claude Opus 4.7（最新旗舰）
/qwn37     → Qwen 3.7 Max（1M上下文，纯文本）
/qwn36     → Qwen 3.6 Plus（1M上下文，支持图片）
```

## 使用方式

### 首次配置 trapi

在 OpenClaw 对话中说：

> "配置 trapi"

技能会引导你完成：
1. **提供 API Key**（必须提供，不会使用任何默认 key）
2. **自动写入 Provider 配置**到 `openclaw.json`
3. **注册模型别名**（glm5t / glm51 / mxm27 / kimi / dsv4p / dsv4f / gpt55 / opus47 等）
4. **逐个模型验证**，确保连通性
5. **检查已有配置**，只补齐缺失部分，不重复配置

### 添加新模型

当 trapi 已配置好后，说：

> "给 trapi 添加 Qwen-3-Plus"

技能会：
1. 询问模型全称
2. 自动生成 ≤5 字符的别名（避免与已有别名冲突）
3. 默认 200K 上下文 / 64K 最大输出，支持自定义
4. 写入配置并验证

## 图像模型配置（imageModel）

配置 trapi 后，建议同步设置 OpenClaw 的 `imageModel`，使 Agent 具备图像识别能力：

| 角色 | 模型 | 说明 |
|------|------|------|
| **Primary** | `trapi/kimi-for-coding` | 默认图像识别模型 |
| Fallback 1 | `trapi/qwen3.6-plus` | 1M 上下文，支持图像 |
| Fallback 2 | `trapi/mimo-v2.5` | 全模态（文本+图片+视频+音频） |
| Fallback 3 | `trapi/GLM-5V-Turbo` | 智谱视觉模型 |
| Fallback 4 | `zai/glm-4.6v` | 智谱官方 API 备选 |
| Fallback 5 | `xiaomi/mimo-v2-omni` | 小米多模态备选 |

## 安全说明

- **API Key 必须由用户提供**，技能中不存储任何默认密钥
- 未提供 Key 时配置流程会立即终止
- 所有配置通过 OpenClaw 标准的 `gateway config.patch` 写入

## 许可证

MIT