云端模型问题

编号格式 #NNNNN 对应 GitHub issue，可直接搜索去重。

---

AWS Bedrock 部分模型报 text field is blank

来源：GitHub #30117（2026-02）

现象：使用 AWS Bedrock 提供商时，部分模型的 AI 响应返回空内容，Gateway 日志报错 text field is blank。

原因：某些 Bedrock 模型（如 Claude 3 Haiku via Bedrock）的响应格式与 OpenClaw 解析器预期不符，解析器未能正确提取文本内容。

解决方法：

切换到 Sonnet 级别及以上的模型（临时规避）：

{
  agents: {
    defaults: {
      model: {
        primary: "bedrock/anthropic.claude-3-5-sonnet-20241022-v2:0"
      }
    }
  }
}

等待官方修复 Bedrock 响应解析器（issue 已追踪）。

---

Memory Search 功能超时失败（中国大陆）

来源：GitHub #38503（2026-03）

现象：Memory Search 功能始终超时失败，但对话、工具调用等其他功能正常。

原因：Memory Search 依赖外部向量搜索服务，且该服务的网络请求不支持 HTTP 代理配置，中国大陆网络直连被阻断。

解决方法：

1. 透明代理（推荐）：使用 TUN 模式代理工具（Clash Meta、sing-box），让 Gateway 所有流量走代理
2. 暂时禁用：

{
  tools: {
    memory: {
      search: { enabled: false }
    }
  }
}

官方已记录代理支持需求，未来版本有望支持 HTTPS_PROXY 环境变量。

---

Kimi K-2.5 持续报 401 Invalid Authentication

来源：GitHub #46957（2026-03）

现象：配置 Moonshot Kimi K-2.5 后，每次收到消息都报错：

[agent/embedded] error=HTTP 401: Invalid Authentication
model=kimi-k2.5 provider=moonshot

即使 API Key 看起来有效，仍然无法通过认证。

原因：openclaw onboard 向导没有将 API Key 正确写入 openclaw.json 的 models.providers.moonshot.apiKey 字段。

解决方法：

手动确认 ~/.openclaw/openclaw.json 中 Moonshot 配置完整：

{
  models: {
    providers: {
      moonshot: {
        baseUrl: "https://api.moonshot.ai/v1",
        apiKey: "sk-xxxxxxxxxxxx"   // 直接填 Key，不要用 ${ENV_VAR}
      }
    }
  },
  agents: {
    defaults: {
      model: { primary: "moonshot/kimi-k2.5" }
    }
  }
}

openclaw gateway restart

先在 Moonshot 控制台 确认 Key 本身有效（未欠费/未失效）。

---

Google OpenAI-compat 接口返回 400（store 字段不支持）

来源：GitHub #53658（2026-03）

现象：使用 Google 的 OpenAI 兼容端点时，Agent 内嵌调用或 fallback 路径报错：

400 status code (no body)
INVALID_ARGUMENT: Unknown name "store": Cannot find field.

原因：OpenClaw 发送的请求体中包含 "store": false 字段，OpenAI 原生 API 支持但 Google OpenAI-compat 接口不识别，直接拒绝。

解决方法：

在 provider 配置中启用 Google 兼容模式：

{
  providers: {
    google: {
      baseUrl: "https://generativelanguage.googleapis.com/v1beta/openai/",
      apiKey: "your-google-api-key",
      compatibility: "google"    // 过滤不支持的字段
    }
  }
}

如无 compatibility 选项（旧版本），改用 vertex provider 替代 OpenAI-compat 路径。

---

另见

• 本地模型问题
• 密钥管理（SecretRef）
• ← 提供商问题总览