提供商配置问题

本页收录近期 GitHub Issues 中 AI 提供商配置相关高频问题，精选有明确解决方案的案例。

---

问题 1：配置 Ollama 本地模型时保存按钮无响应

来源：GitHub #38563（2026-03）

现象：在 Control UI 的配置界面尝试添加 Ollama 本地模型时，保存按钮无响应，或提示字段验证失败。

原因：OpenClaw 的 Zod schema 验证规则要求 API Key 字段非空（该规则原为 Anthropic 等需要 API Key 的提供商设计），而 Ollama 本地运行不需要 API Key，留空会导致验证失败。

解决方法：

方案 1（推荐）：在 API Key 字段填入任意占位字符串：

API Key: ollama

方案 2：直接编辑 ~/.openclaw/openclaw.json 手动添加配置：

{
  "providers": {
    "ollama": {
      "baseUrl": "http://127.0.0.1:11434",
      "apiKey": "ollama"
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "ollama/llama3.2"
      }
    }
  }
}

---

问题 2：Cron 任务或子 Agent 提示 provider 未配置

来源：GitHub #29886（2026-01）

现象：主 Agent 运行正常，但 Cron 定时任务或通过 sessions_spawn 创建的子 Agent 报错：provider 未配置，无法调用 AI 接口。

原因：Cron 任务和子 Agent 在独立的隔离 session 中运行，不继承主进程的环境变量。通过 $ENV_VAR 引用方式配置的 API Key 在隔离环境中不可见。

解决方法：

将 API Key 直接写入配置文件，而非通过环境变量引用：

{
  "providers": {
    "anthropic": {
      "apiKey": "sk-ant-xxxxx"   // 直接写值，而非 "$ANTHROPIC_API_KEY"
    }
  }
}

安全提示：如果 openclaw.json 存储在版本控制中，请确保将其加入 .gitignore，避免 API Key 泄露。

---

问题 3：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 已追踪）。

---

问题 4：Memory Search 无法使用（中国大陆）

来源：GitHub #38503（2026-03）

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

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

解决方法：

1. 透明代理（推荐）：使用 TUN 模式代理工具（如 Clash Meta、sing-box），让 Gateway 进程的所有流量都经过代理，无需单独配置每个应用。

2. 机器级代理：在 Gateway 所在机器（或 Docker 容器宿主机）上配置全局系统代理。

3. 暂时禁用：在 openclaw.json 中禁用 Memory Search，等待官方支持代理配置：

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

注意：官方已在 issue 中记录了代理支持需求，未来版本有望支持通过 HTTPS_PROXY 环境变量配置。

---

另见

• 渠道连接问题
• 安装后设置 - 凭证存储