ClawTeam Profiles与Presets实战：一条命令切换Kimi、MiniMax、Gemini等AI提供商

ClawTeam Profiles与Presets实战一条命令切换Kimi、MiniMax、Gemini等AI提供商【免费下载链接】ClawTeamClawTeam: Agent Swarm Intelligence (One Command → Full Automation)项目地址: https://gitcode.com/gh_mirrors/cl/ClawTeamClawTeam 是一个多 Agent 智能集群Agent Swarm Intelligence工具口号是One Command → Full Automation一条命令即可拉起一支 Agent 团队并行干活。而真正让它可以接上 Kimi、MiniMax、Gemini 等不同 AI 提供商的就是Profiles运行时配置和Presets提供商模板两大机制。本文带你用最少命令完成配置、生成、启动、验证全流程轻松实现 AI 提供商一键切换。一、Profile 与 Preset两个概念一分钟讲清ClawTeam 里这两个词容易混淆其实分工非常清晰定义见 clawteam/config.py概念作用类比Preset提供商模板定义某家 AI 厂商该怎么接Base URL、API Key 环境变量、推荐模型菜谱Profile最终给spawn/launch使用的运行时配置可被命名、复用做好的一盘菜Preset 是可复用的模板一次配置可以生成多个 ProfileProfile 才是clawteam spawn --profile xxx真正读取的东西两者都存在用户配置文件~/.clawteam/config.json中不依赖项目目录。核心逻辑集中在 clawteam/spawn/presets.py模板目录与生成规则和 clawteam/spawn/profiles.py配置解析与环境变量注入CLI 入口在 clawteam/cli/commands.py。二、查看内置 PresetKimi、MiniMax、Gemini 全部就绪先看看开箱即用有哪些模板clawteam preset list # 列出内置 本地 Preset clawteam preset show moonshot-cn # 查看某个 Preset 详情内置 Preset 覆盖了主流提供商完整定义见 clawteam/spawn/presets.pyPreset 名称提供商认证环境变量适用客户端moonshot-cnKimi月之暗面MOONSHOT_API_KEYclaude / kimiminimax-cn/minimax-globalMiniMax国内/国际端点MINIMAX_API_KEYclaudegoogle-ai-studioGeminiAI Studio KeyGEMINI_API_KEYgeminigemini-vertexGeminiVertex/ADC本地 gcloud 凭证geminianthropic-official/openai-official官方 Claude / Codex对应官方 Keyclaude / codexdeepseek、zhipu-cn、zhipu-globalDeepSeek / 智谱 GLM对应 Keyclaudebailian/bailian-coding阿里百炼DASHSCOPE_API_KEYclaudeopenrouterOpenRouter 聚合OPENROUTER_API_KEYclaude / codex / gemini 值得注意的设计moonshot-cn同时支持让 Claude Code 走 Kimi 端点和原生 Kimi CLI两种玩法一个 Preset 里包含多份客户端覆盖配置client_overrides。三、从 Preset 生成 Profile一条命令搞定# Kimi把 moonshot-cn 模板转成名为 claude-kimi 的 Profile clawteam preset generate-profile moonshot-cn claude --name claude-kimi # MiniMax国际端点 clawteam preset generate-profile minimax-global claude --name claude-minimax # 或一次性为 Preset 内的所有客户端批量生成 clawteam preset bootstrap moonshot-cn生成过程做了什么看 generate_profile_from_preset它会把 Preset 的认证变量、Base URL、公共环境变量合并进客户端专属配置并按客户端-Preset名自动命名。四、profile wizard交互式配置向导不想记参数用 TUI 向导源码见 profile_wizardclawteam profile wizard流程很友好选择Quick / Advanced模式 → 选择客户端Claude Code、Codex、Gemini CLI、Kimi CLI、Nanobot→ 从内置 Preset 里挑提供商模板也可直接 Custom 手填→ 确认 Profile 名称即可保存。Quick 模式会提示使用模板推荐配置Advanced 模式可以逐条修改模型、Base URL、API Key 环境变量甚至命令覆盖和额外参数。五、spawn 时通过 --profile 切换 AI 提供商配置就绪后启动 Agent 时带上--profile就完成了切换# 用 Kimi 模型跑重构任务 clawteam spawn tmux --profile claude-kimi --team my-team --agent-name dave --task 重构认证流程 # 同一个团队里另一个成员走 GeminiVertex clawteam spawn subprocess --profile gemini-vertex --team my-team --agent-name alice --task Run lintingProfile 解析优先级在 resolve_profile_name 中定义显式--profile参数最高优先级配置的default_profile恰好只配置了一个 Profile 时自动使用也就是说你甚至可以配一个default_profile之后所有 spawn 默认走某家提供商想换再临时指定--profile。启动细节可参考 skills/clawteam/SKILL.md。六、profile test 与 doctor先验证再上量真正拉起团队前先做个冒烟测试避免 API Key 配错浪费额度MOONSHOT_API_KEYsk-xxx clawteam profile test claude-kimiprofile test会用该 Profile 发起一次非交互的回复固定口令测试见 profile_test如果 Claude Code 在全新机器上首次使用报 onboarding 问题执行一次clawteam profile doctor claude即可修复本地运行状态。七、常见问题 FAQQ1spawn 时提示Multiple profiles are configured配置了多个 Profile 却没设默认值ClawTeam 不知道该用哪个。二选一在配置里设置default_profile或显式传--profile报错逻辑见 profiles.py。Q2Profile 的 API Key 是明文存在配置里吗不是。Profile 只记录从哪个环境变量读 Key如MOONSHOT_API_KEY运行时由 apply_profile 把当前环境变量注入到对应客户端的目标变量如ANTHROPIC_AUTH_TOKEN、GEMINI_API_KEY、KIMI_API_KEYKey 本身始终留在你的环境里。Q3想改内置 Preset内置模板不可直接修改但可以用clawteam preset copy 源 新名字复制成本地 Preset 再随意编辑或用preset set-client单独更新某个客户端的覆盖配置。小结Preset管怎么接提供商Profile管怎么启动 Agentgenerate-profile/wizard负责两者衔接Kimi、MiniMax、Gemini、DeepSeek、百炼、OpenRouter 等主流端点均有内置模板一条命令即可切换记住黄金链路preset list→generate-profile→profile test→spawn --profile多 Agent 团队即刻用上任意 AI 提供商。 【免费下载链接】ClawTeamClawTeam: Agent Swarm Intelligence (One Command → Full Automation)项目地址: https://gitcode.com/gh_mirrors/cl/ClawTeam创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考