AI大模型配置指南

OpenClacky 是一个 AI Coding Agent 工具，本身不自带"大脑"。你需要给它配置一个 AI 模型（API Key），它才能帮你写代码、查 Bug、改文档。

这篇文档用最简单的话告诉你：模型是什么、为什么要你自己配、选哪家最合适。看完你就知道下一步该干啥了。

一分钟理解：Agent 和 模型是什么关系？

打个比方——

没有模型 = 助理有手有脚但没脑子，啥也干不了。

💡 简单记：Agent 是壳，模型是芯，API Key 是钥匙。

为什么 OpenClacky 不直接内置模型？

很多小白第一次用会疑惑："为什么下载完还要我自己去买 Key？直接内置一个不行吗？"

这是行业通行做法，原因有 3 点：

1. 模型调用要花钱，且按量计费

每次对话都在消耗算力，模型服务商按 token 计费（类似电表读数）。如果 OpenClacky 统一买单、免费给你用，用户一多就直接破产。

2. 你应该拥有完全的控制权

• 用哪家模型、花多少钱、什么时候停，全由你决定
• 数据直接发往你指定的模型服务商，OpenClacky 不经手
• 想换模型？改个配置就行，不锁死

3. 不同模型各有所长

写代码最强的是一家、中文理解最好的是另一家、便宜大碗的又是第三家。把选择权交给你，你能根据自己的任务选最合适的。

我该选哪家？

我们目前推荐以下 4 家，每家有不同的优势场景：

⭐ OpenClacky AI Keys — 推荐首选

适合：预算充足、追求极致 Agent 体验、不想折腾的用户

如果你希望直接用上最强的模型，同时不想注册一堆账号、不需要翻墙、不想研究哪个模型性能最好——OpenClacky AI Keys 就是为你设计的。

一个 Key，接入顶级模型矩阵：

OpenClacky AI Keys 聚合了目前业内能力最强的模型系列，包括：
- Claude 系列（Anthropic）：业内公认 Coding Agent 最强模型，复杂指令理解和代码生成能力顶尖
- Gemini 系列（Google）：多模态能力突出，擅长长文档理解与分析
- DeepSeek V4（深度求索）：国产高性价比标杆，逻辑推理与代码能力极强

无需翻墙，国内网络直连：

Claude、Gemini 等国外顶级模型在官方渠道需要翻墙访问，还要绑定境外支付卡，门槛很高。OpenClacky AI Keys 帮你绕过这些障碍——国内网络环境直接使用，一个 Key、一次充值、随时切换。

缓存技术降低使用成本：

OpenClacky 在底层做了 Prompt 缓存命中优化。对于 Agent 任务中大量重复出现的系统提示词（System Prompt），缓存命中后的 token 费用会大幅降低，实际使用成本远低于自行调用官方 API 的"表面价格"。

👉 购买 OpenClacky AI Keys

DeepSeek — 超长上下文 + 高性价比

适合：需要处理大量上下文、同时希望控制成本的用户

DeepSeek V4 支持百万 token（1M）超长上下文，是目前主流模型中上下文窗口最大的之一，同时 token 价格依然极具竞争力。代码生成、逻辑推理、数学计算均表现出色，Agent 能力大幅增强，适合需要"大上下文 + 强推理 + 低成本"的复合场景。

DeepSeek 对国内用户友好：官网直接注册、支付宝微信充值、无需翻墙。

适合场景：超长文档理解与分析、代码补全与重构、数据分析脚本、Agent 自动化任务。

👉 购买 DeepSeek API Key

GLM（智谱 AI）— 长程自主执行

适合：需要 AI 持续、自主完成复杂工程任务的用户

GLM-5.1 的核心优势是长程任务执行能力——单次任务可持续自主工作长达 8 小时，完成从规划、执行、测试到交付的完整闭环。在 Coding Agent 场景下，GLM-5.1 具备更强的分步执行与过程调整能力，适合多阶段、强依赖关系的真实工程任务。同时在中文语义理解、工具调用、多轮对话方面也有深厚积累。

GLM 同样支持国内直连访问，注册流程简单。

适合场景：长程 Coding Agent 任务、需要持续迭代优化的工程项目、中文内容创作与理解、复杂工具调用流程。

👉 购买 GLM API Key

MiniMax — Agent 工作流与工程交付

适合：需要处理复杂 Agent 任务、多步骤工程交付的用户

MiniMax M2.7 专为 Agent 工作流和真实软件工程场景设计，具备端到端完整项目交付能力。模型能够自主构建 Agent Harness、调用复杂工具链、在多智能体协作（Agent Teams）场景下稳定执行。在专业办公场景（Excel/PPT/Word 复杂编辑）和金融分析等专业领域也有突出表现。

适合场景：端到端软件工程项目、多智能体协作任务、专业文档处理与编辑、复杂 Agent 工作流构建。

👉 购买 MiniMax API Key

快速选择

买了 Key 之后怎么使用？

OpenClacky 客户端首次启动会进入 Onboarding（引导页），第二步「连接 AI 模型」就是配置 Key 的地方。你只需要：

1. 选择供应商（Provider）：从下拉菜单里挑你刚买 Key 的那家（OpenClacky / DeepSeek / GLM / MiniMax 等）
2. 选择模型（Model）：下拉菜单会自动列出该供应商的可用模型，选一个即可
3. 确认 Base URL：选好供应商后系统已自动填好，通常无需修改
4. 粘贴 API Key：把你从服务商后台复制的 Key 贴到这一栏
5. 点击 「测试并继续」，验证通过就进入正式使用界面

💡 就这么简单——供应商和 Base URL 都是内置的，你真正要做的只有"选一下 + 贴一下"。
💡 之后想换模型或加 Key？在设置里随时改，不用重装。

安全提示

API Key 相当于你的信用卡，泄露了别人能白嫖你的余额，请务必：

• ❌ 不要把 API Key 发到群里、发到 GitHub、截图发朋友圈
• ✅ 要设置支出限额（大部分服务商都支持）
• ✅ 要定期检查用量、发现异常立即重置 Key
• ✅ 要给不同项目/设备使用不同的 Key，方便追踪

下一步

选好服务商，跟着对应文档一步步买就行：

• 👉 购买 OpenClacky AI Keys
• 👉 购买 DeepSeek API Key
• 👉 购买 GLM API Key
• 👉 购买 MiniMax API Key