8917-minimax-toolkit

定位

这是一个 工具型 / Tool Wrapper skill。

用它在 MiniMax 官方 API 上执行多模态生成任务，并把产物稳定落到当前工作区或用户指定目录。

核心原则

1. 执行前先提示消耗：先输出 Token Plan 请求消耗预估，再执行。
执行前先讲清隐私边界：涉及图片、音频、视频等素材上传时，明确告知会发送到 MiniMax API。
优先遵守输出纪律：优先写入当前工作区；没有 workspace/ 时再退回通用输出目录。
项目隔离优先：需要长期管理时优先使用 --project。
禁止硬编码 API Key：仅从 MINIMAXAPIKEY 或 ~/.openclaw/openclaw.json 读取。

输出纪律

输出根目录优先级：

1. --output-dir
MINIMAXOUTPUTDIR
当前工作目录下的 workspace/03-Resources/minimax-output/
当前目录不存在 workspace/ 时，退回 ./outputs/minimax/

使用 --project 时，产物进入项目子目录。

执行完成后，始终明确告诉用户：

- 文件类型
保存路径
如需长期管理，建议整理到项目目录

预算与隐私

执行前至少说明：

- 模型名称
预计消耗的 request 次数
5 小时滚动窗口规则
高消耗任务风险提示（尤其视频）

涉及私密图片、音频或视频时，先确认用户接受第三方 API 处理。

详细说明见：

- references/budget-and-trust.md
references/api_info.md
references/costs.json

能力导航

按具体场景读取：

- references/modalities.md：查看 9 类能力、对应脚本和 CLI 示例
references/budget-and-trust.md：查看预算、上传与隐私边界
references/apiinfo.md：查看当前模型 ID 与基础约束
references/quotamapping.json：查看运行时模型名与官方额度桶的映射
references/official-doc-sources.md：查看需要定期核验的官方来源
references/troubleshooting.md：查看联网失败、网页抓取失败、remains 查询失败时的排障指引

官方文档校验机制

可运行：

bash
python3 scripts/mm.py remains
python3 scripts/mm.py check-docs

其中：

- mm.py remains：查询官方 Token Plan 实时额度
mm.py check-docs：抓取官方 FAQ + 查询 remains + 对比本地 references

校验脚本会：

1. 抓取官方 Token Plan FAQ
查询官方 coding_plan/remains 接口
对比本地 references/ 中的关键配置
生成差异报告到 references/checks/latest-check.md

如果在线校验失败：

- 不阻塞整个 skill
退回本地 references 离线模式
输出排障指引
详见 references/troubleshooting.md

Image / Video / Music

python3 scripts/mm.py image A red apple --ratio 16:9 --project Demo
python3 scripts/mm.py video Cinematic ruins --project Demo
python3 scripts/mm.py music Lo-fi beat --instrumental --project Demo

Speech (short text)

python3 scripts/mm.py speech Hello world --voice male-qn-qingse --project Demo

Speech (long text / file)

python3 scripts/mm.py async-speech ~/script.txt --voice male-qn-qingse --project Demo

Image-to-image

python3 scripts/mm.py i2i anime style --ref ~/photo.jpg --project Demo

Video templates

python3 scripts/mm.py video-template labubu --media ~/photo.jpg --project Demo

Voice clone / design

python3 scripts/mm.py voice-clone ~/my_voice.wav --voice-id my-voice python3 scripts/mm.py voice-design Warm deep male voice --voice-id new-voice

支持的 modality：image, i2i, video, video-template, speech, async-speech, voice-clone, voice-design, music

当前支持显式功能开关：references/feature_flags.json

- 可按 modality 设定 true / false
当前套餐不支持的能力建议直接设为 false，避免无意义调用

注意：

- voice-design 当前要求 --preview-text
voice-clone 建议提供 --preview-text，如提供 --prompt-audio 则需同时提供 --prompt-text
复刻音色若 7 天内未正式调用，官方会删除该音色

详细示例见 references/modalities.md。

兼容入口（旧脚本仍可用）

如需直接调用或处理更复杂场景，以下脚本仍可用：

- scripts/mmimage.py
scripts/mmi2i.py
scripts/mmvideo.py
scripts/mmvideotemplate.py
scripts/mmspeech.py
scripts/mmasyncspeech.py
scripts/mmvoiceclone.py
scripts/mmvoicedesign.py
scripts/mm_music.py

旧脚本作为兼容层保留，未来逐步收敛到统一入口。

一句话原则

MiniMax 产物默认落当前工作区或通用输出目录，执行前讲清 request 消耗与第三方 API 处理边界。

8917-minimax-toolkitMiniMax工具集