FAQとトラブルシューティング
最短の診断から始めます。
anyy --version
anyy config
anyy status
anyy doctor
anyy gateway status
シークレット値を出さず、選択Profile、Home、設定健全性、常駐ランタイム、一般的な対処を確認できます。
一般的な質問
Anyyはローカルモデルですか?
いいえ。Anyyは常駐アシスタントランタイムです。設定済みリモートや互換/ローカルのモデルを使えますが、モデルはプロバイダー経路であり、製品そのものではありません。
ローカルだけで動きますか?
正規Profileデータはローカルに保ちますが、設定モデル、Web、MCP、メッセージングは作業に必要なデータを受け取ります。データとプライバシーを参照してください。
Profile、Role、セッションの違いは?
- Profileはデータ、認証、設定、ランタイムを分離します。
- Roleは同Profile内で持続的なアイデンティティを変えます。
- セッションは1つの会話と履歴です。
アカウントや信頼領域を混ぜないなら別Profileを使います。
すべてを覚えていますか?
いいえ。履歴はセッション別に保存し、持続的なユーザー事実と好みはProfileメモリに置きます。利用可能なら以前の会話を検索できますが、一時詳細を自動でメモリに昇格させるべきではありません。
1セッションだけ削除できますか?
session.delete RPCは待機Sessionを削除できますが、v0.1.107のCLI、TUI、Dashboardに汎用ボタン/コマンドはありません。全データを消すProfile削除を代用しないでください。セッション操作を参照してください。
利用料金は?
Anyyを使ってもプロバイダー要求が無料にはなりません。モデル、推論、文脈量、メディア、Web、外部連携によって変わります。料金を確認し、対応する/usageやDashboard使用量を使います。
インストールと更新
anyyが見つからない
新シェルでHomeとPATHを確認します。標準ネイティブ導入はHomeのbin/下に置き、権限が許せばユーザー向け入口を作ります。
エラーを読んでから再導入します。チェックサムを検証し、上限付きのリリース履歴を保ちます。
容量不足と表示される
一時領域とHome両方を空けます。履歴減少を許容する場合だけANYY_INSTALL_COMPACT=1を使います。
更新後もDashboardが古い版
anyy --version、anyy gateway status、Dashboard → Aboutを比較します。手動起動の旧プロセスが残る可能性があります。手動で版を消さず更新の対処に従います。
モデルとプロバイダー
設定でモデルを検証できない
エンドポイント、プロトコル、ID、認証、接続、アカウント制限を確認します。ある宛先で有効な名前が別でも有効とは限らないため、導入済みカタログを使います。
Dashboard Chatで送れない
Modelsでメイン経路を確認します。Test connectionはカタログアクセスと掲載だけで生成テストではありません。保存後、新会話で短い返信を依頼します。フォールバックありなら実生成先を確認してから選択モデルの検証とします。Gateway到達も必要なのでanyy statusも実行します。
チャットは動くのにメディア機能が動かない
画像理解、動画理解、画像生成、文字起こし、TTSは独立経路です。該当経路を設定・テストします。テキストモデルだけでは音声や画像を意味しません。DashboardはPNG/JPEGを画像、他をファイルにするため、音声/動画のアップロードだけでは自動理解しません。メディア理解を参照してください。
推論変更で費用が増えた
effort変更はキャッシュ再利用を無効にする場合があります。予測しやすい文脈とキャッシュが重要なら、大きな変更後は新セッションを開始します。
DashboardとProfile
Dashboard URLが開かない
実行します。
anyy dashboard --status
anyy status
--no-openで再起動し現在URLを表示します。ホスト上はThis machineを使い、LAN URLには到達可能リスナーと信頼する経路が必要です。
DashboardとCLIでセッションが違う
Aboutとanyy configを比較します。--profile、--profile-root、--home、ANYY_HOME、ANYY_DEFAULT_HOME、アクティブ選択を確認します。
Profileを削除できない
既定/現在/固定アクティブ選択でなく停止済みである必要があります。CLIには--forceも必要で、空でないSecretsは明示--purge-secretsなしでは拒否します。
切り替え後にセッションがない
切り替えは移行ではありません。元Profileに戻ってAbout/configでHomeを確認します。
ツール、Skill、MCP
設定したツールが見えない
Tools、セッションのツールセット、任意バックエンド健全性、新セッションが必要かを確認します。認証、バックエンド、範囲が可用性を決めます。
Codemodeや遅延ツールはCodemodeとツール検索も確認します。Profile既定保存は既存Sessionを自動変更しません。
ファイルやコマンドが失敗する
結果、パス/コマンド、OS権限、上限を確認します。有効ツールは直接実行します。質問が出たら回答か実行中断を行います。
Skillが表示されない
現在Profileと画面で有効か確認し、実行します。
anyy skills reload
再読み込み後の次のプロンプトで再試行し警告を確認します。System Skillはユーザー導入と同様には削除/切替できません。管理導入はローカルZIPだけです。Skillを参照してください。
MCP接続済みなのにツールがない
有効状態、現在の提供、公開、Session選択を確認します。directはモデル宣言、codemode/deferredは有効時の対応検出、hiddenは利用不可です。probeでカタログを確認できます。公開設定を参照してください。
@参照が拒否される
認証パス、バイナリ、内部URL、パス脱出、大きすぎる内容、機密Git変更は拒否されます。小さい安全な行範囲か許可公開ソースを使います。
Webの問題
検索に失敗する
Dashboard → Toolsかanyy tools websearchでプロバイダーと認証を検証しテストします。公開URL取得もプライベートネットワークを拒否します。
メッセージング
受信しない
プラットフォームdoctor、有効/接続状態、DM/グループポリシー、ペアリング許可を確認します。一部にはWebhook到達性やイベント購読も必要です。
送信に失敗する
宛先紐付け、健全性、アダプター能力、受領記録を確認します。確認済み記録のないツール成功には、プラットフォーム固有調査が必要な場合があります。
未知のユーザーがアクセスできる
アカウント無効化かポリシー制限、不要許可の取消、露出認証の更新、最近の活動確認を行います。
自動化と背景作業
Cronが実行されない
有効状態、Profileゾーンでの式解析、常駐Gateway、Role/ツールセット存在を確認します。作成会話で即時実行を依頼し、完了履歴と配信を確認します。自動化を参照してください。
予約実行が待っている
背景会話で実行、結果、確認質問を調べます。認証、配信経路、健全性を確認します。
背景作業が消えた
Backgroundと元Profileを確認します。そのセッションの制御を使います。Profile切替は見えるジョブ範囲を変えます。
バックアップと復旧
復元先が存在すると表示される
意図的に存在しない新ディレクトリが必要です。別パスを選び、ライブProfileに重ねません。
復元プロバイダーが認証できない
通常バックアップは管理secrets/と対応mcp/oauth/を省略します。再接続するか、それらを含む保護アーカイブを使います。通常でも設定/Workspaceの直接シークレットは入り得るため、すべて非公開で扱います。バックアップと復元を参照してください。
Doctorがまだ問題を報告する
失敗プローブの対処に従い、機能別status/doctorを実行します。機密内容を確認してからログとdebug bundleを保持します。
まだ解決しない場合
最小限の再現証拠を集めます。
- Aboutの版とcommit。
- 非公開Home部分を秘匿したProfile ID。
- 正確なコマンドと安全なエラー文。
- 関連
status/doctorのプローブ名。 - 失敗直前の変更。
DashboardトークンURL、APIキー、OAuthコード、Channelシークレット、全環境、非公開メッセージ、未確認バックアップは公開しないでください。