Ollama

URL-адресам Ollama для loopback-интерфейса, частной сети, .local и простых имён хостов не требуется настоящий bearer-токен. Для них OpenClaw использует маркер ollama-local.

Для общедоступных удалённых хостов и https://ollama.com требуются настоящие учётные данные: OLLAMA_API_KEY, профиль аутентификации или apiKey провайдера. Для прямого использования размещённого сервиса предпочтителен провайдер ollama-cloud.

Пользовательский провайдер с api: "ollama" подчиняется тем же правилам. Например, провайдер ollama-remote, указывающий на частный хост в локальной сети, может использовать apiKey: "ollama-local"; подагенты разрешают этот маркер через хук провайдера Ollama, а не считают его отсутствующими учётными данными. agents.defaults.memorySearch.provider также может указывать на пользовательский идентификатор провайдера, чтобы для эмбеддингов использовалась эта конечная точка Ollama.

auth-profiles.json хранит учётные данные для идентификатора провайдера; параметры конечной точки (baseUrl, api, модели, заголовки, тайм-ауты) указывайте в models.providers.<id>. Старые плоские файлы, такие как { "ollama-windows": { "apiKey": "ollama-local" } }, не являются форматом среды выполнения; openclaw doctor --fix преобразует их в канонический профиль API-ключа ollama-windows:default с созданием резервной копии. Значение baseUrl в таком устаревшем файле является лишним и должно быть перенесено в конфигурацию провайдера.

Bearer-аутентификация для эмбеддингов памяти Ollama ограничена хостом, для которого она была объявлена:

• Ключ уровня провайдера отправляется только на хост этого провайдера.
• agents.*.memorySearch.remote.apiKey отправляется только на удалённый хост эмбеддингов.
• Значение только из переменной окружения OLLAMA_API_KEY считается соглашением Ollama Cloud и по умолчанию не отправляется на локальные или самостоятельно размещённые хосты.

Ollama на том же компьютере, что и Gateway, обнаруживается автоматически:

ollama serveollama pull gemma4export OLLAMA_API_KEY="ollama-local"openclaw models list --provider ollamaopenclaw models set ollama/gemma4

Не добавляйте блок models.providers.ollama, если модели не требуется задавать вручную.

{  models: {    providers: {      ollama: {        baseUrl: "http://gpu-box.local:11434",        apiKey: "ollama-local",        api: "ollama",        timeoutSeconds: 300,        contextWindow: 32768,        maxTokens: 8192,        models: [          {            id: "qwen3.5:9b",            name: "qwen3.5:9b",            reasoning: true,            input: ["text"],            params: {              num_ctx: 32768,              thinking: false,              keep_alive: "15m",            },          },        ],      },    },  },  agents: {    defaults: {      model: { primary: "ollama/qwen3.5:9b" },    },  },}

contextWindow — бюджет контекста OpenClaw; params.num_ctx отправляется в Ollama. Согласуйте их, если оборудование не может работать с полным заявленным контекстом модели.

Без локального демона, напрямую с размещёнными моделями:

export OLLAMA_API_KEY="your-ollama-api-key"

{  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"],            contextWindow: 128000,            maxTokens: 8192,          },        ],      },    },  },  agents: {    defaults: {      model: { primary: "ollama/kimi-k2.5:cloud" },    },  },}

Если вместо этой структуры нужен отдельный идентификатор провайдера ollama-cloud, см. Ollama Cloud.

Пользовательские идентификаторы провайдеров при запуске нескольких серверов Ollama; у каждого собственные хост, модели, аутентификация и тайм-аут.

{  models: {    providers: {      "ollama-fast": {        baseUrl: "http://mini.local:11434",        apiKey: "ollama-local",        api: "ollama",        contextWindow: 32768,        models: [{ id: "gemma4", name: "gemma4", input: ["text"] }],      },      "ollama-large": {        baseUrl: "http://gpu-box.local:11434",        apiKey: "ollama-local",        api: "ollama",        timeoutSeconds: 420,        contextWindow: 131072,        maxTokens: 16384,        models: [{ id: "qwen3.5:27b", name: "qwen3.5:27b", input: ["text"] }],      },    },  },  agents: {    defaults: {      model: {        primary: "ollama-fast/gemma4",        fallbacks: ["ollama-large/qwen3.5:27b"],      },    },  },}

Перед вызовом Ollama OpenClaw удаляет префикс активного провайдера (используя в качестве запасного варианта обычный префикс ollama/), поэтому ollama-large/qwen3.5:27b передаётся в Ollama как qwen3.5:27b.

Некоторые локальные модели справляются с простыми запросами, но испытывают трудности с полным набором инструментов агента. Ограничьте инструменты и контекст, прежде чем изменять глобальные настройки среды выполнения:

{  agents: {    list: [      {        id: "local",        experimental: {          localModelLean: true,        },        model: { primary: "ollama/gemma4" },      },    ],  },  models: {    providers: {      ollama: {        baseUrl: "http://127.0.0.1:11434",        apiKey: "ollama-local",        api: "ollama",        contextWindow: 32768,        models: [          {            id: "gemma4",            name: "gemma4",            input: ["text"],            params: { num_ctx: 32768 },            compat: { supportsTools: false },          },        ],      },    },  },}

Используйте compat.supportsTools: false, только если модель или сервер регулярно завершаются с ошибкой при обработке схем инструментов: это повышает стабильность за счёт возможностей агента. localModelLean удаляет ресурсоёмкие инструменты браузера, Cron, сообщений, генерации медиа, голоса и PDF из непосредственного набора инструментов агента, если они явно не требуются, и помещает более крупные каталоги за Tool Search. Это не изменяет контекст среды выполнения Ollama или режим мышления. Используйте эту настройку вместе с params.num_ctx и params.thinking: false для небольших моделей мышления в стиле Qwen, которые зацикливаются или расходуют свой бюджет на скрытые рассуждения.

Явно задайте api: "openai-completions" для прокси за /v1/chat/completions:

{  models: {    providers: {      ollama: {        baseUrl: "http://ollama-host:11434/v1",        api: "openai-completions",        injectNumCtxForOpenAICompat: true, // по умолчанию: true        apiKey: "ollama-local",        models: [...]      }    }  }}

Этот режим может не поддерживать потоковую передачу и вызов инструментов одновременно; возможно, потребуется params: { streaming: false } в модели.

По умолчанию OpenClaw внедряет options.num_ctx в этом режиме, чтобы Ollama не переходил без предупреждения к контексту на 4096 токенов. Если ваш прокси отклоняет неизвестные поля options, отключите это:

{  models: {    providers: {      ollama: {        baseUrl: "http://ollama-host:11434/v1",        api: "openai-completions",        injectNumCtxForOpenAICompat: false,        apiKey: "ollama-local",        models: [...]      }    }  }}

Для автоматически обнаруженных моделей OpenClaw использует окно контекста, которое сообщает /api/show, включая увеличенные значения PARAMETER num_ctx из пользовательских Modelfiles; в противном случае используется стандартное окно контекста Ollama в OpenClaw.

contextWindow, contextTokens и maxTokens на уровне провайдера задают значения по умолчанию для каждой модели этого провайдера и могут быть переопределены отдельно для каждой модели. contextWindow — собственный бюджет OpenClaw для запросов и Compaction. Нативные запросы /api/chat оставляют options.num_ctx незаданным, если вы явно не задали params.num_ctx, поэтому Ollama применяет собственное значение модели, OLLAMA_CONTEXT_LENGTH или значение по умолчанию на основе объёма VRAM; недопустимые, нулевые, отрицательные или не являющиеся конечными значения params.num_ctx игнорируются. Если старая конфигурация использовала только contextWindow/maxTokens, чтобы принудительно задавать контекст нативного запроса, выполните openclaw doctor --fix, чтобы скопировать эти значения в params.num_ctx. Адаптер, совместимый с OpenAI, по-прежнему по умолчанию внедряет options.num_ctx из настроенного params.num_ctx или contextWindow; отключите это с помощью injectNumCtxForOpenAICompat: false, если вышестоящий сервис отклоняет options.

Записи нативных моделей также принимают распространённые параметры среды выполнения Ollama в params, которые передаются как нативные /api/chat options: num_keep, seed, num_predict, top_k, top_p, min_p, typical_p, repeat_last_n, temperature, repeat_penalty, presence_penalty, frequency_penalty, stop, num_batch, num_gpu, main_gpu, use_mmap и num_thread. Несколько ключей (format, keep_alive, truncate, shift) передаются как поля запроса верхнего уровня, а не как вложенные options. OpenClaw передаёт только эти ключи запросов Ollama, поэтому параметры, относящиеся только к среде выполнения, например streaming, никогда не отправляются в Ollama. Используйте params.think (или params.thinking), чтобы задать think верхнего уровня; false отключает мышление на уровне API для моделей мышления в стиле Qwen.

{  models: {    providers: {      ollama: {        contextWindow: 32768,        models: [          {            id: "llama3.3",            contextWindow: 131072,            maxTokens: 65536,            params: {              num_ctx: 32768,              temperature: 0.7,              top_p: 0.9,              thinking: false,            },          }        ]      }    }  }}

agents.defaults.models["ollama/<model>"].params.num_ctx для отдельной модели также работает; если заданы оба значения, приоритет имеет явная запись модели провайдера.

OpenClaw передаёт мышление в ожидаемом Ollama формате: think верхнего уровня, а не options.think. Автоматически обнаруженные модели, у которых /api/show сообщает о возможности thinking, предоставляют /think low, /think medium, /think high и /think max; модели без мышления предоставляют только /think off.

openclaw agent --model ollama/gemma4 --thinking offopenclaw agent --model ollama/gemma4 --thinking low

Либо задайте значение по умолчанию для модели:

{  agents: {    defaults: {      models: {        "ollama/gemma4": {          thinking: "low",        },      },    },  },}

Настройки для отдельных моделей params.think/params.thinking могут отключать или принудительно включать рассуждение через API для конкретной модели. OpenClaw сохраняет эту явную конфигурацию, когда в активном запуске действует только неявное значение по умолчанию off; команда среды выполнения, отличная от отключения, например /think medium, по-прежнему переопределяет её. Запрос на рассуждение с истинным значением никогда не отправляется модели, явно помеченной reasoning: false; запрос think: false отправляется всегда.

Модели с именами deepseek-r1, reasoning, reason или think по умолчанию считаются способными к рассуждению — дополнительная конфигурация не требуется:

ollama pull deepseek-r1:32b

Ollama работает локально и бесплатно, поэтому стоимость всех моделей равна 0 как для автоматически обнаруженных, так и для определённых вручную моделей.

Встроенный плагин Ollama регистрирует поставщика эмбеддингов памяти для поиска по памяти. Он использует настроенные базовый URL Ollama и ключ API, вызывает /api/embed и по возможности объединяет несколько фрагментов памяти в один запрос input.

Когда proxy.enabled=true, запросы эмбеддингов к точному локальному loopback-источнику хоста, полученному из настроенного baseUrl, используют защищённый прямой путь OpenClaw вместо управляемого прокси пересылки. Само настроенное имя хоста должно быть localhost или литералом loopback-IP — DNS-имена, которые лишь разрешаются в loopback-адрес, по-прежнему используют путь через управляемый прокси. Хосты Ollama в LAN, tailnet, частной или публичной сети всегда используют путь через управляемый прокси, а перенаправления на другой хост или порт не наследуют доверие. proxy.loopbackMode: "proxy" всё равно направляет loopback-трафик через прокси; proxy.loopbackMode: "block" запрещает его до подключения — см. Управляемый прокси.

Эмбеддинги во время запроса используют префиксы поиска для моделей, которые их требуют или рекомендуют: nomic-embed-text, qwen3-embedding и mxbai-embed-large. Пакеты документов остаются без изменений, поэтому существующим индексам не требуется миграция формата.

{  agents: {    defaults: {      memorySearch: {        provider: "ollama",        remote: {          // Значение по умолчанию для Ollama. Увеличьте на более мощных хостах, если переиндексация выполняется слишком медленно.          nonBatchConcurrency: 1,        },      },    },  },}

Для удалённого хоста эмбеддингов ограничьте область действия аутентификации этим хостом:

{  agents: {    defaults: {      memorySearch: {        provider: "ollama",        model: "nomic-embed-text",        remote: {          baseUrl: "http://gpu-box.local:11434",          apiKey: "ollama-local",          nonBatchConcurrency: 2,        },      },    },  },}

По умолчанию Ollama использует нативный API (/api/chat), который одновременно поддерживает потоковую передачу и вызов инструментов — специальная конфигурация не требуется.

Для нативных запросов управление рассуждением передаётся напрямую: /think off и openclaw agent --thinking off отправляют верхнеуровневый think: false, если явно не настроен params.think/params.thinking; /think low|medium|high отправляют соответствующую строку уровня усилий; /think max сопоставляется с максимальным уровнем усилий Ollama — think: "high".

В WSL2 с NVIDIA/CUDA официальный установщик Ollama для Linux создаёт модуль systemd ollama.service с Restart=always. Если эта служба запускается автоматически и загружает модель с поддержкой GPU при загрузке WSL2, Ollama может закрепить память хоста во время загрузки; механизм освобождения памяти Hyper-V не всегда может освободить эти страницы, поэтому Windows может завершить работу виртуальной машины WSL2, systemd перезапустит Ollama, и цикл повторится.

Признаки: повторные перезагрузки или завершения работы WSL2, высокая загрузка CPU процессом app.slice или ollama.service сразу после запуска WSL2, а также SIGTERM от systemd, а не от механизма Linux OOM killer.

OpenClaw записывает предупреждение при запуске, когда обнаруживает WSL2, включённый ollama.service с Restart=always и видимые маркеры CUDA.

Способ устранения:

sudo systemctl disable ollama

На стороне Windows добавьте следующую настройку в %USERPROFILE%\.wslconfig, затем выполните wsl --shutdown:

[experimental]autoMemoryReclaim=disabled

Либо сократите время keep-alive или запускайте Ollama вручную только при необходимости:

export OLLAMA_KEEP_ALIVE=5mollama serve

См. ollama/ollama#11317.

Убедитесь, что Ollama запущен, задан OLLAMA_API_KEY (или профиль аутентификации), а models.providers.ollama не определён явно:

ollama servecurl http://localhost:11434/api/tags

Скачайте модель локально или явно определите её в models.providers.ollama:

ollama list  # Просмотреть установленные моделиollama pull gemma4ollama pull gpt-oss:20bollama pull llama3.3     # Или другую модель

Выполните проверку на той же машине и в той же среде выполнения, где работает Gateway:

openclaw gateway status --deepcurl http://ollama-host:11434/api/tags

Распространённые причины:

• baseUrl указывает на localhost, но Gateway работает в Docker или на другом хосте.
• URL использует /v1, выбирая OpenAI-совместимое поведение вместо нативного Ollama.
• Для удалённого хоста необходимо изменить настройки межсетевого экрана или привязки к LAN.
• Модель находится в демоне на вашем ноутбуке, но отсутствует на удалённом хосте.

Обычно поставщик работает в OpenAI-совместимом режиме или модель не может обрабатывать схемы инструментов. Предпочтительно использовать нативный режим:

{  models: {    providers: {      ollama: {        baseUrl: "http://ollama-host:11434",        api: "ollama",      },    },  },}

Если небольшая локальная модель по-прежнему не справляется со схемами инструментов, задайте compat.supportsTools: false в записи этой модели и повторите проверку.

Ответы размещённых моделей Kimi/GLM, представляющие собой длинные последовательности нелингвистических символов, считаются неудачным вызовом поставщика, а не успешным ответом, поэтому вместо сохранения повреждённого текста в сеансе запускается обычная обработка повторной попытки, резервного варианта или ошибки.

Если проблема повторится, сохраните имя модели, текущий файл сеанса и сведения о том, использовал ли запуск Cloud + Local или Cloud only, затем попробуйте новый сеанс и резервную модель:

openclaw infer model run --model ollama/kimi-k2.5:cloud --prompt "Ответь точно: ok" --jsonopenclaw models set ollama/gemma4

Первичная загрузка крупных локальных моделей может занимать много времени. Ограничьте область действия тайм-аута поставщиком Ollama и при необходимости сохраняйте модель загруженной между обращениями:

{  models: {    providers: {      ollama: {        timeoutSeconds: 300,        models: [          {            id: "gemma4:26b",            name: "gemma4:26b",            params: { keep_alive: "15m" },          },        ],      },    },  },}

Если сам хост медленно принимает подключения, timeoutSeconds также увеличивает защищённый тайм-аут подключения для этого поставщика.

Многие модели заявляют размер контекста, с которым ваше оборудование не может комфортно работать. Нативный Ollama использует собственное значение среды выполнения по умолчанию, если не задан params.num_ctx. Ограничьте и бюджет OpenClaw, и контекст запроса Ollama, чтобы обеспечить предсказуемую задержку до первого токена:

{  models: {    providers: {      ollama: {        contextWindow: 32768,        maxTokens: 8192,        models: [          {            id: "qwen3.5:9b",            name: "qwen3.5:9b",            params: { num_ctx: 32768, thinking: false },          },        ],      },    },  },}

Уменьшите contextWindow, если OpenClaw отправляет слишком большой промпт. Уменьшите params.num_ctx, если контекст среды выполнения Ollama слишком велик для этой машины. Уменьшите maxTokens, если генерация выполняется слишком долго.