Ollama - OpenClaw

Ollama は、マシン上でオープンソースモデルを簡単に実行できるようにするローカル LLM ランタイムです。 OpenClaw は Ollama のネイティブ API (/api/chat) と統合し、ストリーミングとツール呼び出しをサポートし、OLLAMA_API_KEY (または認証プロファイル) でオプトインし、明示的な models.providers.ollama エントリを定義しない場合、ツール対応モデルを自動検出できます。

リモート Ollama ユーザー: /v1 OpenAI 互換 URL (http://host:11434/v1) を OpenClaw で使用しないでください。これによりツールの呼び出しが中断され、モデルは生のツール JSON をプレーンテキストとして出力する可能性があります。代わりに、ネイティブの Ollama API URL を使用してください: baseUrl: "http://host:11434" (/v1 は使用できません)。

クイックスタート

Ollama をインストールします: https://ollama.ai
モデルをプルします。

ollama pull gpt-oss:20b
# or
ollama pull llama3.3
# or
ollama pull qwen2.5-coder:32b
# or
ollama pull deepseek-r1:32b

OpenClaw に対して Ollama を有効にします (任意の値が機能します。Ollama には実際のキーは必要ありません)。

# Set environment variable
export OLLAMA_API_KEY="ollama-local"

# Or configure in your config file
openclaw config set models.providers.ollama.apiKey "ollama-local"

Ollama モデルを使用します。

{
  agents: {
    defaults: {
      model: { primary: "ollama/gpt-oss:20b" },
    },
  },
}

モデル検出 (暗黙的なプロバイダー)

OLLAMA_API_KEY (または認証プロファイル) を設定し、OC_I18N_0024__ を定義しない場合、OpenClaw は http://127.0.0.1:11434 にあるローカル Ollama インスタンスからモデルを検出します。- クエリ /api/tags および /api/show

tools 機能をレポートするモデルのみを保持します
モデルが thinking を報告する場合、 reasoning をマークします。
利用可能な場合、model_info["<arch>.context_length"] から contextWindow を読み取ります
maxTokens をコンテキストウィンドウの 10 倍に設定します
すべてのコストを 0 に設定します

これにより、カタログを Ollama の機能に合わせた状態に保ちながら、手動でモデルを入力する必要がなくなります。利用可能なモデルを確認するには:

ollama list
openclaw models list

新しいモデルを追加するには、Ollama を使用してそれをプルするだけです。

ollama pull mistral

新しいモデルは自動的に検出され、使用できるようになります。 models.providers.ollama を明示的に設定した場合、自動検出はスキップされ、モデルを手動で定義する必要があります (以下を参照)。

構成

基本セットアップ (暗黙的な検出)

Ollama を有効にする最も簡単な方法は、環境変数を使用することです。

export OLLAMA_API_KEY="ollama-local"

明示的なセットアップ (手動モデル)

次の場合に明示的な構成を使用します。

Ollama は別のホスト/ポートで実行されます。
特定のコンテキストウィンドウまたはモデルリストを強制したい。
ツールのサポートを報告しないモデルを含めたい。

{
  models: {
    providers: {
      ollama: {
        baseUrl: "http://ollama-host:11434",
        apiKey: "ollama-local",
        api: "ollama",
        models: [
          {
            id: "gpt-oss:20b",
            name: "GPT-OSS 20B",
            reasoning: false,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 8192,
            maxTokens: 8192 * 10
          }
        ]
      }
    }
  }
}

OLLAMA_API_KEY が設定されている場合は、プロバイダーエントリの apiKey を省略でき、OpenClaw が可用性チェックのためにそれを入力します。

カスタムベース URL (明示的な構成)

Ollama が別のホストまたはポートで実行されている場合 (明示的な構成により自動検出が無効になるため、モデルを手動で定義します):

{
models: {
providers: {
ollama: {
apiKey: "ollama-local",
baseUrl: "<http://ollama-host:11434>", // No /v1 - use native Ollama API URL
api: "ollama", // Set explicitly to guarantee native tool-calling behavior
},
},
},
}

URL に /v1 を追加しないでください。 /v1 パスでは OpenAI 互換モードが使用されており、ツールの呼び出しは信頼できません。パス接尾辞のないベース Ollama URL を使用します。

モデルの選択

構成が完了すると、すべての Ollama モデルが使用可能になります。

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

上級者向け

推論モデル

Ollama が /api/show で thinking を報告すると、OpenClaw はモデルを推論可能としてマークします。

ollama pull deepseek-r1:32b

モデルのコスト

Ollama は無料でローカルで実行できるため、すべてのモデルのコストは 0 ドルに設定されます。

ストリーミング構成

OpenClaw の Ollama 統合では、ネイティブ Ollama API (/api/chat) がデフォルトで使用され、ストリーミングとツール呼び出しの同時サポートが完全にサポートされます。特別な構成は必要ありません。

従来の OpenAI 互換モード

OpenAI 互換モードではツール呼び出しは信頼できません。 このモードは、プロキシに OpenAI 形式が必要で、ネイティブツールの呼び出し動作に依存しない場合にのみ使用してください。

代わりに OpenAI 互換エンドポイントを使用する必要がある場合 (たとえば、OpenAI 形式のみをサポートするプロキシの背後で)、明示的に api: "openai-completions" を設定します。

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

このモードでは、ストリーミングとツールの呼び出しを同時にサポートできない場合があります。モデル設定で params: { streaming: false } を使用してストリーミングを無効にする必要がある場合があります。api: "openai-completions" が Ollama で使用される場合、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 は、利用可能な場合は Ollama によって報告されたコンテキストウィンドウを使用します。それ以外の場合は、デフォルトの 8192 が使用されます。明示的なプロバイダー構成で contextWindow および maxTokens をオーバーライドできます。

トラブルシューティング

オラマが検出されませんでした

Ollama が実行中であること、OLLAMA_API_KEY (または認証プロファイル) を設定していること、および明示的な models.providers.ollama エントリを定義していないことを確認してください。

ollama serve

API にアクセスできること:

curl http://localhost:11434/api/tags

利用可能なモデルはありません

OpenClaw は、レポートツールがサポートするモデルのみを自動検出します。お使いのモデルがリストにない場合は、次のいずれかを行ってください。

ツール対応モデルをプルする、または
models.providers.ollama でモデルを明示的に定義します。

モデルを追加するには:

ollama list  # See what's installed
ollama pull gpt-oss:20b  # Pull a tool-capable model
ollama pull llama3.3     # Or another model

接続が拒否されました

Ollama が正しいポートで実行されていることを確認します。

# Check if Ollama is running
ps aux | grep ollama

# Or restart Ollama
ollama serve

​クイックスタート

​モデル検出 (暗黙的なプロバイダー)

​構成

​基本セットアップ (暗黙的な検出)

​明示的なセットアップ (手動モデル)

​カスタムベース URL (明示的な構成)

​モデルの選択

​上級者向け

​推論モデル

​モデルのコスト

​ストリーミング構成

​従来の OpenAI 互換モード

​コンテキストウィンドウ

​トラブルシューティング

​オラマが検出されませんでした

​利用可能なモデルはありません

​接続が拒否されました

​関連項目

クイックスタート

モデル検出 (暗黙的なプロバイダー)

構成

基本セットアップ (暗黙的な検出)

明示的なセットアップ (手動モデル)

カスタムベース URL (明示的な構成)

モデルの選択

上級者向け

推論モデル

モデルのコスト

ストリーミング構成

従来の OpenAI 互換モード

コンテキストウィンドウ

トラブルシューティング

オラマが検出されませんでした

利用可能なモデルはありません

接続が拒否されました

関連項目