ネットワークプロキシ

​

設定

proxy:
  proxyUrl: http://127.0.0.1:3128

OPENCLAW_PROXY_URL=http://127.0.0.1:3128 openclaw gateway run

openclaw config set proxy.proxyUrl http://127.0.0.1:3128
openclaw gateway install --force
openclaw gateway start

​

プライベート CA を使用する HTTPS プロキシエンドポイント

proxy:
  proxyUrl: https://proxy.corp.example:8443
  tls:
    caFile: /etc/openclaw/proxy-ca.pem

openclaw config set proxy.proxyUrl https://proxy.corp.example:8443
openclaw config set proxy.tls.caFile /etc/openclaw/proxy-ca.pem
openclaw gateway run

​

ルーティングの仕組み

OpenClaw プロセス
  fetch、node:http、node:https、WebSocket クライアント  -> 運用者のプロキシ -> 宛先

• http://proxy.example:3128 — プロキシへの平文 TCP。OpenClaw は、HTTPS 宛先用の CONNECT を含む HTTP プロキシリクエストを送信します。
• https://proxy.example:8443 — OpenClaw はプロキシ自体への TLS 接続を開き（プロキシの証明書を検証し）、そのセッション内で HTTP プロキシリクエストを送信します。

​

Gateway ループバックモード

proxy:
  proxyUrl: http://127.0.0.1:3128
  loopbackMode: gateway-only # gateway-only, proxy, or block

​

コンテナ

​

関連するプロキシ用語

• proxy.enabled / proxy.proxyUrl — ランタイムの外向き通信に対する送信フォワードプロキシルーティング。このページで説明しています。
• gateway.auth.mode: "trusted-proxy" — Gateway へのアクセスに対する、受信側の ID 対応リバースプロキシ認証。信頼済みプロキシ認証を参照してください。
• openclaw proxy — 開発およびサポート用のローカルデバッグプロキシ兼キャプチャ検査ツール。openclaw proxyを参照してください。
• tools.web.fetch.useTrustedEnvProxy — 厳格な DNS ピン留めとホスト名ポリシーをデフォルトで維持しながら、運用者が管理する HTTP(S) 環境プロキシによる DNS 解決を web_fetch に許可するオプトイン。Web フェッチを参照してください。
• チャンネルまたはプロバイダー固有のプロキシ設定 — 単一のトランスポートに対する所有者固有の上書き。ランタイム全体の外向き通信を一元管理するには、管理対象ネットワークプロキシを推奨します。

​

プロキシの検証

• local loopback または信頼できるプライベートインターフェースのみにバインドし、OpenClaw のプロセス、ホスト、コンテナ、またはサービスアカウントからのみ到達可能にします。
• 宛先をプロキシ自身で解決し、平文 HTTP と HTTPS の CONNECT トンネルの両方について、DNS 解決後の接続時に IP に基づいてブロックします。
• ループバック、プライベート、リンクローカル、メタデータ、マルチキャスト、予約済み、およびドキュメント用の範囲に対する、宛先ベースのバイパスを拒否します。
• DNS 解決経路を完全に信頼できる場合を除き、ホスト名の許可リストは避けます。
• 宛先、判定、ステータス、理由を記録します。リクエスト本文、認証ヘッダー、Cookie、その他のシークレットは決して記録しないでください。
• ポリシーをバージョン管理下に置き、変更をセキュリティ上重要なものとしてレビューします。

openclaw proxy validate --proxy-url http://127.0.0.1:3128

openclaw proxy validate --proxy-url https://proxy.corp.example:8443 --proxy-ca-file /etc/openclaw/proxy-ca.pem

{
  "ok": true,
  "config": {
    "enabled": true,
    "proxyUrl": "http://127.0.0.1:3128/",
    "source": "override",
    "errors": []
  },
  "checks": [
    { "kind": "allowed", "url": "https://example.com/", "ok": true, "status": 200 },
    { "kind": "apns", "url": "https://api.sandbox.push.apple.com", "ok": true, "status": 403 }
  ]
}

curl -x http://127.0.0.1:3128 https://example.com/
curl -x http://127.0.0.1:3128 http://127.0.0.1/
curl -x http://127.0.0.1:3128 http://169.254.169.254/

​

推奨されるブロック対象の宛先

​

制限

• これは JavaScript の HTTP/WebSocket クライアントを対象とするプロセスレベルの保護であり、OS レベルのネットワークサンドボックスではありません。
• 生の net、tls、http2 ソケット、ネイティブアドオン、および OpenClaw 以外の子プロセスは、プロキシ環境変数を継承して遵守しない限り、Node レベルのルーティングを迂回する場合があります。フォークされた OpenClaw の子 CLI は、マネージドプロキシ URL と proxy.loopbackMode の状態を継承します。
• ユーザーのローカル WebUI とローカルモデルサーバーは、一般的なローカルネットワークのバイパス対象ではありません。必要に応じて、運用者のプロキシポリシーで許可リストに追加してください。例外は、同梱されている Ollama メモリ埋め込みプロバイダーの保護された直接パスで、設定済みの baseUrl に含まれる正確なホストローカル loopback オリジンに限定されます。LAN、tailnet、プライベートネットワーク、および公開 Ollama ホストでは、引き続きマネージドプロキシが使用されます。
• ローカルデバッグプロキシによる直接のアップストリーム転送（プロキシリクエストおよび CONNECT トンネル用）は、マネージドプロキシモードの有効中はデフォルトで無効になります。承認済みのローカル診断にのみ有効化してください。
• OpenClaw は、プロキシポリシーの検査、テスト、または認証を行いません。プロキシポリシーの変更は、セキュリティ上慎重な扱いを要する運用変更として扱ってください。