学习目标

学会选择一个适合你的 AI 模型，把 API Key 配好，让小龙虾正式上岗工作。

如果你在安装时的 onboard 向导里已经配置好了模型和 API Key，这一课可以当作参考手册来用，不需要重新操作。

概念解释

AI 模型就像”不同品牌的发动机”。你买车的时候，有省油的、有动力强的、有性价比高的——AI 模型也是这样。有的便宜好用，有的聪明但贵，有的擅长长文本。选哪个取决于你的需求和预算。

好消息是：OpenClaw 支持好几种主流模型，你可以随时切换，就像换手机卡一样简单。对于刚入门的小白，我们推荐从 DeepSeek 开始——它便宜、中文能力强、完全够用。

在 OpenClaw 里，每个模型都有一个”身份证号”，格式是 提供商/模型名（英文叫 provider/model）。比如 DeepSeek 不是简单地叫 deepseek，而是 deepseek/deepseek-chat。记住这个格式，后面会经常用到。

动手做

第一步：了解你的选择

先看看市面上有哪些”发动机”可以选：

模型	特点	大致费用（每次对话）	适合谁
DeepSeek	便宜、中文好、响应快	约 0.001 元	小白入门、日常使用
GPT-4o	全能、稳定、生态成熟	约 0.01 元	需要稳定体验的用户
Claude	聪明、写作好、逻辑清晰	约 0.02 元	写作、分析、复杂任务
Gemini	长文本强、Google 生态	约 0.01 元	处理长文档

费用只是估算，实际价格以各平台官网为准。DeepSeek 一块钱大概能聊上千条，非常划算。

每个模型在 OpenClaw 里对应的”身份证号”是：

模型	正确的 model 值
DeepSeek	"deepseek/deepseek-chat"
GPT-4o	"openai/gpt-4o"
Claude	"anthropic/claude-sonnet-4-6"
Gemini	"google/gemini-2.5-pro"

注意格式是 提供商/模型名，中间有个斜杠，别漏掉了。

第二步：获取 API Key

以 DeepSeek 为例（推荐新手使用）：

1. 打开浏览器，访问 DeepSeek 开放平台
2. 注册一个账号（手机号就行）
3. 登录后，找到「API Keys」页面
4. 点击「创建 API Key」
5. 复制生成的那串字符（长得像 sk-xxxxxxxxxxxxxxxx）

重要： API Key 就像你家钥匙，不要发给别人，不要贴在公开场合。

如果你更想用其他模型，获取方式类似：

• OpenAI (GPT-4o)：访问 platform.openai.com
• Anthropic (Claude)：访问 console.anthropic.com
• Google (Gemini)：访问 aistudio.google.com

第三步：把 API Key 告诉 OpenClaw

API Key 不是手动写进配置文件的！ OpenClaw 提供了专门的命令来安全地管理你的密钥，就像你把钥匙交给保险柜管理员一样，不需要自己去撬锁。

在终端里运行以下命令：

openclaw models auth add

然后按提示操作：

1. 选择提供商（比如选 DeepSeek）
2. 粘贴你的 API Key
3. 确认保存

就这样，搞定！你的 API Key 会被安全地保存起来，不需要手动编辑任何文件。

其他方式： 你也可以用 openclaw models auth login --provider deepseek 直接指定提供商登录。如果你在首次启动时的 onboard 向导里已经配过了，那就不用再执行这一步了。

环境变量方式： 如果你熟悉环境变量，也可以设置 DEEPSEEK_API_KEY、OPENAI_API_KEY 等环境变量来提供 API Key。

第四步：选择你要用的模型

API Key 配好之后，告诉小龙虾你想用哪个模型：

openclaw models set deepseek/deepseek-chat

想看看当前用的是哪个模型？运行：

openclaw models status

想看看有哪些模型可以选？运行：

openclaw models list

第五步：验证配置

1. 打开 OpenClaw，给小龙虾发一条消息：「你好，请告诉我你正在使用哪个模型」
2. 如果它正常回复了，说明配置成功
3. 如果回复中提到了你设置的模型名称，那就更确认了

小技巧： 在聊天过程中，你也可以随时切换模型：

• 输入 /model 查看当前使用的模型
• 输入 /model list 查看可选模型列表
• 输入 /model deepseek/deepseek-chat 直接切换到指定模型

就像看电视换台一样方便！

检查你的成果

完成以上步骤后，你应该做到：

• 有了一个可用的 API Key
• 通过 openclaw models auth add 把 API Key 安全地存入了 OpenClaw
• 通过 openclaw models set 设置了你想用的模型
• 小龙虾能正常回复你的消息

常见失败排查

1. 报错「API Key 无效」

原因： Key 复制不完整，或者有多余的空格。

解决： 回到平台重新复制一次 API Key，确保从 sk- 开头到最后一个字符都复制到了。然后重新运行 openclaw models auth add 再粘贴一次。

2. 报错「余额不足」或「Quota exceeded」

原因： 你的 API 账户里没钱了。

解决： 去对应平台的控制台充值。DeepSeek 新注册通常会送一些免费额度，GPT 和 Claude 也可能有试用额度。

3. 报错「Model not found」或模型名称错误

原因： 模型名格式不对，没有使用 提供商/模型名 的格式。

解决： 检查你设置的模型名是否使用了正确的格式。必须是 deepseek/deepseek-chat、openai/gpt-4o 这样带斜杠的完整格式，不能只写 deepseek 或 gpt-4o。运行 openclaw models list 可以查看所有可用的模型名。

4. 想换一个模型怎么办？

解决： 非常简单，在终端运行：

openclaw models set openai/gpt-4o

或者直接在聊天里输入 /model openai/gpt-4o 就行，秒切，不需要改任何配置文件。

挑战任务

尝试配置两个不同的模型（比如 DeepSeek 和 GPT-4o），分别用它们回答同一个问题（比如「用三句话介绍你自己」），感受一下不同模型的回答风格有什么区别。

提示：用 /model deepseek/deepseek-chat 切换到 DeepSeek，聊完后再用 /model openai/gpt-4o 切换到 GPT-4o，对比两次回答。

---

进阶阅读： 如果你想了解配置文件的完整结构，配置文件位于 ~/.openclaw/openclaw.json（JSON5 格式，支持注释），模型相关配置长这样：

{
  agents: {
    defaults: {
      model: {
        primary: "deepseek/deepseek-chat",  // 主模型
        fallbacks: ["openai/gpt-4o"],       // 备选模型（主模型挂了会用这个）
      }
    }
  }
}

不过大多数情况下，你不需要手动编辑这个文件，用 CLI 命令就够了。