必须配置对应服务商的API Key才能启用Clawdbot高级接口功能：一、在各平台控制台创建并复制密钥；二、用clawdbot config set命令注入JSON配置；三、设models.mode为merge；四、用clawdbot models set指定默认模型；五、运行clawdbot models test验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
如果您已安装 Clawdbot 并希望启用高级接口功能（如调用 DeepSeek、腾讯混元、阿里云百炼等大模型），则必须正确配置对应服务商的 API Key。以下是完成该配置的具体操作流程：
一、获取目标服务商的 API Key
不同服务商需在各自平台申请并复制 API Key，该密钥是调用其模型服务的唯一身份凭证。未获取有效密钥将导致后续配置失败或接口返回 401 错误。
1、访问服务商控制台：DeepSeek 用户前往 https://platform.deepseek.com/api_keys；腾讯混元用户登录 https://console.cloud.tencent.com/hunyuan；阿里云百炼用户进入 https://bailian.console.aliyun.com。
2、在密钥管理页面点击「创建 API Key」或「新增密钥」，完成安全验证后生成新密钥。
3、立即复制显示的密钥字符串（形如 sk-xxx 或 AK-xxx），该密钥仅在此刻可见，关闭页面后不可再次查看，需妥善保存。
二、通过命令行注入 API 配置
Clawdbot 使用结构化 JSON 配置模型提供商参数，需将 API Key 嵌入 provider 配置块中，并确保 baseUrl 和 models 字段与服务商文档严格一致。
1、执行以下命令配置 DeepSeek 提供商（替换 your_deepseek_apikey_here 为实际密钥）：
clawdbot config set 'models.providers.deepseek' --json '{ "baseUrl": "https://api.deepseek.com/v1", "apiKey": "your_deepseek_apikey_here", "api": "openai-completions", "models": [ { "id": "deepseek-chat", "name": "DeepSeek Chat" } ] }'
2、执行以下命令配置腾讯混元提供商（替换 your_hunyuan_apikey_here 为实际密钥）：
clawdbot config set 'models.providers.hunyuan' --json '{ "baseUrl": "https://api.hunyuan.cloud.tencent.com/v1", "apiKey": "your_hunyuan_apikey_here", "api": "openai-completions", "models": [ { "id": "hunyuan-lite", "name": "Hunyuan-lite" } ] }'
3、执行以下命令配置阿里云百炼提供商（替换 your_bailian_apikey_here 为实际密钥）：
clawdbot config set 'models.providers.bailian' --json '{ "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1", "apiKey": "your_bailian_apikey_here", "api": "openai-completions", "models": [ { "id": "qwen-max", "name": "Qwen Max" } ] }'
三、启用多模型合并模式
当配置多个 provider 后，需将 models.mode 设为 merge，使 Clawdbot 能动态识别并路由请求至对应服务商，避免因模式不匹配导致模型调用被拒绝。
1、运行命令启用合并模式：
clawdbot config set models.mode merge
四、设定默认调用模型
指定一个默认模型 ID 可省去每次请求时手动声明 provider/model 的步骤，Clawdbot 将自动使用该模型响应所有未显式指定模型的请求。
1、设置默认模型为 DeepSeek Chat：
clawdbot models set deepseek/deepseek-chat
2、设置默认模型为腾讯混元 Lite：
clawdbot models set hunyuan/hunyuan-lite
3、设置默认模型为通义千问 Max：
clawdbot models set bailian/qwen-max
五、验证 API Key 是否生效
配置完成后需触发一次真实调用以验证密钥有效性及网络连通性，Clawdbot 将在日志中输出 HTTP 状态码与响应体摘要，成功响应表明密钥已激活。
1、执行测试命令：
clawdbot models test
2、观察终端输出是否包含 status: 200 及 model: deepseek-chat（或其他已设模型名）字样。
3、若出现 401 Unauthorized，请检查密钥是否复制完整、是否含多余空格、是否已过期或被禁用。
