トラブルシューティング
Neotask の使用中に発生する可能性のある一般的な問題とその解決方法を説明します。
ライセンスとアクティベーション
「Invalid license key」
- キーのフォーマットを確認：
SC-XXXXXXXX-XXXXXXXX-XXXXXXXX-XXXXXXXX - 余分なスペースや欠落した文字がないか確認
- アクティブなインターネット接続があることを確認
- キーを注意深く再入力してみてください
「License revoked」
- ライセンスがサーバーによって取り消されました
- neotask.ai で請求ステータスを確認してください
- エラーだと思われる場合はサポートにお問い合わせください
「License expired」
- サブスクリプションが失効しました
- 請求ポータルからプランを更新してください
- 期限切れ後、アプリは読み取り専用モードに入ります
「Offline grace period expired」
- 72時間以上オフラインでした
- インターネットに接続すると自動再検証されます
- 接続後、アプリは通常の動作を再開します
「Version blocked」
- セキュリティ上の理由でアプリバージョンがブロックされました
- 直ちに最新バージョンに更新してください
- 自動更新プロンプトが表示されるはずです。表示されない場合は、ウェブサイトからダウンロードしてください
Gateway の問題
「Gateway failed to start」
- ポート 18789 が利用可能か確認（他のアプリが使用していないか）
- アプリを再起動してみてください
- ダッシュボードから Gateway の健全性を確認
- macOS の場合、システム環境設定 > プライバシーとセキュリティでアプリに必要な権限があることを確認
「3-strike lockout」
- 3回連続で Gateway が失敗すると、操作がブロックされます
- アプリを再起動してロックアウトカウンターをリセット
- 持続する場合は、基礎的なエラーのログを確認
「Gateway disconnected」
- ローカルランタイムとの接続が失われました
- Gateway パネルで「再接続」をクリック
- 切断が続く場合はアプリを再起動
- ファイアウォールが localhost 接続をブロックしていないか確認
音声の問題
「No audio input detected」
- マイク権限を付与：
- macOS：システム環境設定 > プライバシーとセキュリティ > マイク > Neotask を有効化
- Windows：設定 > プライバシー > マイク > アプリによるアクセスを許可
- マイクがミュートになっていないか確認
- システム設定で正しい入力デバイスが選択されていることを確認
「Wake word not triggering」
- 設定で音声アクティベーションが有効になっていることを確認
- ウェイクモードが「Porcupine」に設定されていることを確認（「Shortcut」や「Off」ではなく）
- ウェイクフレーズ「Hey Neotask」をはっきりと発話
- キーボードショートカット（Cmd+Shift+Space / Ctrl+Shift+Space）を試す
- 他のアプリがマイクを使用していないか確認
「TTS audio choppy or delayed」
- インターネット接続を確認（TTS は ElevenLabs API が必要）
- ElevenLabs がレート制限を受けている可能性があります
- 設定から別の音声を試す
- バックグラウンドのネットワークアクティビティを減らす
「Voice shortcut not working」
- 他のアプリが同じショートカットを使用している可能性があります
- 設定 > アクティベーション > キーボードショートカットでショートカットを変更
- macOS では、システム環境設定 > キーボード > ショートカットで競合がないか確認
接続とネットワーク
「Cannot connect to server」
- インターネット接続を確認
- ブラウザで neotask.ai にアクセスできるか確認
- 企業ファイアウォールの内側にいる場合、HTTPS トラフィックが許可されていることを確認
- VPN を一時的に無効にしてみてください
「API request failed」
- インターネット接続を確認
- ライセンスが有効であることを確認
- BYOK を使用している場合、API キーが有効でクレジットがあることを確認
- ダッシュボードをリフレッシュしてみてください
エージェントとセッション
「Cannot create agent: limit reached」
- エージェント数はどのプランでも制限されていません。カスタムエージェントの作成には有料プランが必要です
- Free プランでこの表示が出た場合は、カスタムエージェントを作成するために有料プランにアップグレードしてください
- 未使用のエージェントを削除してワークスペースを整理
「Agent not responding」
- Gateway の健全性を確認（実行中である必要があります）
- エージェントのモデルがアクセス可能であることを確認（API キーが有効、プロバイダーが利用可能）
- 日次予算を確認 -- 超過した場合、エージェントは UTC 午前0時まで一時停止されます
- セッションのリセットを試す
「Session messages not loading」
- ページ/アプリをリフレッシュ
- Gateway の接続ステータスを確認
- セッションが非常に長い場合、新しいセッションの作成を試す
請求と支払い
「Payment failed」
- カード情報が正しいことを確認
- 銀行に国際取引のブロックがないか確認
- 別の支払い方法を試す
- 問題が続く場合はサポートにお問い合わせください
「Usage allocation exceeded」
- エージェントのトークン消費がサブスクリプションに含まれる割り当てを超えました
- 追加使用量は使用料金で課金されます。詳細はダッシュボードの使用量ページを確認してください。
- BYOK モード（自分の API キーを使用）に切り替えて、トークンコストをプロバイダーに直接ルーティング
- 予期しない超過を防ぐために日次予算制限を設定
「Plan not updated after payment」
- Stripe の webhook にわずかな遅延がある場合があります（通常1分以内）
- ダッシュボードをリフレッシュ
- 5分後もまだ更新されない場合は、支払い確認書を添えてサポートにお問い合わせください
パフォーマンス
「App slow on startup」
- ライセンスの検証と Gateway の起動は起動時に行われます。これは正常です
- システムが最低要件を満たしていることを確認
- 不要なバックグラウンドアプリを閉じてください
「High CPU usage」
- 常時オンのウェイクワード（Porcupine）を使用している場合、最小限の CPU を使用しますが無効化できます
- 使用していない時は音声セッションを一時停止
- アクティビティモニター/タスクマネージャーでスタックした Gateway プロセスがないか確認
「High memory usage」
- 長いチャットセッションはメモリを蓄積します
- 定期的に新しいセッションを作成
- アプリを再起動して蓄積された状態をクリア
ヘルプを入手
- ドキュメント：ここにいます。ナレッジベースをブラウズしてください。
- サポート：neotask.ai/support のサポートページにアクセス
- お問い合わせ：ウェブサイトのお問い合わせフォームを使用
- ステータス：neotask.ai でサービスステータスを確認