OpenClaw WebChat チャンネル

WebChat は WebSocket 接続を通じて OpenClaw Gateway と通信し、3つの主要なオペレーションを使用します： • chat.history — Gateway から会話履歴を取得 • chat.send — ユーザーメッセージを AI アシスタントに送信 • chat.inject — エージェント実行をトリガーせずにアシスタントノートをトランスクリプトに追加し、UI にブロードキャスト 外部サービスや Webhook に依存する他のチャンネルとは異なり、WebChat は Gateway に完全にネイティブです。メッセージがインフラストラクチャの外に出ることはありません。WebSocket 接続は UI クライアントと Gateway プロセスの間で直接行われます。ルーティングは決定的であり、AI からの返信は常に会話を開始した WebChat セッションに返されます。

ループバック（localhost）であっても、すべての WebChat 接続で認証が必須です。これにより、AI アシスタントへの不正アクセスを防ぎます。 OpenClaw は2つの認証モードをサポートします： • token — WebSocket ハンドシェイクで渡す共有シークレットトークン。プログラムからのアクセスやシングルユーザー環境に最適です。 • password — パスワードベースの認証。各ユーザーが個別の資格情報を持つマルチユーザー環境に適しています。 WebChat が接続を受け入れるには、token または password のいずれかを設定する必要があります。openclaw.json の gateway.auth 設定で構成してください。

{
  "gateway": {
    "auth": {
      "mode": "token",
      "token": "a-strong-random-token-here"
    }
  }
}

WebChat は別途 Web サーバーを実行せずにリモート接続をサポートします。以下の2つのアプローチを推奨します： • SSH トンネル — SSH で Gateway ポートを転送します: ssh -L 3000:localhost:3000 user@remote-host。これにより、Gateway がリモートマシンで動作しながらローカルで WebChat にアクセスできます。 • Tailscale — Tailscale のメッシュ VPN でデバイスを接続します。ポート転送やファイアウォール設定なしで、Gateway が Tailscale IP アドレスでアクセス可能になります。 リモート接続の場合、gateway.remote 設定にターゲット WebSocket URL と認証情報を構成します。ネイティブクライアントはネットワーク状態が変化した際に自動的に再接続を処理します。

{
  "gateway": {
    "remote": {
      "url": "wss://your-remote-host:3000",
      "token": "YOUR_REMOTE_TOKEN"
    }
  }
}

WebChat は Gateway が管理するセッションを使用して会話コンテキストを維持します。各 WebChat 接続は、会話履歴と AI コンテキストを保存するセッションに関連付けられます。 セッションは再接続後も永続化されます。WebSocket が切断され再接続した場合、会話は中断したところから続行されます。chat.history オペレーションが再接続時に Gateway から完全な会話を取得します。 セッション設定は openclaw.json の session.* 設定で管理され、ストレージバックエンドやデフォルトセッションキーなどが含まれます。

Gateway に到達できなくなると、WebChat は自動的に読み取り専用モードに移行します。この状態では： • 以前の会話履歴は引き続き表示されます • 新しいメッセージは送信できません • UI に切断状態が表示されます • バックグラウンドで自動再接続が試行されます Gateway がオンラインに復帰すると、WebChat は自動的に再接続し、完全な機能が復元されます。すべての履歴は Gateway から取得されるため、会話履歴からメッセージが失われることはありません。

WebChat は Apple プラットフォーム上でネイティブ SwiftUI アプリケーションとして実装されています： • macOS — キーボードショートカット、システム通知、メニューバー統合を備えたフルデスクトップ体験 • iOS — プッシュ通知とバックグラウンドリフレッシュに対応したモバイル最適化インターフェース ネイティブ実装により、埋め込みブラウザや Electron ラッパーのオーバーヘッドなしで、レスポンシブなプラットフォームネイティブの体験を提供します。テキストレンダリング、スクロール、入力処理はすべてネイティブプラットフォームコンポーネントを使用します。 他のプラットフォーム（Windows、Linux、Android）では、モダンな Web ブラウザの Control UI チャットタブから WebChat にアクセスできます。

WebChat は WebSocket 接続を通じてメッセージ配信を処理し、長い AI 応答に対してチャンキングを設定できます： • textChunkLimit — メッセージチャンクあたりの最大文字数（デフォルト: 2000）。長い応答は自動的に分割されます。 • blockStreaming — 有効にすると、応答が生成される際にブロック単位のチャンクで送信され、リアルタイムのフィードバックを提供します。 メッセージは WebSocket を通じて即座に配信されます。ポーリングや Webhook の遅延はありません。双方向 WebSocket 接続により、送信と受信の両方がリアルタイムで行われます。

{
  "channels": {
    "webchat": {
      "textChunkLimit": 2000,
      "blockStreaming": true
    }
  }
}

WebChat のセキュリティは Gateway 認証レイヤーを基盤としています。安全なデプロイのために以下のベストプラクティスに従ってください： • 常に認証を設定する — 匿名アクセスは許可されていません • TLS 暗号化を使用する — すべてのリモート接続で wss://（WebSocket Secure）を使用してください • バインドアドレスを制限する — ローカルのみのアクセスには gateway.bind: "127.0.0.1" を使用し、リバースプロキシの背後でない限り 0.0.0.0 へのバインドは避けてください • 強力な資格情報を使用する — ランダムなトークンまたは強力なパスワードを生成してください • リバースプロキシ — 本番環境では、TLS 終端を備えたリバースプロキシ（nginx、Caddy）の背後に Gateway を配置してください 同一マシン上でリバースプロキシを使用する場合、適切なクライアント IP 検出のために gateway.trustedProxies を設定してください。