チュートリアル

SPA Desktop の始め方 — インストールから Feishu 連携までのステップガイド。

ダウンロードとインストール

ダウンロードページで OS 向けビルドを選びます：Windows (.exe)、macOS (.dmg)、Linux (.AppImage)。

Windows：.exe をダブルクリックして案内に従う。macOS：.dmg を開き SPA をアプリケーションにドラッグ。Linux：AppImage を右クリック → プロパティ → 実行を許可してからダブルクリック。

初回起動時、SPA は Node.js ランタイム、OpenClaw エンジン、チャネルプラグインを入れるセットアップウィザードを実行します。通常 1〜3 分です。ネットワークが遅い場合はミラーを自動で試します。

左サイドバーの設定をクリック。AI プロバイダーで対応プロバイダー一覧を確認します。

使いたいカード（OpenAI、Anthropic、DeepSeek など）を開き、オンにして API キーを貼り付けます。カスタムエンドポイント（プロキシ、自前モデル）は Base URL を展開します。

チャットに戻り、ドロップダウンでモデルを選んで会話を始めます。いつでも切り替え可能です。

OpenAI 互換プロバイダー（GPT-4o、Claude、DeepSeek、Gemini、Qwen、Moonshot、SiliconFlow など）に対応。API キーは端末内のみに保存されます。

サイドバーの クラウドをクリック。メールまたはサードパーティでアカウントを作成し、サインインします。

サインイン後、クラウドモードをオンにします。API キーは不要で、モデル一覧がクラウド利用可能なものに切り替わります。

チャットを開き、クラウドモデルを選んで会話します。利用量はクラウド残高に計上されます。残高はクラウドページで確認できます。

クラウドモードは API キー不要ですぐ使えます。費用はクラウド残高から。ローカルモードに戻しても履歴は失いません。

Feishu 開発者コンソール（open.feishu.cn）でサインインし、カスタム企業アプリを作成します。名前と説明を入力します。

アプリページで機能追加 → ボット。追加後、左メニューにボットが表示されます。

イベントとコールバックを開き、長接続（WebSocket）を選びます。公開サーバーは不要です。イベント im.message.receive_v1 を追加します。

権限で im:message と im:message:send_as_bot を有効化。バージョンとリリースでバージョンを作成して公開します。権限やイベントを変えるたびに再公開が必要です。

アプリ資格情報から App ID と App Secret をコピー。SPA → チャットプラットフォーム → Feishu に貼り付けて保存します。

AI アシスタントで Feishu 用のアシスタントを編集し、チャネルバインディングに feishu を追加して保存します。Feishu のボットへのメッセージはそのアシスタントに送られます。

よくあるのは、変更後に Feishu コンソールで新バージョンを公開し忘れることです。