// dokumentacja openclaw

Ollama w OpenClaw — lokalne modele AI bez chmury

Przeglad

Ollama integruje sie z OpenClaw jako lokalne srodowisko uruchomieniowe modeli LLM. Obsluguje natywne API Ollama (/api/chat) ze streamingiem i wywolywaniem narzedzi (tool calling). Dzieki temu mozesz uruchamiac modele AI na wlasnym komputerze — bez wysylania danych do chmury.

Szybki start

Przez kreator (zalecane)

Najszybsza sciezka konfiguracji:

openclaw onboard

Wybierz Ollama z listy dostawcow. Kreator:

  • Zapyta o URL bazowy Ollama (domyslnie http://127.0.0.1:11434)
  • Zaproponuje opcje "Chmura + Lokalne" lub "Tylko lokalne"
  • Wykryje dostepne modele i zasugeruje domyslne
  • Automatycznie pobierze wybrane modele, jesli nie sa jeszcze dostepne

Tryb nieinteraktywny:

openclaw onboard --non-interactive --auth-choice ollama --accept-risk

Reczna konfiguracja

  1. Zainstaluj Ollama z ollama.com/download
  2. Pobierz wybrane modele: ollama pull gemma4
  3. Dla modeli chmurowych uruchom: ollama signin
  4. Uruchom kreatora: openclaw onboard i wybierz Ollama
  5. Ustaw zmienna: OLLAMA_API_KEY="ollama-local"
  6. Zarzadzaj modelami: openclaw models list i openclaw models set

Automatyczne wykrywanie modeli (zalecane)

Ustaw OLLAMA_API_KEY bez definiowania jawnych wpisow dostawcy, a OpenClaw automatycznie wykryje modele z lokalnej instancji:

  • Odpytuje endpoint /api/tags w poszukiwaniu dostepnych modeli
  • Odczytuje okna kontekstowe i mozliwosci przez /api/show
  • Automatycznie wykrywa modele z obsluga wizji i rozumowania
  • Ustawia wszystkie koszty na $0 (lokalne uruchomienie)

Konfiguracja jawna

Zdefiniuj models.providers.ollama, gdy:

  • Ollama dziala na innym hoscie lub porcie
  • Potrzebujesz niestandardowych okien kontekstowych
  • Chcesz recznie zdefiniowac liste modeli
{
  models: {
    providers: {
      ollama: {
        baseUrl: "http://ollama-host:11434",
        apiKey: "ollama-local",
        api: "ollama",
        models: [
          {
            id: "gpt-oss:20b",
            name: "GPT-OSS 20B",
            contextWindow: 8192,
            maxTokens: 81920
          }
        ]
      }
    }
  }
}

Obslugiwane modele

Modele lokalne (domyslne)

  • gemma4 — model Google Gemma 4, dobry do ogolnych zadan
  • gpt-oss:20b — otwarty model 20 miliardow parametrow
  • llama3.3 — Meta Llama 3.3, wszechstronny model open-source

Modele chmurowe

Wymagaja zalogowania (ollama signin), nie trzeba ich pobierac lokalnie:

  • kimi-k2.5:cloud — Moonshot Kimi K2.5
  • minimax-m2.7:cloud — MiniMax M2.7
  • glm-5.1:cloud — Zhipu GLM 5.1

Modele z rozumowaniem

Automatycznie wykrywane na podstawie nazw (zawierajacych r1, reasoning, think).

Konfiguracja z fallbackami

{
  agents: {
    defaults: {
      model: {
        primary: "ollama/gpt-oss:20b",
        fallbacks: ["ollama/llama3.3"]
      }
    }
  }
}

Wazne ostrzezenie

Nie uzywaj URL-i z /v1 (kompatybilnych z OpenAI) — to psuje wywolywanie narzedzi! Uzywaj natywnego API:

// DOBRZE:
baseUrl: "http://host:11434"

// ZLE (lamie tool calling):
baseUrl: "http://host:11434/v1"

Wyszukiwanie w internecie

Ollama oferuje wbudowanego dostawce web_search (bez klucza API, wymaga zalogowanej instancji Ollama).

Rozwiazywanie problemow

  • Sprawdz, czy Ollama dziala: ollama serve
  • Zweryfikuj dostepnosc API: curl http://localhost:11434/api/tags
  • Pobierz brakujace modele: ollama pull [nazwa-modelu]
  • Jesli modele nie sa wykrywane, upewnij sie, ze OLLAMA_API_KEY="ollama-local" jest ustawiony
Wróc do dokumentacji