GatewayはOpen Clawの中核——すべてのエージェントセッション、メッセージングチャンネル、ツール実行、デバイス接続を管理する単一の長期実行サービスです。すべてのものがGatewayを通じて流れます。
クライアント(デスクトップアプリ、モバイルアプリ、Webダッシュボード)からの接続を受け入れ、AIアシスタントのライフサイクル全体を管理するWebSocketサーバーです。
| モード | 説明 | |------|-------------| | ループバック | デフォルト。localhost(127.0.0.1)からのみアクセス可能 | | LAN | ローカルネットワーク上でアクセス可能。Bonjour/mDNSで自動ディスカバリー | | Tailnet | MagicDNS付きTailscale VPN経由でアクセス可能 | | カスタム | 特定のアドレスにバインド |
| 方法 | 説明 | |--------|-------------| | トークン | WebSocketベアラートークン(UUIDまたはカスタム文字列) | | パスワード | パスワードベースの認証(bcryptハッシュ) | | 信頼されたプロキシ | 事前認証ヘッダーを持つリバースプロキシ向け | | ローカルトラスト | ループバック接続は自動承認 |
GatewayはJSON5形式のopenclaw.jsonで設定します。主要なセクション:
| セクション | 制御内容 |
|---------|----------|
| agents | エージェントリスト、デフォルト、ワークスペース |
| gateway | ポート、バインドモード、認証、リロード動作 |
| channels | チャンネルごとの設定と認証情報 |
| tools | ツールの権限、プロファイル、セキュリティ |
| plugins | プラグインの読み込み、有効化、プラグインごとの設定 |
| models | プロバイダー認証、フォールバック、プロバイダー設定 |
| skills | スキルディレクトリ、スキルごとの設定 |
| browser | ブラウザプロファイル、ポート、ヘッドレスモード |
| cron | スケジューラー設定 |
| session | リセットルール、コンパクションしきい値 |
| messages | TTS設定、メディアポリシー |
| memory | メモリインデックス設定 |
| security | サンドボックス化、エレベーテッドモード、承認 |
設定変更は再起動なしで適用できます:
| モード | 動作 | |------|----------| | ハイブリッド(デフォルト) | 安全な変更はホット適用、その他は再起動 | | ホット | ホット安全な変更のみ適用、その他は無視 | | 再起動 | リロードが必要な変更があれば再起動 | | オフ | 自動リロードなし |
Tailscaleは安全なゼロ設定のリモートアクセスを提供します:
SSHでGatewayポートを転送:
/health HTTPエンドポイントが返すもの:
LANにバインドされると、GatewayはマルチキャストDNSで自身を通知します:
_openclaw-gw._tcp設定可能なタイムアウトでネットワーク全体のGatewayを検出します。ローカルBonjourとTailscale DNSディスカバリーの両方をサポート。
同じマシンでプロファイルを使用して複数のGatewayインスタンスを実行できます:
組み込みの診断ツールが確認するもの:
許可を与えると多くの問題を自動的に修正できます。
Gatewayのログは日次JSONLファイルに書き込まれます: