OpenClaw 免费 AI 大模型配置指南

如果你想要一套合理的'入门'模型，可以保留一个通用模型作为主模型，再添加一个编码模型作为备用。一开始规模要小，以后可以随时扩展。

Ollama 关于流媒体的警告

由于 SDK 和流格式的特殊性，某些 Ollama 配置的构建版本会禁用流式传输。如果您发现文本输出中泄露了奇怪的工具标记，通常就是这个原因。请将流式传输视为可选而非必需。

LM Studio, vLLM, LiteLLM, llama.cpp 和其他 OpenAI 兼容运行时

OpenClaw 可以通过几乎任何 OpenAI 兼容的基本 URL 使用它们。文档甚至展示了带有显式提供程序配置的 LM Studio 风格端点的模式。

示例模式：

{
  "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 字段的值都设置为零。这在配置中是一个很好的提示：本地模式意味着不按令牌计费。

提供免费套餐和免费访问途径的托管选项

本部分介绍一些可以让你无需立即付费即可运行 OpenClaw 的服务商。条款和配额可能会有所变动，有些'免费'服务实际上只是'促销额度用完前免费'。请将此视为一份清单，而非承诺。

Qwen OAuth

如果你想要一个不错的免费套餐，又不想费劲地'轮换 12 个 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 的文档中描述了与 OAuth 访问相关的每日免费请求配额。

我个人的看法是： Qwen 是少数几个'免费版'仍然能满足实际工作需求的软件之一，前提是你得为合适的工作选择合适的模式。我不会用它来管理整个团队的免费业务，但对于个人经纪人来说，它可能是一个不错的选择。

OpenRouter 免费模型

OpenRouter 的优势在于它将多个模型聚合到一个提供商之下。他们的文档也解释了某些模型上的 :free 后缀。

在 OpenClaw 中，通常只需设置：

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

免费模型可能会随时间变化，因此请将模型选择视为需要定期重新评估的事情。如果某个免费模型消失，您需要提前配置好备用模型。

Groq

Groq 之所以受欢迎，是因为它速度快，而且通常提供充足的流量供用户进行实验。您的具体流量配额取决于 Groq 在您所在地区和账户级别提供的配额。尽管如此，它仍然值得作为备用方案，因为一旦成功，流量几乎是瞬间到账的。

OpenClaw 内置了 Groq 作为提供程序，它使用 GROQ_API_KEY。

Google Gemini

Gemini 也是一个内置的提供程序，它使用 GEMINI_API_KEY。

谷歌的免费使用量和速率限制取决于产品类型和套餐，因此我不会在类似这样的教程中给出具体的数值。如果您想大致了解情况，可以参考谷歌社区论坛上关于 API 类免费使用每日请求上限的讨论。

Mistral

Mistral 是另一个内置提供商。如果您所在地区有免费套餐，它可以作为不错的通用备选方案。OpenClaw 使用 Mistral MISTRAL_API_KEY 进行身份验证。

Cohere

Cohere 常用于摘要和分类类工作。根据你的路由方式，你可以使用直接提供商或与 OpenAI 兼容的代理。如果你使用的是免费套餐，除非你确定它能满足你的使用需求，否则建议将其作为备用方案而非主要方案。

Moonshot Kimi 和 Kimi Coding

Kimi 通常并非'永久免费'，但通常可以通过促销活动、积分或合作伙伴计划获得。OpenClaw 的文档介绍了如何将 Moonshot 配置为具有 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

DeepSeek 通常被描述为'基本免费'，但这取决于您是在本地运行还是使用托管 API。如果您通过 Ollama 或本地 OpenAI 兼容服务器运行 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 速率限制。

• 添加备用方案，以便 OpenClaw 在服务提供商限速时可以切换模型。
• 对于像长文档摘要这样的高负载工作流程，应降低并发量。
• 如果你使用的是免费套餐，请接受这是正常现象，并据此进行设计。