OllamaでOpenClawを使う

Ollamaは、ドキュメントの中で最も手軽にローカルモデルを使える方法ですが、そのページは歓迎ではなく警告から始まります。OpenClawはOllamaのネイティブAPIと通信するため、OpenAI互換のURLを指定するとツール呼び出しが壊れるのです。サポートされるモードは3つで、サインイン済みのホストを通じたクラウドとローカルの併用、Ollama自身のサービスを使うクラウドのみ、そしてローカルのみです。以下では、オンボーディングが何を検出し、何を勝手に想定しないのか、ホストの種類ごとの認証ルール、トラブルシューティングのリスト、そしてモデルが無料だからといってなくなるわけではない、小さなモデルに関するルールを説明します。

/v1のOpenAI互換URL（http://host:11434/v1）は使わないでください。ツール呼び出しが壊れ、モデルが生のツール呼び出しJSONをプレーンテキストとして出力することがあります。

セットアップ

• オンボーディング：Ollamaを選び、モードを選択します。新規のガイド付きセットアップでは、OpenClawはデフォルトまたは設定済みのホストを確認します。自動検出の対象になるのは、すでにメモリに読み込まれていて、ツール対応と16K以上のコンテキストが確認されたモデルだけです。インストール済みでもアイドル状態のモデルは候補にならず、ルートは保存前に実際の補完が成功する必要があり、検出処理が何かをpullしたり読み込んだりすることは決してありません。
• クラウドのみではAPIキーの入力を求められ、ホスト型のデフォルトが提案されます。クラウドとローカルの併用とローカルのみでは、ベースURLの入力を求められ、インストール済みのモデルが調べられます。ツール対応のモデルが見つからない場合、セットアップは推奨モデルをpullしてよいか許可を求めることがあります。埋め込み専用として公開されているモデルは、チャットのデフォルトにはできません。
• 手動の場合：Ollamaをインストールし、モデルをpullし、ハイブリッドのクラウドアクセスには同じホストでサインインし、認証情報を設定します（ローカルまたはLANのホストなら任意の値、Ollamaのサービスなら本物のキー）。その後、モデル参照をollama、スラッシュ、モデル名の形式で設定します。

認証ルール

ループバック、プライベートネットワーク、.local、ホスト名のみのホストには本物のbearerトークンは不要で、OpenClawはそれらにローカル用のマーカーを使います。パブリックなリモートホストとOllamaのサービスには本物の認証情報が必要です。ホスト型を直接使う場合は、クラウドのルーティングをローカルのプロバイダーと分けておけるよう、専用のクラウドプロバイダーIDを使うことがドキュメントで推奨されています。環境変数のキーだけがある場合はクラウド用の慣例として扱われ、デフォルトではローカルホストに送信されません。また、メモリの埋め込みに使うbearer認証は、それが宣言されたホストに限定されます。

トラブルシューティング

• WSL2のクラッシュループ：公式のLinuxインストーラーは、restart alwaysのサービスを作成します。CUDA環境では、起動中にモデルを読み込んでホストのメモリを固定し、VMがWindowsに強制終了され、延々と再起動し続けることがあります。サービスを無効にするか、WSLの設定でメモリの自動回収をオフにするか、短いkeep-aliveでOllamaを手動で実行してください。
• 検出されない：Ollamaが起動していて、エージェントのモデルスコープに含まれていることを確認します。localhostでの暗黙の検出にはキー変数か認証プロファイルが必要で、手動のモデルリストが空でなければ、検出自体がスキップされます。
• モデルがない：pullするか、明示的に定義します。Connection refused：プロセスを確認して再起動します。ツールのJSONがテキストとして表示される：ページ冒頭で触れた、OpenAI互換URLの間違いです。

OpenClawで使える無料モデルの記事ではOllamaをLM Studio、llama.cppなどのバックエンドと並べて紹介しており、WSL2のセットアップはWindowsへのOpenClawのインストールから始まります。

今も当てはまるルール

モデルのFAQは、Ollamaのクイックスタートとひと続きでこう述べています。小さなモデルや強く量子化されたモデルはプロンプトインジェクションに弱いので、ツールにアクセスできるボットには大きなモデルを使うこと、それでも小さなモデルを使う場合は、サンドボックスと厳格なツールの許可リストを有効にすること。攻撃の仕組みはOpenClawとプロンプトインジェクションで、封じ込めの方法はOpenClawのサンドボックスの解説で説明しています。

Dialiでは

DialiではOllamaをインストールする必要はありません。モデルはマネージドカタログに含まれ、プランに含まれるクレジットで支払われます。アシスタントについてはDialiのマネージドOpenClawホスティングを、カタログがカバーする範囲についてはOpenClawのモデルとプロバイダーをご覧ください。

• ネイティブAPIを使い、OpenAI互換URLは決して使いません。
• 検出されるのは読み込み済みのモデルだけです。セットアップは確認なしに何もpullしません。
• ローカルホストにはマーカー、リモートホストにはキー、小さなモデルにはサンドボックスが必要です。