OpenClaw DeepSeek模型配置報(bào)錯(cuò)404的問題排查與解決方法

發(fā)布時(shí)間：2026-05-06 11:50:46 作者：技術(shù)達(dá)芬奇

今天在測(cè)試 OpenClaw 的飛書集成時(shí)，遇到了一個(gè)棘手的問題，在飛書（機(jī)器人：clawAdmin）中發(fā)送消息時(shí)，總是返回錯(cuò)誤，下面我們就來看看完整的調(diào)試過程和解決方案吧

問題背景

今天在測(cè)試 OpenClaw 的飛書集成時(shí)，遇到了一個(gè)棘手的問題：在飛書（機(jī)器人：clawAdmin）中發(fā)送消息時(shí)，總是返回錯(cuò)誤：

?? Something went wrong while processing your request. Please try again, or use /new to start a fresh session.

這篇文章記錄了完整的調(diào)試過程和解決方案。

問題診斷

第一步：查看日志

首先通過 OpenClaw 日志定位問題：

tail -f /tmp/openclaw-1001/openclaw-2026-05-04.log

發(fā)現(xiàn)關(guān)鍵錯(cuò)誤信息：

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

問題初步判斷：DeepSeek 模型調(diào)用返回 404，原因是 model_not_found。

第二步：驗(yàn)證 API 本身是否可用

首先排除 API Key 或網(wǎng)絡(luò)問題：

curl -X POST "https://api.deepseek.com/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxx" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [{"role": "user", "content": "你好"}],
    "max_tokens": 100
  }'

結(jié)果：API 本身工作正常，能夠正常返回響應(yīng)。

第三步：分析 OpenClaw 的 API 調(diào)用方式

問題 narrowed down 到 OpenClaw 如何調(diào)用 API。測(cè)試兩個(gè)不同的端點(diǎn)：

測(cè)試 1：Chat Completions 端點(diǎn) (/v1/chat/completions)

curl -X POST "https://api.deepseek.com/v1/chat/completions" ...

正常工作 - DeepSeek 標(biāo)準(zhǔn)支持的端點(diǎn)

測(cè)試 2：Responses 端點(diǎn) (/v1/responses)

curl -X POST "https://api.deepseek.com/v1/responses" ...

不工作 - DeepSeek 不支持 OpenAI Responses API 格式

第四步：檢查 OpenClaw 配置

查看 openclaw.json 中的 DeepSeek 配置：

{
  "deepseek": {
    "baseUrl": "https://api.deepseek.com",
    "apiKey": "sk-xxxxxx",
    "api": "openai-responses",  // ? 問題在這里！
    "models": [{
      "id": "deepseek-v4-flash",
      "name": "deepseek-v4-flash"
    }]
  }
}

關(guān)鍵發(fā)現(xiàn)：

"openai-responses" 類型調(diào)用的是 /v1/responses 端點(diǎn)
DeepSeek 不支持這個(gè)端點(diǎn)，只支持 /v1/chat/completions
因此需要將 API 類型改為 "openai-completions"

解決方案

步驟 1：修改配置文件

import json
config_path = "/home/openclaw-admin/.openclaw/openclaw.json"
with open(config_path, 'r') as f:
    data = json.load(f)
# 修改 DeepSeek 配置
if "deepseek" in data.get("models", {}).get("providers", {}):
    # 1. 將 API 類型從 openai-responses 改為 openai-completions
    data["models"]["providers"]["deepseek"]["api"] = "openai-completions"
    # 2. 確保 baseUrl 包含 /v1 后綴
    base_url = data["models"]["providers"]["deepseek"]["baseUrl"]
    if not base_url.endswith("/v1"):
        data["models"]["providers"]["deepseek"]["baseUrl"] = base_url.rstrip("/") + "/v1"
with open(config_path, 'w') as f:
    json.dump(data, f, indent=2)

修改后的配置：

{
  "deepseek": {
    "baseUrl": "https://api.deepseek.com/v1",  // ? 添加 /v1
    "apiKey": "sk-xxxxxx",
    "api": "openai-completions",  // ? 改為正確的類型
    "models": [{
      "id": "deepseek-v4-flash",
      "name": "deepseek-v4-flash"
    }]
  }
}

步驟 2：重啟 Gateway

# 殺死舊進(jìn)程
sudo pkill -f "node.*gateway.*39217"

# 啟動(dòng)新的 gateway
sudo -u openclaw-admin bash -c '
  cd ~
  nohup /home/linuxbrew/.linuxbrew/opt/node@24/bin/node \
    /home/openclaw-admin/.npm-global/lib/node_modules/openclaw/dist/index.js \
    gateway --port 39217 > /tmp/openclaw-admin-gateway.log 2>&1 &
  echo "Gateway started, PID: $!"
'

步驟 3：驗(yàn)證

在飛書中發(fā)送測(cè)試消息，確認(rèn)能夠正常收到回復(fù)。

技術(shù)要點(diǎn)總結(jié)

1. OpenClaw 支持的 API 類型

OpenClaw 目前支持以下主要 API 類型：

API 類型	調(diào)用端點(diǎn)	適用場(chǎng)景
`openai-completions`	`/v1/chat/completions`	大多數(shù)兼容 OpenAI 格式的 provider (DeepSeek, 火山引擎等)
`openai-responses`	`/v1/responses`	OpenAI 官方的 Responses API
`anthropic-messages`	`/v1/messages`	Anthropic Claude

重要：不是所有 provider 都支持所有 API 類型！

2. DeepSeek 的特殊性

支持：/v1/chat/completions (標(biāo)準(zhǔn) Chat Completions)
不支持：/v1/responses (OpenAI Responses API)
不支持：/v1/completions (舊的文本補(bǔ)全)

3. 配置驗(yàn)證清單

配置新的 model provider 時(shí)，需要確認(rèn)：

api 類型是否匹配 provider 實(shí)際支持的端點(diǎn)
baseUrl 是否正確（是否需要 /v1 后綴）
apiKey 是否有效
model.id 是否是 provider 支持的真實(shí)模型 ID
網(wǎng)絡(luò)連通性（防火墻、代理等）

踩坑記錄

坑 1：想當(dāng)然認(rèn)為 "openai-chat" 存在

一開始我嘗試把配置改成 "api": "openai-chat"，結(jié)果遇到錯(cuò)誤：

Invalid option: expected one of "openai-completions"|"openai-responses"|...

教訓(xùn)：先查看 OpenClaw 實(shí)際支持哪些值，不要想當(dāng)然。

坑 2：配置修改后沒有立即生效

OpenClaw gateway 有配置緩存，修改配置后必須重啟進(jìn)程才能生效。

坑 3：baseUrl 的 /v1 后綴

不同 provider 的 baseUrl 格式不同：

DeepSeek：https://api.deepseek.com/v1（需要 /v1）
OpenAI：https://api.openai.com/v1（需要 /v1）
有些 provider 可能不需要 /v1 后綴

調(diào)試工具推薦

1. 實(shí)時(shí)日志監(jiān)控

tail -f /tmp/openclaw-1001/openclaw-2026-05-04.log | grep -A 5 -B 5 "error|Error|404"

2. 直接測(cè)試 API 端點(diǎn)

# 測(cè)試 Chat Completions
curl -X POST "https://api.deepseek.com/v1/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY" \
  -d '{"model": "deepseek-v4-flash", "messages": [{"role": "user", "content": "hi"}]}'

# 列出支持的模型
curl -X GET "https://api.deepseek.com/v1/models" \
  -H "Authorization: Bearer $API_KEY"

3. 檢查進(jìn)程狀態(tài)

ps aux | grep openclaw-admin | grep node
netstat -tlnp | grep 39217

最終成功配置

這是最終工作的 DeepSeek 配置：

{
  "models": {
    "mode": "merge",
    "providers": {
      "deepseek": {
        "baseUrl": "https://api.deepseek.com/v1",
        "apiKey": "sk-xxxx",
        "api": "openai-completions",
        "models": [
          {
            "id": "deepseek-v4-flash",
            "name": "deepseek-v4-flash",
            "reasoning": true,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0
            },
            "contextWindow": 128000,
            "maxTokens": 8192
          }
        ]
      }
    }
  }
}

結(jié)語

LLM 集成雖然看起來簡(jiǎn)單（都是 OpenAI 兼容格式），但實(shí)際每個(gè) provider 的實(shí)現(xiàn)細(xì)節(jié)都有差異。遇到 404 錯(cuò)誤時(shí)，不要只懷疑模型 ID，還要檢查：

端點(diǎn)路徑是否正確
API 類型是否匹配
baseUrl 是否包含正確的前綴

以上就是OpenClaw DeepSeek模型配置報(bào)錯(cuò)404的問題排查與解決方法的詳細(xì)內(nèi)容，更多關(guān)于OpenClaw DeepSeek 404報(bào)錯(cuò)解決的資料請(qǐng)關(guān)注腳本之家其它相關(guān)文章！

Tag：OpenClaw DeepSeek

最新国产好看的视频,伊人天堂AV在线,国产Aaaaaa视频,蜜臀视频在线观看一区,人妻av色图,密臀久久久精品影片,青青视频免费观看毛片,久草在线观看视,国产三级精品色情在线