一度に 1 つの変数だけを変更します。OcHub が正しく書かなかったのか、ツールが再読み込み していないのか、上流が拒否したのかを先に判断します。
共通の確認順序
- OcHub に表示された完全な状態メッセージを記録します。
- 現在のアプリ、プロバイダー、モデルプロバイダーを確認します。
- 「書き込むファイル」を展開し、パスと重要項目を確認します。
- 対象 CLI を再起動し、最短のリクエストを送ります。
- モデルプロバイダー使用時は OcHub が動作中であることと使用量ログを確認します。
- 最後にモデルマッピング、推論、環境変数を変更します。
保存成功後もツールが変わらない
- 保存だけでなく切り替えまたはツールに追加を実行したか確認。
- アプリのカスタム設定ディレクトリを確認。
- 実行中の CLI を終了。既存プロセスが設定をキャッシュしている場合があります。
- 外部変更の競合や別の管理ツールによる書き込みを確認。
- OpenCode、OpenClaw、Hermes は複数接続の共存、Claude、Claude Desktop、Codex、 Grok Build、Kimi Code は現在の接続を重視します。Cherry Studio はインポートを使い、 独自ウィンドウで確認を求めます。
アドレスには到達するがリクエストが失敗する
「URL をテスト」や「HTTP 遅延テスト」は任意の HTTP 応答を到達可能と判断することがあります。
- キーがそのアドレス用か。
- モデルがそのインターフェースで提供されるか。
- Anthropic、OpenAI Chat、OpenAI Responses のどれが必要か。
- 残高、割り当て、アクセス権があるか。
- デフォルトや例外でモデルが変更されていないか。
- 上流の正確な状態コードとエラー。
モデルプロバイダーへ接続できない
- カードが有効か確認。
- 保存だけでなくアプリへ適用済みか確認。
- プロバイダーエディターの「HTTP 遅延テスト」と「モデルを取得」でローカルゲートウェイと上流の問題を分離。
- 検証済み直接接続へ一時的に戻し、CLI 自体を確認。
MCP がアプリに表示されない
- サーバーカードで対象アプリが有効か。
- トグル変更後にアプリへ同期したか。
- JSON がオブジェクトで、正しい
type、command、urlを持つか。 - stdio コマンドが対象ツールから見える
PATHにあるか。 - 対象アプリと設定ディレクトリが正しいか。
- 同期後にアプリを再起動したか。
スキルのインストール／更新に失敗する
- ネットワークとリポジトリ URL を確認。
owner/repo、owner/repo@branch、GitHub URL を使用。- skills CLI が利用可能か確認。
- ディレクトリ競合時は既存内容を確認し、すぐに上書きしない。
- 一括更新の一部失敗は個別に処理。
セッションまたは使用量が空
- 対応 CLI が実際に書いた履歴だけを読み取ります。
- 設定ディレクトリ、期間、アプリフィルターを確認。
- 更新してスキャン完了を待ちます。
- 使用量のプロバイダー、モデル、状態フィルターをリセット。
- ゲートウェイのレイテンシーを安定して持つのはモデルプロバイダー経由のリクエストだけです。
同期または復元に失敗する
- 保存済み WebDAV / S3 を再テスト。
- Endpoint、Region、Bucket、リモートディレクトリ、プロファイルを確認。
- テスト成功後も保存が必要。
- ローカル安全バックアップを作れない場合、復元は中止されます。
- 複数端末から異なるスナップショットを同時アップロードしない。
解決しない場合
報告に次を含めます。
- OcHub バージョン、OS、インストール方法。
- 対象アプリと接続方法。
- 最短の再現手順。
- 完全なエラーテキスト。
- キー、トークン、個人セッションを除いた設定プレビュー。