Ubuntu + Ollama + OpenClaw 環境構築手順書

前提条件

• Ubuntu 24.04 LTS がインストール済みであること
• sudo 権限を持つユーザーでログインしていること
• OpenClaw がインストール・オンボーディング済みであること（ubuntu2404-setup.md 参照）

Part 1: Ollama のインストール

ステップ 1: インストールスクリプトの実行

curl -fsSL https://ollama.com/install.sh | sh

ステップ 2: systemd サービスの設定

Ollama を systemd サービスとして登録し、OS 起動時に自動起動させます。

ユーザー・グループの作成:

sudo useradd -r -s /bin/false -U -m -d /usr/share/ollama ollama
sudo usermod -a -G ollama $(whoami)

サービスファイルの作成:

sudo tee /etc/systemd/system/ollama.service > /dev/null <<'EOF'
[Unit]
Description=Ollama Service
After=network-online.target

[Service]
ExecStart=/usr/bin/ollama serve
User=ollama
Group=ollama
Restart=always
RestartSec=3
Environment="PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"

[Install]
WantedBy=multi-user.target
EOF

サービスの有効化・起動:

sudo systemctl daemon-reload
sudo systemctl enable ollama
sudo systemctl start ollama

起動確認:

sudo systemctl status ollama

Active: active (running) と表示されれば成功です。

Part 2: Llama-3.2-1B のインストール

ステップ 3: モデルの取得

ollama pull llama3.2:1b

ステップ 4: 動作確認

ollama run llama3.2:1b

プロンプトが表示されたら任意のメッセージを送信して応答を確認します。終了は /bye を入力してください。

インストール済みモデルの一覧確認:

ollama list

Part 3: OpenClaw への設定

ステップ 5: Ollama にサインイン

OpenClaw の Web Search Provider として Ollama を使用するために、サインインが必要です。

ollama signin

ステップ 6: OpenClaw のモデルプロバイダーとして設定

オンボーディングコマンドで Ollama を選択します。

openclaw configure

プロバイダー選択で Ollama を選択し、モードを選びます。

ローカル専用の場合、ベース URL を確認されたら以下を入力します。

http://localhost:11434

注意: /v1 を末尾に付けないでください。OpenAI 互換モードになりツール呼び出しが正常に動作しなくなります。
- 正: http://localhost:11434
- 誤: http://localhost:11434/v1

ステップ 7: Web Search Provider として設定

openclaw configure --section web

プロバイダー選択で Ollama Web Search を選択します。

設定ファイル（~/.openclaw/openclaw.json）に以下が書き込まれます。

{
  "tools": {
    "web": {
      "search": {
        "provider": "ollama"
      }
    }
  }
}

Part 4: 動作確認

ステップ 8: Gateway の再起動

設定を反映させるために Gateway を再起動します。

openclaw gateway restart

ステップ 9: 動作確認

openclaw gateway status   # ポート 18789 でリッスンしていることを確認
openclaw dashboard        # ダッシュボードを開く

ダッシュボードのチャット欄で Web 検索を伴う質問（例:「今日のニュースを教えて」）を送信し、Ollama 経由で応答が返ることを確認します。

トラブルシューティング

Ollama サービスが起動しない

sudo journalctl -u ollama -n 50

モデルが見つからない

ollama list   # インストール済みモデルの確認
ollama pull llama3.2:1b   # 再取得

OpenClaw から Ollama に接続できない

Ollama が localhost:11434 でリッスンしているか確認します。

curl http://localhost:11434

Ollama is running と表示されれば正常です。

Web 検索が機能しない

ollama signin が完了しているか確認します。

ollama whoami

関連ドキュメント

• Ubuntu 24.04 LTS 環境構築手順書
• Onboarding (CLI) 設定手順書
• Web検索プロバイダー設定ガイド
• 公式ドキュメント: Ollama Provider
• Ollama Linux インストールガイド