模型服务商
配置多个 AI 服务商，管理 API Key 和模型。
常见服务商与兼容接入
| 服务商 | 模型示例 | 凭据 |
|---|---|---|
| OpenAI | GPT / o 系列 | API Key |
| DeepSeek | DeepSeek 系列 | API Key |
| Anthropic | Claude 系列 | API Key |
| Google Gemini | Gemini 系列 | API Key |
| 阿里 Qwen | Qwen 系列 | API Key |
| 字节 Ark | 豆包及 Ark 可用模型 | API Key |
| 智谱 AI | GLM 系列 | API Key |
| Kimi（月之暗面） | Kimi 系列 | API Key |
| 百度千帆 | ERNIE 系列 | API Key |
| 腾讯混元 | 混元系列 | API Key |
| 讯飞星火 | Spark 系列 | API Key |
| MiniMax | MiniMax 系列 | API Key |
| Ollama | 已安装的本地模型 | 本机默认无需 API Key |
| 自定义 | 兼容接口提供的模型 | 按所选接口要求配置 |
模型名称仅作示例。先选择服务商类型，再核对其当前 API 文档中的完整 Base URL、API Key 和模型 ID；不同原生接口与兼容接口的地址可能不同，不能只填官网域名。可用模型以账号权限、地区及当前服务返回的列表为准。
Ark 配置：API Key 是鉴权凭据，ep-... 是推理接入点 ID，应填在模型位置；也可使用账号支持的 Model ID。常规接口地址为 https://ark.cn-beijing.volces.com/api/v3，详见火山方舟官方说明。
添加服务商
- 进入 设置 → 模型服务
- 点击 "添加服务商"
- 选择类型（OpenAI / DeepSeek / ...）
- 填入该服务商的 API Key；配置保存到当前连接的服务，存储方式见下文
- （可选）修改 Base URL（适用于代理或私有部署）
- 保存
模型能力标识
能力按具体模型配置，不能用一个服务商的名称推断其所有模型都支持同样的输入和输出：
| 能力 | 用途 |
|---|---|
text / code | 文本对话与代码生成；默认聊天模型需要具备 text 能力 |
vision | 读取和理解输入图片，不等于生成或编辑图片 |
video | 理解输入视频，不等于生成视频 |
audio | 模型支持的音频输入与回应；语音转写、朗读需各自可用的服务 |
image_generation | 生成图片；编辑已有图片还需对应模型和接口支持 |
video_generation | 生成视频，按任务状态取得产物 |
embedding | 将内容转为向量，供知识检索使用，不作为普通聊天模型 |
在模型配置中确认用途，再选择聊天或专用媒体模型。能力未分类不代表已经支持全部用途；模型列表、能力声明和一次具体调用成功也分别代表不同事实。思考开关与强度由具体模型支持情况决定。
Ollama 本地部署
配置图片、语音或视频任务前，可先查看媒体生成指南，区分理解、生成与编辑需要的模型能力。
Ollama 可在模型下载完成后本地推理；整个任务是否离线，还取决于是否使用联网工具、云模型或外部服务。
# 安装 Ollama
brew install ollama # macOS
# 或访问 ollama.com 下载
# 启动并下载模型
ollama serve
ollama pull llama3.1
ollama pull qwen2.5
ollama pull deepseek-r1在河蟹 AI 中添加 Ollama 服务商，Base URL 填 http://localhost:11434/v1，无需 API Key。
API Key 安全
本机桌面端的 Provider API Key 由 Sidecar 保存到 ~/.hexclaw/hexclaw.yaml，目录权限为 0700、文件权限为 0600，不通过系统钥匙串或浏览器存储另存 Provider 密钥。连接自建云端时，使用云端服务的 Provider 配置和凭据；本机配置不会自动同步到云端。
测试连接
在服务商卡片使用测试功能，检查所选地址、凭据和模型是否能完成实际调用。测试可能使用服务商额度；查看返回结果和错误详情，连接成功不代表该服务商下所有模型、媒体或工具能力均已验证。
自动模型选择
使用自动选择时，当前服务按默认模型、任务所需能力和路由设置选取模型；专用媒体任务按对应能力选择。发生可切换的模型故障时，服务可尝试符合条件的备用 Provider。
实际是否切换取决于失败类型、可用备用模型和任务状态，并非所有失败都会重发。查看本次执行记录中的实际模型；外部操作结果未知时，先查询原任务，避免重复生成或发送。