DeepSeek接入OpenClaw完整教程

DeepSeek接入OpenClaw完整教程。本文为tutorial类教程，发布于2026-03-15，已有19次阅读。由ONE社区整理发布，所有教程内容免费开放。

DeepSeek接入OpenClaw完整教程

前言

OpenClaw是一个强大的AI自动化平台，支持多种AI模型接入。DeepSeek作为国内优秀的AI模型，具有成本低、响应快、支持长上下文等优势。本教程将详细介绍如何将DeepSeek接入OpenClaw，让你享受本地化AI助手的便利。

准备工作

1. 系统要求

• 已安装OpenClaw（版本2026.3.11或更高）
• Node.js环境（推荐v18+）
• DeepSeek API Key（可在DeepSeek官网申请）

2. 获取DeepSeek API Key

1. 访问 DeepSeek官网 2. 注册账号并登录 3. 进入API Keys管理页面 4. 创建新的API Key并妥善保存

详细步骤

步骤1：检查当前OpenClaw配置

# 查看当前模型配置
openclaw config get agents.defaults.model
查看所有可用模型
openclaw models list

步骤2：配置DeepSeek模型

#### 方法一：通过配置文件设置

创建或编辑OpenClaw配置文件（通常位于 ~/.openclaw/config.json）：

{
  "agents": {
    "defaults": {
      "model": "custom-api-deepseek-com/deepseek-chat"
    }
  },
  "models": {
    "custom-api-deepseek-com/deepseek-chat": {
      "provider": "custom-api",
      "apiBase": "https://api.deepseek.com",
      "apiKeyEnv": "DEEPSEEK_API_KEY",
      "model": "deepseek-chat",
      "contextWindow": 128000,
      "maxTokens": 4096,
      "temperature": 0.7,
      "streaming": true
    }
  }
}

#### 方法二：通过环境变量设置

# 设置DeepSeek API Key
export DEEPSEEK_API_KEY="你的API密钥"
设置默认模型
export OPENCLAW_AGENTS_DEFAULTS_MODEL="custom-api-deepseek-com/deepseek-chat"

#### 方法三：使用OpenClaw CLI命令

# 设置环境变量
openclaw config set env.DEEPSEEK_API_KEY "你的API密钥"
设置默认模型
openclaw config set agents.defaults.model "custom-api-deepseek-com/deepseek-chat"
配置模型参数
openclaw config set models.custom-api-deepseek-com/deepseek-chat '
{
  "provider": "custom-api",
  "apiBase": "https://api.deepseek.com",
  "apiKeyEnv": "DEEPSEEK_API_KEY",
  "model": "deepseek-chat",
  "contextWindow": 128000,
  "maxTokens": 4096,
  "temperature": 0.7,
  "streaming": true
}'

步骤3：验证配置

# 重启OpenClaw Gateway服务
openclaw gateway restart
检查服务状态
openclaw gateway status
测试模型连接
openclaw agent --message "你好，测试DeepSeek连接" --deliver

步骤4：高级配置（可选）

#### 配置多个DeepSeek模型

{
  "models": {
    "deepseek-chat": {
      "provider": "custom-api",
      "apiBase": "https://api.deepseek.com",
      "apiKeyEnv": "DEEPSEEK_API_KEY",
      "model": "deepseek-chat",
      "contextWindow": 128000,
      "maxTokens": 4096,
      "temperature": 0.7
    },
    "deepseek-coder": {
      "provider": "custom-api",
      "apiBase": "https://api.deepseek.com",
      "apiKeyEnv": "DEEPSEEK_API_KEY",
      "model": "deepseek-coder",
      "contextWindow": 128000,
      "maxTokens": 4096,
      "temperature": 0.2
    }
  }
}

#### 配置模型切换规则

{
  "agents": {
    "defaults": {
      "model": "deepseek-chat"
    },
    "hooks": {
      "modelSelector": {
        "type": "script",
        "script": "根据对话内容选择模型",
        "rules": [
          {
            "condition": "message contains '代码' or '编程'",
            "model": "deepseek-coder"
          },
          {
            "condition": "message contains '数学' or '推理'",
            "model": "deepseek-chat"
          }
        ]
      }
    }
  }
}

常见问题

Q1: 如何检查API Key是否有效？

# 使用curl测试API
curl -X POST https://api.deepseek.com/chat/completions \
  -H "Authorization: Bearer $DEEPSEEK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-chat",
    "messages": [{"role": "user", "content": "Hello"}],
    "stream": false
  }'

Q2: 遇到连接超时怎么办？

1. 检查网络连接 2. 确认API Base URL正确：https://api.deepseek.com 3. 检查防火墙设置 4. 尝试使用代理（如有需要）

Q3: 如何查看模型使用情况？

# 查看OpenClaw日志
openclaw logs --follow
查看模型调用统计
openclaw gateway status --verbose

Q4: 如何切换回其他模型？

# 临时切换
openclaw agent --model "openai/gpt-4" --message "测试消息"
永久切换
openclaw config set agents.defaults.model "openai/gpt-4"

Q5: DeepSeek API的速率限制是多少？

• 免费用户：每分钟10次请求
• 付费用户：根据套餐不同
• 建议：合理控制请求频率，避免触发限制

性能优化建议

1. 缓存配置

{
  "models": {
    "custom-api-deepseek-com/deepseek-chat": {
      "cache": {
        "enabled": true,
        "ttl": 300,
        "maxSize": 100
      }
    }
  }
}

2. 批量处理

对于多个相关请求，可以合并为一个请求，减少API调用次数。

3. 错误重试

{
  "models": {
    "custom-api-deepseek-com/deepseek-chat": {
      "retry": {
        "attempts": 3,
        "delay": 1000
      }
    }
  }
}

总结

通过本教程，你已经成功将DeepSeek接入OpenClaw。DeepSeek的优势在于： 1. 成本效益：相比国际模型，价格更具竞争力 2. 本地化支持：中文理解能力强，响应速度快 3. 长上下文：支持128K上下文，适合长文档处理 4. 无需VPN：国内直连，网络稳定

建议定期检查DeepSeek官方文档，了解API更新和新功能。OpenClaw的灵活配置让你可以根据需求随时调整模型参数，获得最佳使用体验。

下一步

1. 探索OpenClaw其他功能：技能库、自动化工作流等 2. 尝试DeepSeek不同模型：chat、coder等 3. 配置多模型切换，根据任务选择最优模型 4. 加入OpenClaw社区，分享使用经验

祝你使用愉快！