在使用 OpenClaw 集成 DeepSeek 模型时你是否也遇到过 404 错误？这不仅令人头疼，还可Neng让你在调试时感到无从下手。本文将从多个角度深入分析问题根源，并提供一套完整的解决方案，帮助你快速定位并修复问题。

问题初现：飞书消息返回 404

在Zui近一次测试中，我们发现当通过飞书机器人发送消息时系统返回了如下错误信息：

{
  "event": "embedded_run_agent_end",
  "isError": true,
  "error": " status code ",
  "failoverReason": "model_not_found",
  "model": "deepseek-v4-flash",
  "provider": "deepseek"
}

这个错误提示中，model_not_found 是关键线索。它意味着 OpenClaw 无法找到指定的模型，可Neng是因为配置错误或模型名称不正确。

错误排查第一步：检查 API Key 和网络连接

在深入排查配置前，我们 需要确认两个基本点：

API Key 是否正确配置？ 请检查你的 openclaw.json 配置文件中是否正确填写了 DeepSeek 的 API Key。

网络连接是否正常？ 你Ke以使用如下命令测试 API 连接是否正常：

curl -X POST "https://api.deepseek.com/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"model": "deepseek-v4-flash", "messages": , "max_tokens": 100}'

Ru果返回正常响应，说明 API 本身没有问题，问题出在 OpenClaw 的配置上。

错误定位：OpenClaw 配置问题

通过查kan日志，我们发现如下关键错误信息：

{
  "event": "embedded_run_agent_end",
  "isError": true,
  "error": " status code ",
  "failoverReason": "model_not_found",
  "model": "deepseek-v4-flash",
  "provider": "deepseek"
}

这说明 OpenClaw 无法找到指定的模型，问题可Neng出在模型名称、API 类型或 Base URL 配置上。

修复步骤一：检查并修改配置文件

我们需要检查并修改 opencl04.json 文件中的 DeepSeek 配置。

{
  "deepseek": {
    "baseUrl": "https://api.deepseek.com/v1",
    "apiKey": "sk-xxxxxx",
    "api": "openai-completions",
    "models": 
  }
}

注意以下几点：

baseUrl 必须包含 /v1 后缀

api 字段必须设置为 openai-completions，而不是 openai-responses

修复步骤二：删除错误配置文件

Ru果你Yi经尝试过错误的配置，建议你清除所有错误的配置文件，避免冲突：

# 停止正在运行的网关
openclaw gateway stop
# 删除配置文件
rm -f ~/.openclaw/openclaw.json
rm -f ~/.openclaw/agents/main/agent/config.json
rm -f ~/.openclaw/agents/main/agent/auth-profiles.json

修复步骤三：重启网关

在修改完配置后必须重启网关以使geng改生效：

# 杀死旧进程
sudo pkill -f "node.*gateway.*"
# 启动新的网关
sudo -u openclaw-admin bash -c '
  cd ~
  nohup /home/linuxbrew/.linuxbrew/opt/node@/bin/node \
    /home/openclaw-admin/.npm-global/lib/node_modules/openclaw/dist/index.js \
    gateway --port > /tmp/openclaw-admin-gateway.log 2>&1 &
  echo "Gateway started, PID: $!"
'

修复步骤四：验证配置

在飞书中发送测试消息，确认Neng够正常收到回复。Ru果仍然遇到 404 错误，请检查以下几点：

模型名称是否正确？

API 类型是否为 openai-completions？

Base URL 是否包含 /v1？

常见错误与解决方法

在配置新的 model provider 时需要确认：

Base URL 是否正确填写？

API 类型是否为 openai-completions？

模型名称是否正确？

{
  "models": {
    "mode": "merge",
    "providers": {
      "deepseek": {
        "baseUrl": "https://api.deepseek.com/v1",
        "apiKey": "sk-xxxx",
        "api": "openai-completions",
        "models": ,
            "cost": {
              "input": 0.0005,
              "output": 0.001
            },
            "contextWindow": 1000000,
            "maxTokens": 4096
          }
        ]
      }
    }
  }
}

请确保模型名称正确，例如 deepseek-v4-flash 或其他指定变体。Ru果上述过程顺利完成而仍然遭遇 404 错误，建议重新检查官方文档中的Zui新可用模型列表。

LLM 集成虽然kan起来简单，但实际每个 provider 的实现细节dou有差异。遇到 404 错误时不要只怀疑模型 ID，还要检查：

Base URL 是否正确？

API 类型是否为 openai-completions？

模型名称是否正确？

希望这篇文章Neng帮助遇到类似问题的同学！

---