若无法调用DeepSeek V4模型，需检查API端点、密钥格式及模型标识：一、命令行注入配置；二、修改openclaw.json；三、.env环境变量注入；四、Web管理界面配置。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已安装OpenClaw客户端，但无法调用DeepSeek最新发布的V4模型，则可能是由于配置中未正确指定V4专属API端点、密钥格式不匹配或模型标识未更新。以下是完成DeepSeek V4客户端密钥配置的多种可行路径：
一、通过命令行直接注入V4配置参数
该方法绕过手动编辑文件，利用OpenClaw内置配置命令实时写入V4专用参数，确保模型ID、Base URL与认证方式严格对齐DeepSeek官方V4接口规范。
1、打开终端（Windows PowerShell / macOS Terminal / Linux Bash），确认OpenClaw服务未运行，执行：openclaw gateway stop
2、执行V4专属配置指令，将your_v4_api_key替换为从DeepSeek平台获取的真实密钥（格式仍为sk-开头，但需确认属V4权限范围）：openclaw config set models.providers.deepseek-v4 '{ "baseUrl": "https://api.deepseek.com/v4", "apiKey": "your_v4_api_key", "api": "openai-completions", "models": [ { "id": "deepseek-v4-chat", "name": "DeepSeek V4 Chat" }, { "id": "deepseek-v4-coder", "name": "DeepSeek V4 Coder" } ] }'
3、设定默认使用V4 Chat模型：openclaw config set agents.defaults.model.primary "deepseek-v4/deepseek-v4-chat"
4、重启网关以加载新配置：openclaw gateway restart
二、修改本地openclaw.json配置文件
该方法适用于需要长期保留V4配置、或命令行工具因权限/环境限制不可用的场景。通过直接编辑JSON结构，可精确控制V4模型的请求头、超时、重试等底层行为。
1、定位配置文件路径：Windows为C:\Users\你的用户名\.openclaw\openclaw.json；macOS/Linux为~/.openclaw/openclaw.json
2、用文本编辑器（如VS Code、Notepad++）打开该文件，在"models": { "providers": {}}对象内新增"deepseek-v4"键值对，完整填入以下内容（注意保留原始缩进与逗号）：
"deepseek-v4": { "baseUrl": "https://api.deepseek.com/v4", "apiKey": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx", "api": "openai-completions", "timeout": 60000, "models": [ { "id": "deepseek-v4-chat", "name": "DeepSeek V4 Chat" } ] }
3、在"agents": { "defaults": { "model": { "primary": "" } } }中，将"primary"字段值设为："deepseek-v4/deepseek-v4-chat"
4、保存文件后，在终端执行：openclaw gateway reload
三、使用.env环境变量注入V4密钥
该方法将密钥与配置解耦，符合安全最佳实践，尤其适合容器化部署或多人协作环境。.env文件中的变量会自动覆盖配置文件中同名字段，优先级更高。
1、在OpenClaw主程序所在目录（或用户根目录）创建名为.env的纯文本文件（无扩展名，Windows需关闭“隐藏已知文件类型扩展名”选项）
2、向该文件写入以下两行（必须顶格、无空格、无引号）：
LLM_PROVIDER=deepseek-v4
DEEPSEEK_V4_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
3、确保OpenClaw启动时读取该文件：在终端中进入OpenClaw目录，执行openclaw --env .env gateway start
4、验证环境变量是否生效：执行openclaw config get models.providers.deepseek-v4.apiKey，应返回密钥前缀而非占位符
四、通过Web管理界面配置V4模型（需启用Admin UI）
该方法面向不熟悉命令行的用户，提供可视化表单填写界面，自动校验Base URL格式与密钥长度，并支持一键测试连通性。
1、确认OpenClaw已启用Admin后台：检查.env或openclaw.json中"admin": { "enabled": true }且"port"非冲突（默认3000）
2、启动服务后，浏览器访问：http://localhost:3000/admin，使用OPENCLAW_ADMIN_PASSWORD登录
3、进入【模型管理】→【添加提供商】，选择Provider Type为DeepSeek (V4)
4、在表单中依次填入：API Key（完整sk-字符串）、Base URL（https://api.deepseek.com/v4）、Model ID（deepseek-v4-chat）
5、点击【保存并测试】，页面显示✅ Connection successful: Received response from DeepSeek V4即表示配置就绪
