Tutorial
Step-by-step guide to get started with SPA Desktop — from installation to Feishu integration.
Download & install
Download the installer
Go to the download page and pick the build for your OS: Windows (.exe), macOS (.dmg), or Linux (.AppImage).
Run the installer
Windows: double-click the .exe and follow the prompts. macOS: open the .dmg and drag SPA to Applications. Linux: right-click the .AppImage → Properties → Allow executing, then double-click to run.
First launch & auto setup
On first launch, SPA runs a setup wizard that installs the Node.js runtime, OpenClaw engine, and channel plugins. This usually takes 1–3 minutes. If the network is slow, the app will try mirror servers automatically.
Add an AI provider
Open Settings
Click Settings in the left sidebar. Find the AI Providers section — it lists supported providers.
Enable a provider
Open the provider card you want (e.g. OpenAI, Anthropic, DeepSeek), toggle it on, and paste your API key. For custom endpoints (proxies, self-hosted models), expand Base URL.
Start chatting
Go back to Chat, pick a model from the dropdown, and start a conversation. You can switch models anytime.
Use cloud mode
Register & sign in
Click Cloud in the sidebar. Create an account with email or a third-party login, then sign in.
Enable cloud mode
After sign-in, turn on Cloud mode. You won’t need API keys — the model list switches to cloud-available models.
Pick a model & chat
Open Chat, select a cloud model, and start chatting. Usage is billed to your cloud balance. You can check balance on the Cloud page anytime.
Connect Feishu
Create an app
Open the Feishu Developer Console (open.feishu.cn), sign in, and create a custom enterprise app. Fill in name and description.
Add the bot capability
In the app page, add capability → Bot. After adding it, you’ll see Bot in the left menu.
Configure event subscription
Open Events & callbacks. Choose Long connection (WebSocket) — no public server required. Add event im.message.receive_v1.
Permissions & publish
In Permissions, enable im:message and im:message:send_as_bot. Then create a version under Version & release and publish. You must republish after every permission or event change!
Configure in SPA
Copy App ID and App Secret from the app credentials page. In SPA → Chat platforms → Feishu → paste and save.
Bind to an assistant
Open AI Assistants, edit the assistant you want on Feishu. Under channel binding, add feishu and save. Messages to the bot in Feishu will go to that assistant.