Gateway

Gatewayとは何ですか？

GatewayはNeotaskの中核, , すべてのエージェントセッション、メッセージングチャンネル、ツール実行、デバイス接続を管理する単一の長期実行サービスです。すべてのものがGatewayを通じて流れます。

クライアント（デスクトップアプリ、モバイルアプリ、Webダッシュボード）からの接続を受け入れ、AIアシスタントのライフサイクル全体を管理するWebSocketサーバーです。

アーキテクチャ

コンポーネント

バインディングモード

モード 説明
ループバック デフォルト。localhost（127.0.0.1）からのみアクセス可能
LAN ローカルネットワーク上でアクセス可能。Bonjour/mDNSで自動ディスカバリー
Tailnet MagicDNS付きTailscale VPN経由でアクセス可能
カスタム 特定のアドレスにバインド

認証

方法 説明
トークン WebSocketベアラートークン（UUIDまたはカスタム文字列）
パスワード パスワードベースの認証（bcryptハッシュ）
信頼されたプロキシ 事前認証ヘッダーを持つリバースプロキシ向け
ローカルトラスト ループバック接続は自動承認

設定

GatewayはJSON5形式のneotask.jsonで設定します。主要なセクション：

セクション 制御内容
agents エージェントリスト、デフォルト、ワークスペース
gateway ポート、バインドモード、認証、リロード動作
channels チャンネルごとの設定と認証情報
tools ツールの権限、プロファイル、セキュリティ
plugins プラグインの読み込み、有効化、プラグインごとの設定
models プロバイダー認証、フォールバック、プロバイダー設定
skills スキルディレクトリ、スキルごとの設定
browser ブラウザプロファイル、ポート、ヘッドレスモード
cron スケジューラー設定
session リセットルール、コンパクションしきい値
messages TTS設定、メディアポリシー
memory メモリインデックス設定
security サンドボックス化、エレベーテッドモード、承認

ホットリロード

設定変更は再起動なしで適用できます：

モード 動作
ハイブリッド（デフォルト） 安全な変更はホット適用、その他は再起動
ホット ホット安全な変更のみ適用、その他は無視
再起動 リロードが必要な変更があれば再起動
オフ 自動リロードなし

リモートアクセス

Tailscale（推奨）

Tailscaleは安全なゼロ設定のリモートアクセスを提供します：

SSHトンネル

SSHでGatewayポートを転送：

セキュリティルール

ヘルスモニタリング

ヘルスエンドポイント

/health HTTPエンドポイントが返すもの：

プローブ

ディスカバリー

Bonjour/mDNS

LANにバインドされると、GatewayはマルチキャストDNSで自身を通知します：

ワイドエリアディスカバリー

設定可能なタイムアウトでネットワーク全体のGatewayを検出します。ローカルBonjourとTailscale DNSディスカバリーの両方をサポート。

複数のGateway

同じマシンでプロファイルを使用して複数のGatewayインスタンスを実行できます：

診断

Doctor

組み込みの診断ツールが確認するもの：

許可を与えると多くの問題を自動的に修正できます。

ロギング

Gatewayのログは日次JSONLファイルに書き込まれます：