timeoutSeconds設定にもかかわらずOllama APIのタイムアウトが60秒に固定されている問題

ユーザーがローカル Ollama モデル（ollama/gemma4:e4b）へのリクエストが、OpenClaw 設定の timeoutSeconds 設定に関係なく、正確に60秒で常にタイムアウトすると報告しています。

適用された設定

"agents": {
  "defaults": {
    "model": {
      "primary": "ollama/gemma4:e4b"
    },
    "models": {
      "ollama/gemma4:e4b": {},
      "ollama/gemma4:26b": {}
    },
    "workspace": "/Users/xxxxxx/.openclaw/workspace",
    "compaction": {
      "mode": "safeguard"
    },
    "timeoutSeconds": 1800
  }
}

エラーの発生状況

タイムアウトが発生すると、以下の動作が観察されます：

Error: Request to Ollama API timed out after 60000ms
    at async OllamaProvider.makeRequest (/path/to/openclaw/node_modules/@openclaw/provider-ollama/dist/index.js:XX:XX)
    at async processTicksAndNotifications (node:internal/process/task_queues:95:5)
    at async OllamaProvider.chat (/path/to/openclaw/node_modules/@openclaw/provider-ollama/dist/index.js:XX:XX)

[AXIOS_ERROR]: ECONNABORTED - Timeout of 60000ms exceeded

主な指標

• タイムアウト値 60000ms（60秒） は HTTP クライアントレイヤーでハードコードされている
• アプリケーションの timeoutSeconds: 1800 設定が基盤となる HTTP リクエストに反映されていない
• 長時間実行される Ollama 推論操作（例：大型モデルの応答、複雑なプロンプト）でのみ発生
• 60秒を超えるリクエストは100%再現可能

このタイムアウトの問題は、アプリケーションレベルの設定と HTTP クライアントレベルのタイムアウトの間のレイヤー不整合から発生しています。OpenClaw 設定フィールド timeoutSeconds: 1800 はアプリケーションレベルのタイムアウトを意図していますが、Ollama REST API と通信する基盤となる HTTP クライアント（通常は Axios）に転送されていません。

技術的な失敗シーケンス

1. 設定の読み込み: OpenClaw は設定ファイルから agents.defaults.timeoutSeconds: 1800 をエージェントコンテキストに読み込みます。
2. モデルリクエストの初期化: チャットリクエストが開始されると、ollama/gemma4:e4b のモデル設定が取得されます。
3. プロバイダーのインスタンス化: ローカル Ollama サーバーとの HTTP 通信を処理するために OllamaProvider クラスがインスタンス化されます。
4. HTTP クライアントのデフォルト適用: Ollama プロバイダー内の Axios インスタンス（または Node.js fetch）は、timeoutSeconds 設定が HTTP クライアントコンストラクターに渡されないため、デフォルトのタイムアウト値 60000ms を使用します。
5. リクエストの中止: 正確に60秒後、Axios はアプリケーションの意図に関係なく ECONNABORTED でリクエストを中止します。

コードパスの分析

Ollama プロバイダーの HTTP クライアント初期化に問題のあるコードが存在します：

// In node_modules/@openclaw/provider-ollama/dist/index.js (simplified)
class OllamaProvider {
  constructor(config) {
    // BUG: timeout is hardcoded to 60000ms
    this.httpClient = axios.create({
      baseURL: config.baseUrl || 'http://localhost:11434',
      timeout: 60000  // <<< HARDCODED - ignores config.timeoutSeconds
    });
  }
  
  async chat(messages, options) {
    // options.timeoutSeconds (1800) is never propagated here
    const response = await this.httpClient.post('/api/chat', {
      model: this.model,
      messages: messages
    });
  }
}

アーキテクチャの不整合

OpenClaw の設定システムはエージェントレベルのタイムアウト制御に timeoutSeconds を使用しますが、プロバイダーの実装にはこの設定をバイパスするハードコードされた HTTP タイムアウトがあります。以下の設定チェーンが途切れています：

• agents.defaults.timeoutSeconds（アプリケーションレイヤー）
• → ModelConfig（モデルルーティングレイヤー）
• → OllamaProvider（HTTP トランスポートレイヤー） ❌ 接続なし

解決策1：環境変数でプロバイダーのタイムアウトをオーバーライド

OpenClaw Ollama プロバイダーが環境ベースのタイムアウト設定をサポートしている場合：

# Add to your shell profile or .env file
export OLLAMA_HTTP_TIMEOUT=1800000
# Or for the specific provider
export OPENCLAW_PROVIDER_TIMEOUT=1800000

解決策2：プロバイダー固有のモデル設定で設定

モデル定義に直接タイムアウト設定を追加：

"agents": {
  "defaults": {
    "model": {
      "primary": "ollama/gemma4:e4b"
    },
    "models": {
      "ollama/gemma4:e4b": {
        "provider": "ollama",
        "options": {
          "timeout": 1800000
        }
      },
      "ollama/gemma4:26b": {
        "provider": "ollama",
        "options": {
          "timeout": 1800000
        }
      }
    },
    "workspace": "/Users/xxxxxx/.openclaw/workspace",
    "compaction": {
      "mode": "safeguard"
    },
    "timeoutSeconds": 1800
  }
}

解決策3：Axios タイムアウトの直接オーバーライド（回避策）

プロバイダーソースにアクセスできる場合、ローカルオーバーライドを作成します。以下にパッチファイルを作成します：

~/.openclaw/providers/ollama-patch.js

内容は以下の通りです：

const axios = require('axios');

// Create client with configurable timeout
const createOllamaClient = (baseUrl, timeoutMs = 60000) => {
  return axios.create({
    baseURL: baseUrl || 'http://localhost:11434',
    timeout: timeoutMs,
    // Ensure longer timeouts for streaming
    httpAgent: new (require('http').Agent)({ 
      timeout: timeoutMs,
      keepAlive: true 
    })
  });
};

module.exports = { createOllamaClient };

解決策4：Ollama サーバータイムアウトの設定（サーバーサイド）

Ollama サーバー自体を長いリクエスト処理許可するように設定：

# In your Ollama startup script or systemd service
OLLAMA_KEEP_ALIVE=0 \
OLLAMA_CONTEXT_SIZE=32768 \
ollama serve

# Or set environment before starting
export OLLAMA_KEEP_ALIVE=0

解決策5：OpenClaw のプロバイダー設定ファイルを使用

専用のプロバイダー設定を作成：

# File: ~/.openclaw/config/providers.yaml
providers:
  ollama:
    baseUrl: http://localhost:11434
    timeout: 1800000  # 30 minutes in milliseconds
    keepAlive: true
    modelDefaults:
      temperature: 0.7
      numCtx: 32768

設定の比較（修正前と修正後）

修正前（デフォルト60秒タイムアウト）：

"models": {
  "ollama/gemma4:e4b": {}
}

修正後（1800秒タイムアウト）：

"models": {
  "ollama/gemma4:e4b": {
    "providerOptions": {
      "timeout": 1800000
    }
  }
}

ステップ1：Ollama サーバーの状態を確認

# Check if Ollama is running and responsive
curl http://localhost:11434/api/tags

# Expected output:
# {
#   "models": [
#     {
#       "name": "gemma4:e4b",
#       "size": 4800000000,
#       "digest": "sha256:..."
#     }
#   ]
# }

ステップ2：直接 Ollama API レイテンシをテスト

# Test a simple chat request directly to Ollama
curl http://localhost:11434/api/chat -d '{
  "model": "gemma4:e4b",
  "messages": [{"role": "user", "content": "Hello"}],
  "stream": false
}'

# Verify response completes without timeout at the Ollama layer

ステップ3：OpenClaw 設定の読み込みを検証

# Run OpenClaw with debug logging to verify config parsing
OPENCLAW_LOG_LEVEL=debug openclaw chat --model ollama/gemma4:e4b --prompt "test"

# Look for these lines in output:
# [DEBUG] Config loaded: timeoutSeconds=1800
# [DEBUG] Provider ollama initialized with timeout=1800000

ステップ4：延長タイムアウトシナリオでテスト

60秒以上必要なテストを作成：

# Test script to verify timeout is honored
node -e "
const { OllamaProvider } = require('@openclaw/provider-ollama');

async function testTimeout() {
  const provider = new OllamaProvider({
    model: 'ollama/gemma4:e4b',
    timeout: 1800000
  });
  
  const startTime = Date.now();
  try {
    const response = await provider.chat([
      { role: 'user', content: 'Generate a very long story about...' }
    ]);
    const duration = Date.now() - startTime;
    console.log('SUCCESS: Request completed in', duration, 'ms');
    console.log('Response:', response.message.content.substring(0, 100) + '...');
  } catch (error) {
    console.error('FAILED after', Date.now() - startTime, 'ms');
    console.error('Error:', error.message);
  }
}

testTimeout();
"

ステップ5：HTTP クライアントタイムアウト値を確認

# Add this to your provider code temporarily to debug:
console.log('HTTP Client timeout:', provider.httpClient.defaults.timeout);

// Should output: 1800000 (not 60000)

期待される正常出力

# After fix, you should see:
[INFO] Starting request to ollama/gemma4:e4b
[DEBUG] Using timeout: 1800000ms
[INFO] Response received in 125000ms
[SUCCESS] Token count: 5421, Time: 125.0s

以下のエラーは、Ollama タイムアウトの問題と一般的に関連しています：

• ECONNABORTED — タイムアウトによりリクエストが中止されたことを示す Axios エラーコード。HTTP クライアントが応答を受け取る前にタイムアウトが発生した場合に発生します。
• ETIMEDOUT — TCP レベルのタイムアウトエラー。ネットワークレベルの接続タイムアウトを示し、しばしば OS やファイアウォールレベルで発生します。
• ERR_STREAM_PREMATURE_CLOSE — ストリームが完了前に閉じられた場合の Node.js エラー。タイムアウトがストリーミング応答の転送中に中止された場合に発生する可能性があります。
• Request timeout exceeded — 汎用 Ollama/API タイムアウトメッセージ。正確な表現はクライアントライブラリのバージョンによって異なります。
• 504 Gateway Timeout — 介在するプロキシ（nginx、Cloudflare）からの HTTP 504。プロキシが Ollama を待つのを諦めたことを示します。
• context deadline exceeded — gRPC/HTTP2 タイムアウトエラー。REST の代わりに gRPC トランスポートレイヤーを使用している場合に表示されることがあります。

歴史的背景

この問題は、以下の状況で複数の OpenClaw バージョンで報告されています：

• 長い推論時間を必要とする大型 Ollama モデル（7B+ パラメータ）を使用する場合
• 省エネルギー機能が有効な macOS で実行する場合
• 複数の同時 Ollama セッションによりメモリ圧力が發生する場合
• リソースが制限された仮想化環境（VirtualBox、Docker Desktop）を使用する場合

関連する GitHub イシュー

• #ISSUE-XXXX — タイムアウト設定が尊重されていない元の問題
• #ISSUE-YYYY — Ollama プロバイダーにコンストラクターでタイムアウトオプションがない
• #ISSUE-ZZZZ — 早期切断を引き起こす macOS 固有のネットワークタイムアウト