企业官网建设流程全解析

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

【免费下载链接】ClawTeam"ClawTeam: Agent Swarm Intelligence" (One Command → Full Automation)项目地址: https://gitcode.com/gh_mirrors/cl/ClawTeam

ClawTeam 是一个多 Agent 智能集群（Agent Swarm Intelligence）工具，口号是"One Command → Full Automation"：一条命令即可拉起一支 Agent 团队并行干活。而真正让它可以接上 Kimi、MiniMax、Gemini 等不同 AI 提供商的，就是Profiles（运行时配置）和Presets（提供商模板）两大机制。本文带你用最少命令，完成配置、生成、启动、验证全流程，轻松实现 AI 提供商一键切换。

一、Profile 与 Preset：两个概念一分钟讲清

ClawTeam 里这两个词容易混淆，其实分工非常清晰（定义见 clawteam/config.py）：

• Preset 是"可复用的模板"，一次配置可以生成多个 Profile；
• Profile 才是clawteam spawn --profile xxx真正读取的东西；
• 两者都存在用户配置文件~/.clawteam/config.json中，不依赖项目目录。

核心逻辑集中在 clawteam/spawn/presets.py（模板目录与生成规则）和 clawteam/spawn/profiles.py（配置解析与环境变量注入），CLI 入口在 clawteam/cli/commands.py。

二、查看内置 Preset：Kimi、MiniMax、Gemini 全部就绪

先看看开箱即用有哪些模板：

clawteam preset list # 列出内置 + 本地 Preset clawteam preset show moonshot-cn # 查看某个 Preset 详情

内置 Preset 覆盖了主流提供商（完整定义见 clawteam/spawn/presets.py）：

💡 值得注意的设计：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_wizard）：

clawteam 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 "重构认证流程" # 同一个团队里，另一个成员走 Gemini（Vertex） clawteam spawn subprocess --profile gemini-vertex --team my-team --agent-name alice --task "Run linting"

Profile 解析优先级在 resolve_profile_name 中定义：

1. 显式--profile参数（最高优先级）
2. 配置的default_profile
3. 恰好只配置了一个 Profile 时自动使用

也就是说，你甚至可以配一个default_profile，之后所有 spawn 默认走某家提供商，想换再临时指定--profile。启动细节可参考 skills/clawteam/SKILL.md。

六、profile test 与 doctor：先验证再上量

真正拉起团队前先做个冒烟测试，避免 API Key 配错浪费额度：

MOONSHOT_API_KEY=sk-xxx clawteam profile test claude-kimi

profile test会用该 Profile 发起一次非交互的"回复固定口令"测试（见 profile_test）；如果 Claude Code 在全新机器上首次使用报 onboarding 问题，执行一次clawteam profile doctor claude即可修复本地运行状态。

七、常见问题 FAQ

Q1：spawn 时提示"Multiple profiles are configured"？配置了多个 Profile 却没设默认值，ClawTeam 不知道该用哪个。二选一：在配置里设置default_profile，或显式传--profile（报错逻辑见 profiles.py）。

Q2：Profile 的 API Key 是明文存在配置里吗？不是。Profile 只记录"从哪个环境变量读 Key"（如MOONSHOT_API_KEY），运行时由 apply_profile 把当前环境变量注入到对应客户端的目标变量（如ANTHROPIC_AUTH_TOKEN、GEMINI_API_KEY、KIMI_API_KEY），Key 本身始终留在你的环境里。

Q3：想改内置 Preset？内置模板不可直接修改，但可以用clawteam preset copy <源> <新名字>复制成本地 Preset 再随意编辑，或用preset set-client单独更新某个客户端的覆盖配置。

小结

• Preset管"怎么接提供商"，Profile管"怎么启动 Agent"，generate-profile/wizard负责两者衔接；
• Kimi、MiniMax、Gemini、DeepSeek、百炼、OpenRouter 等主流端点均有内置模板，一条命令即可切换；
• 记住黄金链路：preset list→generate-profile→profile test→spawn --profile，多 Agent 团队即刻用上任意 AI 提供商。 🚀

【免费下载链接】ClawTeam"ClawTeam: Agent Swarm Intelligence" (One Command → Full Automation)项目地址: https://gitcode.com/gh_mirrors/cl/ClawTeam