Как подключить Ollama к OpenClaw

<h1>Как подключить Ollama к OpenClaw</h1> <p class="lead">Если вам надоело платить за облачные модели, которые время от времени уходят в туман, а ваши данные при этом гостят на чужих серверах — добро пожаловать в мир локального LLM. Ollama превращает ваш компьютер в полноценный inference-сервер, а OpenClaw умеет с такими серверами разговаривать. В этой статье без лишней воды разберём, как скачать <code>ollama.exe</code>, запустить <code>ollama serve</code>, подгрузить модель <code>kimi-k2.7-code:cloud</code> и указать OpenClaw, куда стучаться через переменные окружения. Спойлер: это проще, чем кажется.</p> <h2>Что понадобится</h2> <ul> <li>Windows-машина (примеры под <code>.exe</code>, но на Linux/macOS всё то же самое, только пути другие).</li> <li>Свежая Ollama: <a href="https://ollama.com/download">скачать ollama.exe</a>.</li> <li>Установленный OpenClaw, который уже ждёт своей LLM.</li> <li>Модель <code>kimi-k2.7-code:cloud</code> — она специализирована на коде и вполне себе тянет роль локального ассистента.</li> <li>Немного терпения, потому что первый запуск модели может занять время.</li> </ul> <h2>Шаг 1. Установка Ollama</h2> <p>Идём на <a href="https://ollama.com/download">ollama.com/download</a>, качаем установщик и запускаем его. Установка занимает меньше времени, чем варка яйца всмятку. По умолчанию Ollama прячется в системе как фоновый сервис, но для полного контроля мы будем запускать её вручную через терминал. Если хотите вызывать <code>ollama</code> из любой папки, добавьте путь к <code>ollama.exe</code> в переменную <code>PATH</code>. Иначе придётся указывать полный путь каждый раз, что быстро надоедает.</p> <h2>Шаг 2. Запускаем сервер</h2> <p>Ollama работает по клиент-серверной схеме: есть CLI-утилита, которая общается с фоновым процессом по HTTP. Запускаем сервер явно:</p> <p><code>ollama serve</code></p> <p>Если в консоли появилось что-то вроде <code>Listening on 127.0.0.1:11434</code> — поздравляем, у вас теперь свой локальный инференс, без подписок и без пинга в Калифорнию. Не закрывайте это окно: как только процесс остановится, OpenClaw начнёт разговаривать с пустотой, а пустота отвечает довольно однообразно.</p> <h3>Если порт 11434 занят</h3> <p>Бывает, что порт уже держит другой сервис. Тогда запускаем Ollama на альтернативном порту:</p> <p><code>set OLLAMAHOST=0.0.0.0:11435 &amp;&amp; ollama serve</code></p> <p>Главное — потом указать этот же порт в <code>.env</code> для OpenClaw. Логика железная: сервер слушает там, куда вы его посадили.</p> <h2>Шаг 3. Скачиваем модель</h2> <p>Теперь нужно загрузить ту самую модель, которую OpenClaw будет дергать. Открываем новое окно терминала (потому что <code>ollama serve</code> занял первое) и выполняем:</p> <p><code>ollama pull kimi-k2.7-code:cloud</code></p> <p>Название может сбить с толку: <code>:cloud</code> здесь — это тег модели, а не требование облачного подключения. Модель скачивается локально, в кэш Ollama. Время загрузки зависит от скорости интернета и веса модели: от пары минут до одного эпизода любимого сериала. Не прерывайте процесс, иначе Ollama обидится и придётся начинать заново.</p> <p>После загрузки можно быстро проверить, что модель доступна:</p> <p><code>ollama list</code></p> <p>В списке должна появиться строка с <code>kimi-k2.7-code:cloud</code>. Если появилась — можно двигаться дальше. Нет — проверьте, не опечатались ли в имени.</p> <h2>Шаг 4. Проверяем API через /api/tags</h2> <p>Ollama предоставляет простое HTTP API. Самый быстрый способ убедиться, что всё живое — дернуть эндпоинт <code>/api/tags</code>:</p> <p><code>curl http://localhost:11434/api/tags</code></p> <p>В ответ должен прийти JSON со списком локальных моделей, включая нашу <code>kimi-k2.7-code:cloud</code>. Если видите пустой массив — значит, модель ещё не докачалась или имя отличается. Если видите ошибку подключения — значит, <code>ollama serve</code> не запущен. Ollama не умеет читать мысли, она понимает только команды и правильные URL.</p> <h2>Шаг 5. Настраиваем OpenClaw в .env</h2> <p>Теперь самое главное: объясняем OpenClaw, где искать Ollama и какую модель использовать. Открываем файл <code>.env</code> в корне проекта OpenClaw и добавляем две строчки:</p> <pre><code>OLLAMAHOST=http://localhost:11434 <p>OLLAMAMODEL=kimi-k2.7-code:cloud</p></code></pre> <p>Если Ollama крутится не на локальной машине, вместо <code>localhost</code> указываем IP или домен. Если меняли порт — указываем порт. Всё как в детском саду: сказали, где искать — ищет там. Не забудьте сохранить файл и перезапустить OpenClaw, потому что переменные окружения обычно читаются только при старте приложения.</p> <h3>Почему именно такие переменные?</h3> <p>OpenClaw смотрит на <code>OLLAMA<em>HOST</em></code>, чтобы понять, куда слать HTTP-запросы, и на <code>OLLAMAMODEL</code>, чтобы выбрать конкретную модель из списка. Если этих переменных нет, приложение либо упадёт с ошибкой, либо уйдёт в какой-то встроенный дефолт, который вам, скорее всего, не понравится. Лучше прописать явно и спать спокойно.</p> <h2>Шаг 6. Перезапускаем OpenClaw и тестируем</h2> <p>Сохраняем <code>.env</code>, перезапускаем OpenClaw и делаем тестовый запрос. Если в ответ пришёл осмысленный текст — поздравляем, интеграция работает. Если пришла ошибка, не паникуем: смотрим логи и идём по чек-листу.</p> <p>Для уверенности можно сначала проверить работу модели напрямую через Ollama CLI:</p> <p><code>ollama run kimi-k2.7-code:cloud</code></p> <p>Если модель отвечает в терминале, значит проблема не в Ollama, а в настройках OpenClaw. Это сразу сужает круг поиска.</p> <h2>Частые косяки и как их лечить</h2> <ul> <li><strong>Сервер не запущен.</strong> OpenClaw не может достучаться до Ollama. Решение: в отдельном окне выполнить <code>ollama serve</code> и не закрывать его.</li> <li><strong>Неправильное имя модели.</strong> Проверьте через <code>ollama list</code> или <code>/api/tags</code>, как модель называется на самом деле. Опечатка в одну букву — и всё ломается.</li> <li><strong>Порт занят.</strong> Меняем порт при запуске и не забываем прописать его в <code>OLLAMAHOST</code>.</li> <li><strong>Firewall или антивирус.</strong> Если Ollama на другой машине, убедитесь, что порт открыт и сетевое подключение разрешено.</li> <li><strong>.env не подхватился.</strong> Перезапустите OpenClaw полностью. Иногда переменные читаются только при старте, а не при горячем переключении.</li> <li><strong>Модель не влезает в память.</strong> Попробуйте более лёгкую модель или запуск на CPU, если GPU не тянет. Ollama сама разберётся, но скорость будет заметно ниже.</li> </ul> <h2>Несколько советов по эксплуатации</h2> <p>Если вы планируете использовать Ollama постоянно, имеет смысл добавить <code>ollama serve</code> в автозапуск или запускать через планировщик задач. Для разработки удобнее держать сервер в отдельном окне терминала — так видно логи и ошибки в реальном времени.</p> <p>Будьте осторожны с <code>OLLAMAHOST=0.0.0.0</code>: это открывает API для всей локальной сети. На домашнем компьютере это обычно безопасно, но в корпоративной сети лучше ограничивать доступ файрволом, иначе коллеги случайно начнут гонять инференс через ваш ноутбук.</p> <p>Если решите переключиться на другую модель, просто скачайте её через <code>ollama pull</code>, обновите <code>OLLAMAMODEL</code> в <code>.env</code> и перезапустите OpenClaw. Ничего пересобирать не нужно.</p> <h2>Итог</h2> <p>Теперь у вас работает локальная связка: Ollama держит модель <code>kimi-k2.7-code:cloud</code>, OpenClaw обращается к ней по HTTP, а вы полностью контролируете процесс. Никаких токенов, никаких облачных задержек, никакой отправки данных куда-либо. Если что-то сломается — проверяйте три вещи: запущен ли <code>ollama serve</code>, правильный ли порт в <code>OLLAMA<em>HOST</em></code> и корректное ли имя модели в <code>OLLAMAMODEL</code>. Остальное, как правило, работает само.</p>