HolyCrab CLIのよくある問題を解決する

画面の文と一致する項目だけを試してください。エラーを共有するときはAPI Key、非公開リンク、QR、人物名、個人パスを必ず削除します。

インストール

表示原因候補安全な操作
Pythonがない/3.10未満現在のPythonでは起動できない。Python 3.12を入れ、ターミナルを開き直して再インストール。
holycrabが見つからないPATH未読込またはインストール中断。新しいターミナルで holycrab doctor --json を実行します(全OS共通)。まだ見つからない場合は、下記のOS別修復コマンドを使います。
PowerShellでshが見つからないmacOS/Linux用をWindowsで実行した。Windowsインストールガイドを開き、「HolyCrabをインストール」のコマンドをコピーしてPowerShellで実行します。見つからないのはUnixのシェル sh であり、SSHのインストールは不要です。
doctorでファイル不足・変更管理ファイルの破損・欠落・版違い。下記のOS別インストーラーで修復し、holycrab doctor --json を再実行。

holycrabコマンドが見つからない場合

1. 新しいターミナルで確認する

Windowsでは新しいPowerShell、macOS/Linuxでは新しいターミナルを開きます。以下の確認コマンドは3つのOSで共通です。

holycrab doctor --json

2. まだ見つからない場合は再インストールする

holycrabが見つからないと表示される場合に限り、OSに合う公式コマンドを以下から選んで実行します。完了後に holycrab doctor --json を再実行してください。インストールに失敗した場合は、OS別ガイドを確認します。

詳細手順:Windows · macOS / Linux。

Windows PowerShell

irm https://holycrab.ai/cli/install.ps1 | iex

macOS / Linux (Bash / Zsh)

curl -fsSL https://holycrab.ai/cli/install.sh | sh && export PATH="$HOME/.local/bin:$PATH"

アカウントとAgent

表示原因候補安全な操作
API Keyが無効コピー不足、無効化、別アカウント。API Accessで有効なKeyを確認しholycrab setup。
環境変数の上書き警告一時Keyが保存Keyより優先。Keyを共有せずdoctorのOS別指示に従う。
CodexがHolyCrabを見つけないインストール前に起動、または古い接続先。インストーラーを1回再実行し、新しいCodexタスクを開く。

タスクと素材

スマートフォンでは表を左へスワイプできます。

表示意味次の操作
新モデルや下書き設定が拒否されるローカルの版や選択したモデルが非対応の可能性。holycrab --versionとモデル一覧を確認し、必要なら更新して再見積もりします。
対象モデルで素材を使えない必要な審査やファイル情報の処理中、またはモデルの条件に合わない。Seedanceの審査中は同じIDを照会します。KlingやMiniMaxはこの審査を待つ必要はありません。見積もりでファイル情報の処理中と表示された場合も同じIDを照会し、明確な失敗なら理由に従います。
素材が削除中どのモデルでもその素材を使えない。別の既存素材を選びます。待っても利用可能には戻りません。
既存の本番タスクが失敗した失敗タスクは成功した本番として再利用できない。理由と下書きの期限を確認します。変換可能なら新しい見積もりを確認・承認してから、本番を再作成します。
本番動画の見積もりが変わった最新料金が承認済みの金額と異なる。新しい見積もりを確認して承認してから生成します。
下書きを本番動画へ変換できない期限切れやアカウントの利用制限の可能性。元の下書きと関連する本番タスクを照会し、表示された理由に従います。
タスク待機タイムアウトまだ処理中の可能性。Task IDを保持し、同じタスクを再確認。
承認待機タイムアウト本人が最終状態に達していない。Authorization IDを保持し、新規作成しない。
生成・アップロードunknownオンラインで実行済みの可能性。既存記録を先に照会し、同じ操作を繰り返さない。

安全な確認コマンド

課金しない診断コマンドを表示

ローカル状態と既存記録を確認するだけです。

holycrab --version
holycrab doctor --json
holycrab doctor --json --online
holycrab tasks list
holycrab generate attempts list

解決しない場合に伝える情報

  • OS、CLIバージョン、実行コマンド、秘密を消した完全なエラー。
  • Task ID、Asset ID、Group ID、Authorization IDの有無。人物名やリンクは隠す。
  • API Keyは絶対に送らない。エラー確認にKeyは不要です。

うまくいかない場合

  • 同じ安全な修復が2回失敗したら止め、OS・版・秘密を除いたエラーを共有します。
  • 有料・アップロード結果が不明なら、再送で試さず状態確認を待ちます。