OpenClaw + DeepSeek 配置指南

概述

本指南帮助您将OpenClaw升级到最新版本并配置DeepSeek模型。DeepSeek是当前性价比最高的AI模型之一，具有以下优势：

- 价格便宜: ¥1/百万tokens（比GPT-4便宜约30倍）

• 上下文长: 128K tokens上下文窗口
• 性能强大: 接近GPT-4水平，中文表现优异
• 原生支持: OpenClaw 2026.3+ 版本原生集成

  前提条件

  1. 已安装OpenClaw（任何版本）

2. Node.js环境（npm或pnpm） 3. DeepSeek API密钥（从 https://platform.deepseek.com 获取） 4. root权限（用于服务管理）

脚本说明

1. 完整升级脚本 (upgrade_openclaw_deepseek.sh)

功能：

• 检查当前OpenClaw版本
• 升级到最新版本
• 配置DeepSeek API密钥
• 设置DeepSeek为默认模型
• 重启相关服务
• 验证配置

  适用场景：

• 需要从旧版本升级
• 全新配置DeepSeek
• 需要完整的升级流程

  使用方法：

下载脚本
curl -O https://raw.githubusercontent.com/your-repo/upgrade_openclaw_deepseek.sh
添加执行权限
chmod +x upgrade_openclaw_deepseek.sh
运行脚本（需要root）
sudo bash upgrade_openclaw_deepseek.sh

2. 快速配置脚本 (configure_deepseek_quick.sh)

功能：

• 仅配置DeepSeek（不升级OpenClaw）
• 简单的交互式配置
• 自动备份原配置
• 重启服务验证

  适用场景：

• 已安装OpenClaw 2026.3+ 版本
• 只需配置DeepSeek API密钥
• 快速部署

  使用方法：

下载脚本
curl -O https://raw.githubusercontent.com/your-repo/configure_deepseek_quick.sh
添加执行权限
chmod +x configure_deepseek_quick.sh
运行脚本
bash configure_deepseek_quick.sh

手动配置步骤

如果您不想使用脚本，可以手动配置：

步骤1：获取DeepSeek API密钥

1. 访问 https://platform.deepseek.com 2. 注册/登录账号 3. 进入 "API Keys" 页面 4. 点击 "Create new secret key" 5. 复制生成的API密钥

步骤2：更新OpenClaw配置

编辑配置文件 ~/.openclaw/openclaw.json：

{
  "auth": {
    "profiles": {
      "deepseek:default": {
        "provider": "deepseek",
        "mode": "api_key",
        "apiKey": "您的API密钥"
      }
    }
  },
  "models": {
    "providers": {
      "deepseek": {
        "baseUrl": "https://api.deepseek.com",
        "api": "openai-completions",
        "models": [
          {
            "id": "deepseek-chat",
            "name": "DeepSeek Chat",
            "api": "openai-completions",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 131072,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "deepseek/deepseek-chat"
      },
      "models": {
        "deepseek/deepseek-chat": {
          "alias": "DeepSeek"
        }
      }
    }
  }
}

步骤3：重启服务

重启gateway服务
sudo systemctl restart openclaw-gateway
重启node服务（如果有）
sudo systemctl restart openclaw-node

步骤4：验证配置

检查状态
openclaw status
查看会话信息
openclaw status | grep -A5 "Sessions"

故障排除

常见问题

1. API密钥无效 - 检查密钥是否正确复制 - 确保账户有余额 - 验证API端点：curl https://api.deepseek.com/v1/models

2. 服务启动失败 - 检查日志：journalctl -u openclaw-gateway -f - 验证端口：netstat -tlnp | grep 18789 - 重启服务：sudo systemctl daemon-reload

3. 模型不可用 - 检查配置格式：jq .models.providers.deepseek ~/.openclaw/openclaw.json - 验证模型名称：确保使用 deepseek/deepseek-chat

4. 权限问题 - 确保以正确用户运行：whoami - 检查文件权限：ls -la ~/.openclaw/

日志查看

查看gateway日志
sudo journalctl -u openclaw-gateway -f
查看OpenClaw日志
openclaw logs --follow
查看错误日志
openclaw logs --level error

性能优化建议

1. 启用缓存：DeepSeek支持缓存，可降低重复请求成本 2. 调整上下文：根据需求调整上下文窗口大小 3. 批量处理：合并多个小请求为单个大请求 4. 监控用量：定期检查API使用情况

安全注意事项

1. 保护API密钥：不要将密钥提交到版本控制 2. 限制访问：配置适当的防火墙规则 3. 定期更新：保持OpenClaw和依赖项最新 4. 监控日志：定期检查异常活动

进阶配置

多模型配置

您可以配置多个模型，根据场景切换：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "deepseek/deepseek-chat",
        "fallback": "openai/gpt-4o-mini"
      }
    }
  }
}

成本控制

设置使用限制：

{
  "models": {
    "providers": {
      "deepseek": {
        "models": [{
          "cost": {
            "input": 0.14,
            "output": 0.28,
            "dailyLimit": 1000  # 每日限制1000元
          }
        }]
      }
    }
  }
}

支持与反馈

如有问题，请： 1. 查看OpenClaw文档：https://docs.openclaw.ai 2. 加入社区：https://discord.com/invite/clawd 3. 提交Issue：https://github.com/openclaw/openclaw/issues

---

最后更新: 2026-03-28 作者: 101（团队协调者） 版本: 1.0.0