FAQ

すばやく答えを見つけ、行き詰まりを解消しましょう。

セキュリティとプライバシー

API キーは安全ですか？

API キーはお使いのマシンにのみ保存されます（~/.openclaw/）。サーバーにアップロードされません。クラウドモードでも、ローカルに設定したキーは同期されません。セキュリティ設定でキーを確認できます。

チャットデータはどこに保存されますか？

既定ではチャットはローカルのみです。クラウドアカウントにサインインすると、複数端末向けに暗号化同期できます。クラウド同期は任意でオフにできます。

SPA は個人情報を収集しますか？

SPA は追跡目的で個人情報を収集しません。アプリはローカルで動作します。クラウド機能は登録・サインイン後に有効になり、アカウントとユーザーが同期を選んだデータに必要なものだけを保存します。

クラウドモードで誰かがメッセージを見られますか？

クラウドモードではメッセージは AI プロバイダー（OpenAI、Anthropic など）へ中継されます。会話内容は保存・閲覧せず、課金用の利用量のみ記録します。より厳しいプライバシーには独自 API キーでローカルモードをご利用ください。

SPA とその他の OpenClaw 構成

SPA と OpenClaw の関係は？

OpenClaw はオープンソースの AI エージェントゲートウェイエンジンです。SPA はこれを基盤にし、SPA をインストールすると OpenClaw エンジンも入り、手動の依存関係セットアップは不要です。フル GUI、クラウドサインイン、ワンクリックインストール、自動更新を追加します。

他のホステッド OpenClaw「クラウド」製品との違いは？

多くのホステッド構成はチーム向けにゲートウェイをサーバーで動かします。SPA はゲートウェイをユーザーの PC に置きローカルファーストのデータを保ち、CLI 不要のデスクトップアプリ、キーレス利用・同期のためのクラウドアカウント、Node.js を自分で設定しないワンクリックインストールを提供します。

SPA は無料ですか？

SPA デスクトップアプリは無料でダウンロードして使えます。ローカルモードでは AI プロバイダーに API 利用料を支払い、クラウドモードではクラウドクレジットを購入します。モードはいつでも切り替え可能です。

使い方

言語とテーマを変えるには？

設定で UI 言語（中国語/英語）とテーマ（ライト/ダーク/システム）を切り替えられます。

どのモデルが使えますか？

SPA はほぼすべての OpenAI 互換 API に対応：OpenAI、Anthropic、DeepSeek、Gemini、Groq、Mistral、Qwen、Moonshot、SiliconFlow、OpenRouter など。プロバイダー用のカスタム Base URL を使ってください。

アシスタントの作り方は？

AI アシスタント → 作成へ。名前を付け、モデルを選び、システムプロンプトを書きます。複数のアシスタントを維持し、チャット中に切り替えられます。

ツールとスキルはどう動きますか？

アシスタントを編集 → ツール：組み込みツール（ファイル、検索、コード実行など）を有効にし、マーケットプレイスからスキルをインストールします。アシスタントは必要に応じて有効なツールを呼び出します。

Feishu ボットが返信しません — 確認することは？

1) Feishu で最新アプリバージョンを公開したか（最も多い）。2) イベント用長接続モード。3) im.message.receive_v1 を追加したか。4) im:message と im:message:send_as_bot を付与したか。5) SPA が動作し Gateway が接続されているか。

環境

ネットワークエラーでインストールに失敗する

セットアップは Node.js と OpenClaw エンジンをダウンロードします。ネットワークが不安定な場合、アプリが自動でミラーを試します。設定 → プロキシで HTTP プロキシを指定することもできます。

Node.js を自分で入れる必要はありますか？

いいえ。SPA は独自の Node.js ランタイムを同梱し、システムの Node インストールと競合しません。

データディレクトリはどこですか？

エンジン・ゲートウェイデータ：~/.openclaw/（Windows：ユーザーフォルダ下の .openclaw）。アプリ設定：macOS は ~/Library/Application Support/spaclaw、Windows は %APPDATA%\spaclaw。アプリ本体は通常の Applications 場所にインストールされます。

トラブルシューティング

行き詰まった — 「核」リセットとは？

SPA を完全終了（トレイ含む）。~/.openclaw/ とアプリサポートフォルダを削除（macOS：~/Library/Application Support/spaclaw、Windows：%APPDATA%\spaclaw）。サイトから最新ビルドを再インストール。設定とデータが消去されます。

Gateway が常に切断と表示される

ポート 18789 が空いているか確認し、設定で Gateway を再起動し、デバッグページでログを読んでください。続く場合は上記のクリーン再インストールを試してください。

起動時に白画面

稀です。完全終了して再起動してください。繰り返す場合は ~/.openclaw/ と spaclaw のアプリサポートフォルダを削除し、セットアップウィザードを再実行してください。

完全にアンインストールするには？

アプリをアンインストール（Windows：アプリ、macOS：SPA.app をゴミ箱へ）。その後 ~/.openclaw/ と spaclaw の Application Support フォルダを削除。データは残りません。

macOS：OpenClaw をリセットしてセットアップウィザードを再実行

実行：rm -rf ~/.openclaw と rm -rf ~/Library/Application\ Support/spaclaw。2 行目は「ウィザード完了」フラグを消します。SPA を開き直すとウィザードに入ります。アプリも消す場合は /Applications/SPA.app を削除してください。