跳到主要内容

🚀 OpenClaw DeepSeek 模型配置

只需 3 步快速配置 DeepSeek 模型

配置顺序​

配置模型必须按以下顺序：

  1. 设置环境变量（配置认证）
  2. 配置 models.providers（定义模型）
  3. 配置 agents.defaults（设置默认模型、白名单）

DeepSeek 模型简介​

模型用途上下文输出价格（输入）价格（输出）
deepseek-chat对话、代码辅助128K4K/8K¥2/百万tokens¥3/百万tokens
deepseek-reasoner复杂推理128K32K/64K¥2/百万tokens¥3/百万tokens

注意：DeepSeek API 文档显示的是 V3.2 版本

步骤 1：设置环境变量（认证）​

# ~/.bashrc 或 ~/.openclaw/.env
export DEEPSEEK_API_KEY="sk-你的key"

步骤 2：配置 models.providers（定义模型）​

在 ~/.openclaw/openclaw.json 中添加：

{
  "models": {
    "providers": {
      "deepseek": {
        "baseUrl": "https://api.deepseek.com",
        "api": "openai-completions",
        "apiKey": "${DEEPSEEK_API_KEY}",
        "models": [
          {
            "id": "deepseek-chat",
            "name": "DeepSeek Chat",
            "contextWindow": 128000,
            "maxTokens": 8192
          },
          {
            "id": "deepseek-reasoner",
            "name": "DeepSeek Reasoner",
            "contextWindow": 128000,
            "maxTokens": 65536
          }
        ]
      }
    }
  }
}

步骤 3：配置 agents.defaults（默认模型 + 白名单）​

在 agents.defaults 中添加：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "deepseek/deepseek-chat",
        "fallbacks": ["deepseek/deepseek-reasoner"]
      },
      "models": {
        "deepseek/deepseek-chat": {
          "alias": "DeepSeek"
        },
        "deepseek/deepseek-reasoner": {
          "alias": "DeepSeek Reasoner"
        }
      }
    }
  }
}
  • primary：默认使用的模型
  • fallbacks：主模型失败时的备用模型
  • models：模型白名单，只有在白名单中的模型才能使用

重启 Gateway​

pkill -f openclaw-gateway
nohup openclaw gateway run > /tmp/openclaw-gateway.log 2>&1 &

验证​

# 测试模型
openclaw agent --message "你好" --model deepseek/deepseek-chat

常见问题​

Q: API Key 从哪里获取？

A: 访问 https://platform.deepseek.com/ 注册后，在 API Keys 页面创建

检查点​

  • 环境变量 DEEPSEEK_API_KEY 已设置
  • models.providers.deepseek 已配置
  • agents.defaults.models 白名单已添加
  • agents.defaults.model.primary 已设置
  • Gateway 已重启
  • 模型测试成功

相关文档​