前置条件
- 已安装 SetupClaw 应用并完成环境检查
- 至少拥有一个 AI 模型提供商的 API 密钥
1
第 1 步：打开模型与 API
导航至模型配置页面，您可以在此管理所有 AI 提供商。
- a打开 SetupClaw 应用，进入仪表盘
- b点击侧边栏中的「模型与 API」
- c您将看到完整的提供商目录以及已配置的模型
2
第 2 步：选择提供商
浏览 30+ 支持的 AI 模型提供商。主要提供商包括 OpenAI（GPT-4、GPT-4o）、Anthropic（Claude 3.5、Claude 4）、Google（Gemini 2.0、Gemini 2.5）、DeepSeek、Mistral、智谱、百川、月之暗面、零一万物、通义千问，以及任何 OpenAI 兼容的自定义接口。
- a滚动浏览提供商列表或使用搜索栏查找您的提供商
- b点击提供商卡片展开其配置面板
- c查看该提供商的可用模型
- d如需使用自定义接口（任何 OpenAI 兼容 API），请选择列表底部的「自定义提供商」
3
第 3 步：输入 API 密钥
通过输入 API 密钥来验证您选择的提供商。部分提供商支持一键 OAuth 授权，无需手动输入密钥。
- a点击您要配置的提供商
- b在凭据字段中输入您的 API 密钥。对于支持 OAuth 的提供商（如 Google Gemini），点击「OAuth 授权」即可，无需 API 密钥
- c点击「保存」安全存储您的凭据
4
第 4 步：设置默认模型
选择一个默认模型，除非特定智能体覆盖设置，否则所有对话都将使用该模型。
- a在「模型与 API」页面顶部找到「默认模型」区域
- b从下拉菜单中选择您偏好的模型 — 当智能体未指定专用模型时将使用此默认模型
- c点击「保存」确认您的默认设置
5
第 5 步：配置降级链
设置降级链，确保即使主要模型不可用，AI 助手仍能正常工作。当一个模型不可用时，系统会自动切换到下一个。
- a打开默认模型选择器下方的「降级链」设置
- b按优先级顺序添加模型。例如：Claude → GPT-4 → Gemini
- c点击「保存」— 系统将在当前模型不可用时自动切换到下一个模型
6
第 6 步：验证连接
在开始对话之前，测试 API 密钥是否有效以及模型是否可达。
- a点击每个已配置提供商旁边的「验证」按钮
- b仪表盘将为成功连接显示绿色对勾，为失败连接显示红色标识
- c如果验证失败，请检查 API 密钥是否正确，并确保提供商账户有可用额度
使用技巧
- 您可以同时使用多个提供商的模型 — 混合搭配，找到最适合您的方案
- 不同的智能体可以使用不同的模型。在「智能体」页面为每个智能体配置模型偏好
- 支持 OAuth 的提供商（如 Google Gemini）无需手动复制 API 密钥 — 只需点击授权即可