Tutoriel
Guide pas à pas pour démarrer avec SPA Desktop — de l’installation à l’intégration Feishu.
Télécharger & installer
Télécharger l’installateur
Allez sur la page de téléchargement et choisissez la build pour votre OS : Windows (.exe), macOS (.dmg) ou Linux (.AppImage).
Lancer l’installateur
Windows : double-cliquez sur le .exe et suivez les invites. macOS : ouvrez le .dmg et glissez SPA vers Applications. Linux : clic droit sur l’AppImage → Propriétés → Autoriser l’exécution, puis double-cliquez.
Premier lancement & configuration auto
Au premier lancement, SPA exécute un assistant qui installe Node.js, le moteur OpenClaw et les plugins de canaux — en général 1 à 3 minutes. Sur réseau lent, l’app essaie automatiquement des miroirs.
Ajouter un fournisseur IA
Ouvrir les paramètres
Cliquez sur Paramètres dans la barre latérale. La section Fournisseurs IA liste les fournisseurs pris en charge.
Activer un fournisseur
Ouvrez la carte souhaitée (OpenAI, Anthropic, DeepSeek…), activez-la et collez votre clé API. Pour des points de terminaison personnalisés, développez URL de base.
Commencer à chatter
Retournez dans Chat, choisissez un modèle et démarrez. Vous pouvez changer de modèle à tout moment.
Utiliser le mode cloud
S’inscrire & se connecter
Cliquez sur Cloud dans la barre latérale. Créez un compte par e-mail ou connexion tierce, puis connectez-vous.
Activer le mode cloud
Après connexion, activez le mode cloud. Plus besoin de clés API — la liste des modèles passe aux modèles cloud disponibles.
Choisir un modèle & chatter
Ouvrez Chat, sélectionnez un modèle cloud et conversez. L’usage est facturé sur votre solde cloud, consultable sur la page Cloud.
Connecter Feishu
Créer une app
Ouvrez la console développeur Feishu (open.feishu.cn), connectez-vous et créez une app entreprise personnalisée. Renseignez nom et description.
Ajouter la capacité bot
Sur la page de l’app : ajouter une capacité → Bot. Le menu de gauche affiche ensuite Bot.
Configurer l’abonnement aux événements
Ouvrez Événements & rappels. Choisissez Connexion longue (WebSocket) — pas de serveur public requis. Ajoutez l’événement im.message.receive_v1.
Permissions & publication
Dans Permissions, activez im:message et im:message:send_as_bot. Puis créez une version sous Version & publication et publiez. Republiez après chaque changement de permission ou d’événement !
Configurer dans SPA
Copiez App ID et App Secret depuis les identifiants de l’app. Dans SPA → Plateformes de chat → Feishu → collez et enregistrez.
Lier à un assistant
Ouvrez Assistants IA, modifiez l’assistant utilisé sur Feishu. Sous liaison de canal, ajoutez feishu et enregistrez. Les messages au bot Feishu vont à cet assistant.