ガイドへ移動

トラブルシューティング

onemind が期待どおりに動作しない場合は、まず onemind version を実行してインストールを確認してから、以下の該当する項目を参照してください。

onemind が見つかりません

  • macOS/Linux: ~/.local/bin が PATH 上にあることを確認し、新しいターミナルを開きます。
  • インストーラーを再度実行して、バイナリとサービス登録を修復します。

ブラウザの認証が期限切れか拒否されました

Esc キーを押し、もう一度 サインイン を選択し、ブラウザで新しいリクエストを承認します。拒否されたリクエストまたは期限切れのリクエストは再利用できません。

onemind がサーバーにアクセスできない

onemind session status を実行して使用中の API URL を確認します。変更するにはターミナルから onemind server https://your-server を実行します。https:// URL のみ受け付けます。http:// はローカルループバックアドレスのみ許可されます。サーバーを変更すると以前の認証情報が削除されます。新しいサーバーに対して onemind を実行し、サインインを選択してください。

同期でローカルプロジェクトが接続されていないと表示される

onemind sync はアクティブなバインディングが存在しない場合、次のいずれかのメッセージを出力します。

  • "Sync has not started. Detect an AI tool with 'onemind project TOOL'" — onemind project TOOL /path/to/repo を実行してリポジトリを検出し、同期設定で通常 Project にバインドしてから、再度 onemind sync を実行してください。
  • "Sync setup is saved, but local access is blocked" — パスは同期設定に存在しますが、プロセスがディレクトリを読み書きできません。必要なファイルシステム権限を付与してから、onemind sync を再実行してください。
  • "Sync setup is saved, but the local target is unavailable" — バインドされたパスが存在しないか、AI ツールが実行されていません。AI ツールを起動または修復し、必要に応じてパスを復元してから、onemind sync を再実行してください。
  • "Select this device, target, and Project at …" — デバイスまたはターゲットが同期設定で有効化されていません。同期設定を開き、このデバイスとターゲットの同期を有効化してから、onemind sync を再実行してください。

同期が AGENTS.md を拒否する

onemind は、管理対象マーカーの形式が不正であるか、あいまいな場合に停止します。有効なマーカーのペアを復元するか、onemind mind restore pre-onemind --yes で onemind 導入前の agent プロンプトに戻すか、.one-mind/AGENTS.md.backup をライブ命令ファイルへ手動コピーしてください。手編集時は管理対象ブロックの外側の内容をすべて保持します。

初回 Mind 同期を取り消す

初回 Mind 同期後のリカバリは、Matrix の Mind バージョンではなく、onemind が引き継ぐ前の状態——命令ファイル内の以前のローカル agent プロンプト——に戻すことを意味します。

onemind mind backups --path /path/to/destination
onemind mind restore pre-onemind --path /path/to/destination --file AGENTS.md --yes

グローバルなツールホームでは、--path にそのツールのルートを指定します（例: ~/.codex と --file AGENTS.md、または ~/.claude と --file CLAUDE.md）。~/.codex や ~/.claude を直接変更するのは最終手段のリカバリ手順です。必ずバックアップコピーから開始し、管理対象ブロックの外側にあるコンテンツをすべて保持してください。

バックグラウンドサービスが実行されていません

onemind service status を実行します。失敗した場合は、onemind service install を試し、ステータスを再度確認してください。Linux では、ユーザーの systemd セッションとシークレットサービス／キーリングが利用可能であることを確認してください。

安全な認証情報ストレージが利用できない

onemind はプレーンテキストの資格情報にフォールバックしません。オペレーティングシステムの資格情報サービスを開始するかロックを解除してから、CLI を再度開き、再度サインインします。

セキュアストレージにセッションが見つかりません

CLI が "OneMind session not found in secure storage" と報告する場合、保存されている認証情報が削除されたか、まだ書き込まれていません。onemind を実行してサインインを選択し、新しいセッションを作成してください。

OneMind バージョンのダウングレードが拒否されました

onemind sync が "refusing OneMind version regression from vN to vN" で停止する場合、クラウドパッケージに、命令ファイルを現在所有している CLI より古いバージョンの CLI が書き込んだ管理ブロックが含まれています。通常は同期実行後に CLI をダウングレードした場合に発生します。CLI クイックスタート の公式インストーラーを使用して現在のリリースを再インストールし、onemind sync を再実行してください。

提案の失敗

onemind propose は次のいずれかのメッセージで失敗することがあります。

  • "choose an exact Project target in OneMind before proposing" — 現在のディレクトリにアクティブな Project バインディングがありません。onemind project TOOL /path/to/repo を実行し、提案する前に同期設定を完了してください。
  • "proposal is queued locally; exact Project upload is not active" — 提案はローカルに保存されましたが、Project バインディングが完全に有効化されていないためアップロードがブロックされています。同期設定を完了し、onemind sync を実行してキューに入れられた提案をフラッシュしてください。

Matrix パネルの権限リクエストが期限切れと表示される

ツールのリクエストは、時間内に誰も回答しないと期限切れになります。タスクの詳細パネルでリクエストが期限切れまたはキャンセル済みと表示されている場合、ツールはそれを拒否として扱っており、その操作を行わないまま実行が続いている可能性があります。フォローアップを送る前に、実行のステータスと出力を確認してください。まだ許可が必要な場合、ツールは新しいリクエストを発行します。

同期でリカバリ要または確認期限超過と表示される

同期アクティビティで同期の詳細を開き、ステータス下の説明を確認してください。

リカバリ要: 同期を安全に確認できませんでした。宛先デバイスを開き、画面の指示に従ってリカバリ手順を実行してください。デバイスが到達可能でサインイン済みの状態でなければなりません。

ロールバック済み: デバイスがすでに以前のファイルを復元しました。同期が引き続き必要な場合を除き、追加の対応は不要です。

確認期限超過: デバイスが時間内に結果を確認しませんでした。宛先デバイスがオンラインでサインイン済みかつバックグラウンドサービスが実行中であることを確認し、同期の詳細でリカバリ状態を確認してください。

Matrix タスクがデバイスを待ち続けている

ネイティブ AI ツールに割り当てられたタスクは、割り当て先ツールのデバイスが実行を引き受けていない場合、「[デバイス] の引き受けを待っています」と表示されます。デバイスがオフラインと表示されている場合は、タスクを別のデバイスまたはツールに再割り当てして続行してください。再割り当ての手順は Matrix の会話を参照してください。

タスクの会話が上限に達した

コンポーザーに次のいずれかのメッセージが表示された場合、会話を続行できない状態です。

  • ファイルまたはコンテキストの上限（タスクの会話）: 「このタスクの会話はファイルまたはコンテキストの上限に達しました。」現在の下書きからファイルを削除するか、メッセージを短くしてください。以前の記録は保持されます。
  • コンテキストウィンドウ満杯（onemind エージェント）: 「100% では onemind は返信できません。新しいチャットを開始して続けてください。」新しい onemind エージェントチャットを開始して続けてください。

詳細は Matrix の会話と onemind エージェント を参照してください。

Mind が読み取り専用になっている

Mind の編集や送信が無効になっており、パネルに Mind の変更が一時的に読み取り専用だと表示されている場合、チームのアクティブメンバー数がプランのシート上限を超えています。メンバーを上限以下に削除するか、現在のメンバー数をカバーするシートを追加するか、またはプランをアップグレードすると書き込みアクセスが回復します。シートとプランのオプションについては プランと請求 を参照してください。

支払いが確認中のまま表示される

チェックアウト完了後、サーバーが Paddle の確認済み通知を待っている間、製品は確認中の状態を表示します。通常は数秒以内に解決します。数分後も確認中の状態が続く場合は、ページをリロードするか、サインアウトして再度サインインしてください。プランが有効にならない場合は、サポートからサポートにお問い合わせください。請求の詳細は プランと請求を参照してください。