困ったとき（症状別） — WorkPilot ドキュメント

アプリの中で聞く

ここを読む前に、アプリ内で直接聞くこともできます。画面右上の？（設定⚙の隣）から2つの入口が開きます。

入口	できること
🎓 使い方ツアーを見る	主要な機能を、画面の該当ボタンを光らせながら案内します（7ステップ・約1分。いつでもスキップ可）
❓ 使い方Q&Aスレッドを開く	機能や操作について何でも質問できるスレッドです

Q&Aスレッドは、同梱の使い方ガイド（ナレッジ12文書）に基づいて出典つきで答えます。このガイドはナレッジ WorkPilotの使い方として登録されていて、普通のナレッジと同じように参照・検索できます。アプリの更新に合わせて内容も自動で更新されます。

スレッド名にはバージョンが入ります（例：❓ WorkPilotの使い方 v0.3.340）。 更新しても新しいスレッドは増えません。同じスレッドがそのまま最新版に置き換わり、「この版で新しくなったこと」が届きます。分からないことは、そのまま同じスレッドで質問できます。

片付けても大丈夫です

❓ のスレッドが不要なら、アーカイブしても削除しても構いません。同じバージョンの間は復活しません。次のバージョンに上がったときだけ、新機能の案内役として戻ってきます。すぐ読みたくなったら、右上の？からいつでも開き直せます。

症状から探す

こんなとき	行き先
アプリが開かない／更新できない	アプリが起動しない・更新できない
ターミナルが出てきて戸惑う	ターミナルが分からない
Claude / ChatGPT につながらない	接続テストが通らない
動画が作れない	動画が生成されない
画像・音声が作れない	画像・音声が作れない
AI が指示どおりに動かない	AI の答えがおかしい
勝手に進んでしまう／止まらない	止め方が分からない
反応が遅い	動きが重い
作ったものが見つからない	ファイルが見つからない
消してしまった	消したものを戻したい
チーム共有が同期しない	共有がうまくいかない
スマホからつながらない	スマホ操縦席が開かない

まず試す 3 つ

症状が何であれ、この 3 つで直ることが多いです。

スレッドを作り直す
会話が長すぎて混乱している可能性があります。新しいスレッドで同じことを頼んでみます。
セッションを再起動する
スレッドのメニューから ⟳ セッション再起動。会話は残したまま、AI 側の状態だけ作り直します。
アプリを再起動する
いったん終了して、もう一度開きます。データは消えません。

アプリが起動しない・更新できない

症状	原因	対処
「開発元を確認できません」と出る	macOS の保護機能	アプリを右クリック → 開く → 開く。それでも駄目ならシステム設定 → プライバシーとセキュリティ → このまま開く
「インターネットからダウンロードされました」	初回起動の通常確認	開くを押せば進みます
更新が適用できない	アプリの置き場所	アプリケーションフォルダに入っているか確認。DMG 内やデスクトップからの起動では更新できません
更新が見つからない	チェック待ち	設定 → 情報 → 更新を確認。最新なら最新ですと出ます

ターミナルが分からない

接続のときに開く、文字だけの画面のことです。あなたが打ち込む必要はありません。

状況	やること
選択肢が並んでいる	`↑↓` で選んで `Enter`。マウスでは選べません
文字が延々と流れている	インストール中です。止まるまで待ちます
「コードを貼り付けて」と出た	ブラウザに出ているコードをコピーし、ターミナルで `⌘`+`V` → `Enter`
終わったっぽい	ウィンドウを閉じて OK（`⌘`+`W`）。アプリに戻って接続テスト
間違えて閉じた	問題ありません。アプリのボタンから何度でもやり直せます
ターミナルが見当たらない	他のウィンドウの後ろにあります。Dock のターミナルをクリック

安全について

ここで実行されるのは、各 AI サービスが公式に配っているログイン用のプログラムだけです。あなたの ID とパスワードはブラウザの公式画面で入力され、WorkPilot を経由しません。

接続テストが通らない

上から順に確認してください。ほとんどは 1 か 2 です。

「接続テスト」を押したか
ログインしただけでは接続済みになりません。アプリに戻ってボタンを押す必要があります。
ログインを最後まで終えたか
ブラウザで許可した後、ターミナルに成功表示が出るまでが 1 セットです。途中で閉じた場合はやり直します。
契約しているアカウントでログインしたか
複数アカウントを持っている場合、ブラウザに残っていた別アカウントでログインしていることがあります。ブラウザで一度ログアウトしてから、やり直すと確実です。
契約が有効か
サブスクが切れている・支払いが止まっていると接続できません。各サービスのサイトで契約状況を確認します。
認証方式が合っているか
Claude 欄が APIキーを使うになっていると、ログインしていてもキーを見に行きます。サブスクでログイン（推奨）に切り替えます。
まとめて調べる
設定 → 接続の接続診断（全サービス一括）で、どこで止まっているか一度に確認できます。

出るメッセージ	意味
接続できません。Claudeにログイン済みか確認してください。	Claude のログインが完了していません
ChatGPTのログインが必要です。…	ChatGPT のログインが完了していません
kimi-cli が未インストールです。	Kimi のプログラムがまだ入っていません
Kimiが未ログインです。	入っているがログイン前。サブスク契約も必要です

手順の詳細はサブスクでログインする仕組みにあります。

動画が生成されない

エンジンが Claude か
スレッド右上の AIエンジンを確認します。動画は Claude 経由でしか動きません。
Higgsfield がつながっているか
再認証 / テストを押し、残クレジットの数字が出るかを見ます。文字だけでは不十分です。
クレジットが残っているか
残高が尽きていると生成できません。Higgsfield 側で確認します。
上限に当たっていないか
設定 → 使用量の 1 日・1 か月の生成上限を確認します。
モードが「動画」か
相談モードのままだと、動画は作られず文章で返ってきます。

画像・音声が作れない

症状	確認すること
画像が作れない	OpenAI 画像生成の API キーが保存されているか（🔐 Keychainに保存済み）
ナレーションが作れない	ElevenLabs の API キー。キーの権限（Voices: Read）が足りないと声を読み込めません
BGM が作れない	同じく ElevenLabs のキー。音楽の権限が必要です
録音できない	マイクの許可。システム設定 → プライバシーとセキュリティ → マイク
自動字幕が失敗する	音声認識の許可。同じ場所で WorkPilot を許可します

AI の答えがおかしい

症状	ありがちな原因	対処
前提を無視する	ナレッジを装備していない	送信欄の 📚 ナレッジ・役割・連携から装備する
関係ない話を混ぜる	装備しすぎ・会話が長い	不要な装備を外す。📖 新しい章で続けるで区切る
前に決めたことを忘れる	会話が長くなりすぎた	章で区切る。決定事項はナレッジに書く
毎回品質がぶれる	やり方が固まっていない	うまくいった回をスキルにする
浅い答えしか返らない	指示が抽象的	出力の形（表・箇条書き・字数）まで指定する
途中で終わる	作業が 1 回で終わらない	送信欄の完了までを ON にする

止め方が分からない

止めたいもの	操作
実行中の AI	`Esc`
送ってしまった指示	送信から 5 秒以内に `Esc`（入力欄に戻ります）
おまかせ実行（周回）	止めるボタン、または `Esc`
分身の自動返信	オートモード停止。ただし表示中の回答は最後まで出ます
ループの予定実行	ループの予定どおりやるを OFF
そもそも勝手に進ませたくない	設定 → 安全の承認モードを都度確認に

止めても戻らないもの

Esc は以降の処理を止めますが、すでに実行されたファイルの書き換えや外部への送信は取り消せません。取り返しがつかない操作を含む作業は、承認モードを都度確認にしておくのが安全です。

動きが重い

症状	対処
返事が遅い	会話が長すぎます。📖 新しい章で続けるで区切ります
画面がもたつく	不要なスレッドをアーカイブし、一覧を軽くします
途中で止まる	プランの使用量上限の可能性。設定 → 使用量を確認
作業モードが勝手に止まる	自動継続の上限に達しています。送信すれば再開できます

ファイルが見つからない

ファイル管理で探す
名前やスレッド名で検索できます。種類（動画・画像・音声・資料）でも絞れます。
スレッドから開く
スレッドのメニューの 📂 保存先フォルダを開くで、そのスレッドの保存場所を直接開きます。
保存先フォルダを確認する
設定 → データ → 開く。既定は 書類/WorkPilot です。
Finder で足したのに出てこない
メディアプールの更新を押すと反映されます。

どのフォルダに何が入るかはデータの保存先にまとめています。

消したものを戻したい

消したもの	戻せるか	方法
スレッド（✕ を押した）	戻せます	左メニューのアーカイブから戻す
素材ファイル	戻せます	ゴミ箱へ移動しているだけです。Finder のゴミ箱から復元
スレッドを「削除」した	バックアップからなら戻せます	設定 → データ → バックアップで日付を選んで復元
共有スペースのアイテム	戻せません	全メンバーから消えます。削除前の確認をよく読んでください

復元しても元に戻せます

バックアップから復元するとき、今の状態は自動で退避されます。「戻したけどやっぱり元がよかった」も可能です。実行するとアプリが再起動します。

症状	対処
⚠ 接続できませんと出る	共有フォルダが見つからないか書き込めません。NAS・Dropbox 等の接続を確認
参加コードが弾かれる	コピーし直して貼り直します。前後の空白に注意
フォルダがまだ届いていないと出る	クラウド側でフォルダ共有が済んでいません。リーダーに依頼し、同期後にやり直します
共有したのに相手に資料が見えない	スレッドだけ共有し、ナレッジを共有していない可能性があります
⛔ …共有停止中です	リーダーが停止しています。再開を依頼してください

スマホ操縦席が開かない

Mac の WorkPilot が起動しているか
アプリが閉じていると操縦席は動きません。
同じ Wi-Fi にいるか
家や社内なら、同じネットワークにいれば開けます。
外出先なら Tailscale が入っているか
⚠ Tailscale が見つかりません… と出ている場合、外からは繋がりません。
URL が古くないか
鍵を再発行すると前の URL は無効になります。新しい URL を開き直します。

それでも解決しないとき

設定 → 情報 → ログフォルダを開くでログを取り出せます。不具合を報告するときは、次の 3 つを添えると原因が特定しやすくなります。

何をしようとして、何が起きたか（画面の文言そのまま）
アプリのバージョン（設定 → 情報）
ログフォルダの中身