问题

需要将 OpenClaw 配置为使用 gemma-4-31b-it 作为默认模型，并确保其能够正常工作。

根本原因

修复这个问题主要涉及三层兼容性问题：

OpenRouter / HuggingFace Router 不支持 Gemma 4 的 tool/function calling
而 OpenClaw 的 agent 依赖工具调用，因此这些接入方式不可用。
OpenClaw 内置的 google/ provider 不包含 Gemma 模型*
因此直接使用内置 Google provider 时，gemma-4-31b-it 会被识别为未知模型。
Gemma 4 的流式响应中包含 "thought": true 的 thinking / reasoning token
OpenClaw 的响应解析器会尝试将其按结构化 reasoning 输出处理，进而触发 MALFORMED_RESPONSE 错误。

修复方式

解决方案是：

使用 自定义 google-ai provider
使用 Google Generative AI 原生 API 格式
在模型定义中加入 "reasoning": false

这样可以让 OpenClaw 跳过对 reasoning/thinking token 的解析，从而避免 Gemma 4 的 thought chunk 导致解析失败。

需要修改的配置

1. 在~/.openclaw/openclaw.json

中添加自定义 provider

在 models.providers 下加入：

 代码块
PlainText
自动换行
复制代码
"google-ai": {
  "baseUrl": "<https://generativelanguage.googleapis.com/v1beta>",
  "api": "google-generative-ai",
  "authHeader": true,
  "models": [
    {
      "id": "gemma-4-31b-it",
      "name": "Gemma 4 31B IT",
      "reasoning": false,
      "input": ["text", "image"],
      "cost": {
        "input": 0,
        "output": 0
      },
      "contextWindow": 262144,
      "maxTokens": 32768
    }
  ]
}
复制成功

2. 在~/.openclaw/openclaw.json

中设置默认模型和主 agent 模型

 代码块
PlainText
自动换行
复制代码
// agents.defaults.model
"primary": "google-ai/gemma-4-31b-it",
"fallbacks": ["minimax/MiniMax-M2.7", "minimax-portal/MiniMax-M2.1"]

// agents.list[0]（主 agent）
"primary": "google-ai/gemma-4-31b-it"

// agents.defaults.models（模型目录项）
"google-ai/gemma-4-31b-it": {
  "alias": "gemma4"
}
复制成功

3. 在~/.openclaw/agents/main/agent/auth-profiles.json

中添加认证配置

 代码块
PlainText
自动换行
复制代码
"google-ai:default": {
  "type": "api_key",
  "provider": "google-ai",
  "key": "<GOOGLE_AI_STUDIO_API_KEY>"
}
复制成功

4. 在~/.openclaw/.env

中配置 API Key

 代码块
PlainText
自动换行
复制代码
GOOGLE_AI_API_KEY=AIza...
复制成功

关键点总结

要让 OpenClaw 正常使用 Gemma 4 31B IT，核心是三点：

不使用 OpenRouter / HuggingFace Router 作为 Gemma 4 的 tool use 接入方式
通过自定义 google-ai provider 直连 Google AI Studio
在模型定义中设置 "reasoning": false，避免 OpenClaw 解析 Gemma 4 的 thinking token 时出错