トラブルシューティング

よくある問題とその解決方法。

Gatewayの問題

Gatewayが起動しない

ポートの競合, 別のプロセスがポート18789を使用している可能性があります。lsof -i :18789で確認してください。
設定エラー, neotask.jsonのJSONが無効です。Gatewayは起動時に設定を検証し、特定のエラーを報告します。
Gatewayのロック, 以前のインスタンスが古いロックファイルを残した可能性があります。診断ツールがこれを検出して修正できます。
Node.jsのバージョン, NeotaskはNode 22以降が必要です。

Gatewayは起動するがチャンネルが接続されない

認証情報の不足, 各チャンネルには独自の認証（ボットトークン、QRスキャン、APIキー）が必要です。
ネットワークの問題, チャンネルはメッセージングプラットフォームAPIに接続するためにインターネットアクセスが必要です。
レート制限, 一部のプラットフォームは新しい接続をレート制限します。待ってから再試行してください。

デスクトップアプリから接続できない

ポートが違う, デスクトップアプリが正しいGatewayポートに接続していることを確認してください。
認証の不一致, GatewayトークンがDesktopアプリのものと一致している必要があります。
ファイアウォール, GatewayがAndreの別マシン上にある場合、ポートがアクセス可能であることを確認してください。

チャンネルの問題

WhatsAppが接続されない

QRコードの期限切れ, QRコードは約60秒後に期限切れになります。すばやく再スキャンしてください。
マルチデバイスの制限, WhatsAppはリンクされたデバイスを制限します。
セッションの破損, WhatsAppセッションディレクトリを削除して再ペアリングしてください。

TelegramボットがメッセージをReceiveしない

ボットトークンが無効, BotFatherでボットトークンを確認してください。
プライバシーモード, ボットはデフォルトでグループでメンションされた場合のみメッセージを見ます。
Webhookの競合, 別のサービスがメッセージを消費している可能性があります。

Discordボットが応答しない

インテントの不足, Discord Developer PortalでGateway Intentsを有効にしてください。
権限の不足, ボットはターゲットチャンネルで読み取りと送信の権限が必要です。

モデルの問題

認証エラー

キーが設定されていない, プロバイダーのAPIキーが設定されていることを確認してください。
キーの期限切れ, 一部のOAuthトークンは期限切れになります。再認証してください。
レート制限, 複数のキーを持っている場合、キーローテーションが自動的に切り替えます。

レスポンスが遅い

モデルの選択, 大きなモデルは遅くなります。クイックタスクには高速モデルをお試しください。
コンテキストのサイズ, 長い会話は処理を遅くします。/compactをお試しください。
ネットワークのレイテンシ, モデルプロバイダーへの接続を確認してください。

ノードの問題

コンパニオンアプリがGatewayを見つけられない

バインディングモード, 外部デバイスのために、GatewayはLoopbackではなくLANまたはTailnetにバインドされている必要があります。
同じネットワーク, Bonjourディスカバリーには、両方のデバイスが同じネットワーク上にある必要があります。
手動入力, アプリの設定でGatewayのホストとポートを手動で入力してください。

セッションの問題

コンテキストウィンドウを超えた

コンパクト, /compactを使用してコンテキストを要約・リセットしてください。
自動コンパクションを有効にする, 設定でコンパクションしきい値を設定してください。
新しいセッション, /newで新しい状態から始めてください。

診断

組み込みの診断ツールがよくある問題を確認し、多くを自動的に修正できます：

設定の検証
ファイルの権限
チャンネルの接続性
モデルの認証状態
Node.jsの互換性
ネットワーク設定

詳細なエラー情報はGatewayのログを確認してください。/healthエンドポイントはすべてのコンポーネントの機械可読なステータスを提供します。

ヘルプを得る

自動修正のために診断ツールを実行する
詳細なエラーメッセージのためにGatewayのログを確認する
デスクトップアプリのIntercomチャットウィジェットでサポートに連絡する