OpenClaw 免费 AI 大模型选型与配置指南

建议保留一个通用模型为主，编码模型为备。规模由小到大，后续可随时扩展。

注意：由于 SDK 和流式传输的特殊性，某些 Ollama 构建版本可能禁用流式输出。如果发现文本中泄露奇怪的工具标记，通常是此原因。请将流式传输视为可选功能。

其他 OpenAI 兼容运行时

LM Studio、vLLM、LiteLLM、llama.cpp 等均可通过 .models.providers 配置使用。

示例配置模式：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "lmstudio/minimax-m2.1-gs32"
      },
      "models": {
        "lmstudio/minimax-m2.1-gs32": {
          "alias": "MiniMax"
        }
      }
    }
  },
  "models": {
    "providers": {
      "lmstudio": {
        "baseUrl": "http://localhost:1234/v1",
        "apiKey": "LMSTUDIO_KEY",
        "api": "openai-completions",
        "models": [
          {
            "id": "minimax-m2.1-gs32",
            "name": "MiniMax M2.1",
            "contextWindow": 200000,
            "maxTokens": 8192,
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            }
          }
        ]
      }
    }
  }
}

注意 cost 字段设为零，这提示本地模式不按令牌计费。

托管选项与免费访问途径

以下服务商提供无需立即付费的运行环境，但条款和配额可能变动，请视为清单而非承诺。

Qwen OAuth

推荐方案，无需轮换大量 API 密钥。OpenClaw 通过 OAuth 设备代码流程支持 Qwen。

启用插件并登录：

openclaw plugins enable qwen-portal-auth
openclaw models auth login --provider qwen-portal --set-default

模型参考格式：

• qwen-portal/coder-model
• qwen-portal/vision-model

Qwen 文档描述了每日免费请求配额。对于个人代理，免费版通常能满足实际需求。

OpenRouter 免费模型

OpenRouter 聚合了多个模型，部分模型带有 :free 后缀。

在 OpenClaw 中设置：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "openrouter/meta-llama/llama-3.2-3b-instruct:free"
      }
    }
  }
}

免费模型可能随时间变化，需定期评估并配置备用模型。

Groq

Groq 以速度快著称，通常提供充足的实验流量。具体配额取决于地区和账户级别。

OpenClaw 内置 Groq 支持，使用 GROQ_API_KEY。

Google Gemini

内置提供商，使用 GEMINI_API_KEY。免费用量和速率限制因产品类型而异，建议参考官方社区讨论了解大致上限。

Mistral

内置提供商，使用 MISTRAL_API_KEY。若所在地区有免费套餐，可作为不错的通用备选。

Cohere

常用于摘要和分类。可使用直接提供商或 OpenAI 兼容代理。免费套餐建议仅作为备用方案。

Moonshot Kimi

Kimi 通常非永久免费，但可通过活动或积分获取。可配置为具有 OpenAI 兼容基础 URL 的自定义提供商。

示例框架：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "moonshot/kimi-k2.5"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "moonshot": {
        "baseUrl": "https://api.moonshot.ai/v1",
        "apiKey": "${MOONSHOT_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "kimi-k2.5",
            "name": "Kimi K2.5"
          }
        ]
      }
    }
  }
}

Kimi Coding 是单独的提供程序路由，使用 KIMI_API_KEY。

DeepSeek

描述为'基本免费'，但这取决于运行方式。本地运行仅需硬件成本；托管 API 通常成本较低但非完全免费。

回退方案设置

OpenClaw 通过两层机制处理故障：同一提供商内轮换身份验证配置文件，或回退到下一个模型 agents.defaults.model.fallbacks。

免费套餐更容易触发速率限制或'计费已禁用'状态。OpenClaw 会跟踪冷却时间，并在发生计费错误时延长用户配置文件的禁用时间。

身份验证配置文件的持久性

OpenClaw 将 API 密钥和 OAuth 令牌存储在身份验证配置文件中。为了缓存友好，每个会话固定一个选定的配置文件。

如果设置了多个配置文件，OpenClaw 可按顺序或轮询规则轮换。若感觉 OAuth 登录'消失'，通常是因为登录名轮换。如需可预测行为，请固定登录顺序。

安全设置

政策架构中以下几项至关重要：

• 切勿提交 API 密钥。请将它们放在环境变量或 systemd 环境变量文件中。
• 不要将网关暴露在公共互联网上。请使用令牌、隧道或合适的反向代理。
• 保持工具访问权限合理。即使是免费模型，如果代理拥有危险工具权限，仍可能执行危险操作。

快速故障排除

OpenClaw 无法识别任何模型

• 运行 openclaw models list 确认服务提供商出现。
• 如果使用 Ollama，确保服务可访问且 ollama list 显示模型。
• 如果使用代理，确认其 baseUrl 是否包含 /v1 且符合 OpenAI API 规范。

一直遇到 401 或 403 错误

• 检查对应提供程序的正确环境变量。OpenClaw 文档列出了所需的身份验证变量。
• 如果有多个身份验证配置文件，故障的可能被轮换使用。检查配置文件顺序和冷却状态。

一直遇到 429 速率限制

• 添加备用方案，以便在限速时切换模型。
• 对于高负载工作流（如长文档摘要），应降低并发量。
• 如果是免费套餐，请接受这是正常现象并据此设计。