配置

配置¶

基础（隐式发现）显式（手动模型）自定义基础 URL

```bash
export OLLAMA_API_KEY="ollama-local"
```

Tip

如果设置了 OLLAMA_API_KEY，可以在 provider 条目中省略 apiKey；OpenClaw 会在可用性检查时自动填充。

对于托管云配置、非默认主机/端口、强制上下文窗口或完全手动模型列表，请使用显式配置：

{
  models: {
    providers: {
      ollama: {
        baseUrl: "https://ollama.com",
        apiKey: "OLLAMA_API_KEY",
        api: "ollama",
        models: [
          {
            id: "kimi-k2.5:cloud",
            name: "kimi-k2.5:cloud",
            reasoning: false,
            input: ["text", "image"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 128000,
            maxTokens: 8192
          }
        ]
      }
    }
  }
}

此示例使用了非空的手动模型列表，因此会跳过自动发现：

```json5
{
  models: {
    providers: {
      ollama: {
        apiKey: "ollama-local",
        baseUrl: "http://ollama-host:11434", // No /v1 - native Ollama API URL
        api: "ollama", // Explicit: guarantees native tool-calling behavior
        timeoutSeconds: 300, // Optional: longer connect/stream budget for cold local models
        models: [
          {
            id: "qwen3:32b",
            name: "qwen3:32b",
            params: {
              keep_alive: "15m", // Optional: keep the model loaded between turns
            },
          },
        ],
      },
    },
  },
}
```

Warning

不要添加 /v1。该路径会选择 OpenAI 兼容模式，在该模式下工具调用不可靠。

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 cl/openclaw