openclaw调用deepseek需明确选择云端api或本地加载路径：①云端api需api key、网络及正确模型名（如deepseek-chat）；②本地加载仅支持v2/v3/v4-flash量化版，要求16gb显存、cuda 12.4、transformers==4.40.0及特定配置。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想让OpenClaw在本地跑起来并调用DeepSeek模型，不是简单改个配置文件就能成——它要求你明确区分“调用云端API”和“加载本地模型”两种路径，选错一步，后续所有请求都会卡在401或Connection refused。你得先决定是走轻量级API调用，还是重载型本地推理，再按对应路径操作。
确认接入方式：API调用 or 本地加载
OpenClaw本身不内置模型，只提供统一调度层。DeepSeek目前提供两类官方可用入口：
① 【云端API】：适用于DeepSeek-V3/V4-pro/V4-flash，无需显卡，但必须有网络、API Key，且依赖DeepSeek官方服务稳定性；
② 【本地HuggingFace模型】：仅支持DeepSeek-V2/V3（MoE结构已适配）、V4-flash（需量化版），要求至少16GB显存GPU+CUDA 12.4，且必须用transformers==4.40.0，高版本会触发MoE路由崩溃。
注意：DeepSeek-V4-pro官方未开放完整权重，本地加载仅限flash版本；若强行用v4-pro的API endpoint填进本地加载配置，OpenClaw会报ValueError: model_type 'deepseek-v4-pro' not supported并退出。
方法一：接入DeepSeek云端API（推荐新手）
第一步：访问DeepSeek Platform，登录后进入API Keys页面，点击「Create new key」生成密钥，复制保存；
第二步：打开OpenClaw项目根目录下的config.yaml，定位到llm:区块，将provider:设为deepseek，api_key:粘贴刚复制的密钥；
第三步：设置模型名称——V4-pro用户填deepseek-chat，V4-flash用户填deepseek-chat-flash，V3用户填deepseek-coder（注意大小写与连字符，填错直接返回404）；
第四步：保存配置，终端执行openclaw serve启动服务，用curl http://localhost:8000/v1/chat/completions -X POST -H "Content-Type: application/json" -d '{"model":"deepseek-chat","messages":[{"role":"user","content":"hi"}]}'验证连通性。
方法二：加载DeepSeek-V3本地模型（需GPU）
方法二前提：【必须使用conda环境，且已安装flash-attn==2.5.6】，否则MoE专家路由无法激活，模型加载时会静默跳过部分专家层，导致输出质量断崖式下降；
第一步：执行pip install git+https://github.com/deepseek-ai/DeepSeek-Coder.git拉取官方V3模型代码仓；
第二步：从HuggingFace下载已量化V3-MoE模型（推荐deepseek-ai/deepseek-coder-33b-instruct-q4_k_m），解压到models/deepseek-v3/目录；
第三步：修改config.yaml中llm:区块：provider: huggingface → model_path: ./models/deepseek-v3/ → trust_remote_code: true（缺这行会报ModuleNotFoundError: No module named 'modeling_deepseek'）；
第四步：在llm:下新增device_map: "auto"和load_in_4bit: true，确保16GB显存能承载33B模型；
这一步操作起来很简单，直接把文件拖进去就行。但如果你用的是RTX 3090，必须额外加torch_dtype: "bfloat16"，否则半精度计算会溢出，生成结果全为。
方法三：用EchoBird一键接管配置（零命令行）
方法三适合被环境变量和YAML缩进折磨过三次以上的人——它绕过所有手动编辑，图形界面直连；
方法一：从EchoBird Release页下载最新Windows/macOS安装包，双击完成安装；
方法二：启动EchoBird → 点击「模型中心」→ 搜索「DeepSeek」→ 选择「DeepSeek-V4-flash API」或「DeepSeek-V3本地」→ 点击「配置」按钮；
方法三：填入API Key或选择本地模型路径 → 点击「应用并重启OpenClaw」→ 状态栏显示绿色「Online」即生效。
