使用教程
从下载安装到接入飞书，一步步教你上手 SPA Desktop。
下载与安装
下载安装包
前往下载页面，根据你的操作系统选择对应版本：Windows (.exe)、macOS (.dmg) 或 Linux (.AppImage)。
运行安装程序
Windows：双击 .exe 文件，按提示完成安装。macOS：打开 .dmg 文件，将 SPA 拖入「应用程序」文件夹。Linux：右键 .AppImage 文件 → 属性 → 勾选「允许执行」，然后双击运行。
首次启动与自动设置
首次打开 SPA 后，应用会自动进入设置向导，依次安装 Node.js 运行环境、OpenClaw 引擎和通道插件。整个过程通常需要 1–3 分钟，全程自动完成。如果遇到网络问题，应用会自动使用国内镜像加速。
添加 AI 服务商
打开设置页面
点击左侧导航栏的「设置」按钮，进入设置页面。找到「AI 服务商」区域，这里列出了所有支持的 AI 服务商。
选择并启用服务商
点击你想使用的服务商卡片（如 OpenAI、Anthropic、DeepSeek 等），打开启用开关。在 API Key 输入框中粘贴你从服务商官网获取的密钥。如果需要使用自定义 API 地址（如中转站、私有部署等），展开 Base URL 填入。
开始对话
配置完成后，返回「对话」页面。在顶部的模型选择框中选择一个模型，就可以开始与 AI 对话了。你可以随时切换不同的模型来对比效果。
使用云端模式
注册并登录云端账号
点击左侧导航栏的「云端」按钮，在云端页面中注册一个账号并登录。支持邮箱注册和第三方登录。
开启云端模式
登录后，在云端页面点击「云端模式」开关将其打开。开启后，你无需配置任何 API Key，对话页面的模型列表会自动切换为云端可用模型。
选择模型并对话
回到「对话」页面，选择一个云端模型即可开始对话。每次对话会消耗你的云端账户余额。你可以随时在云端页面查看余额和使用情况。
接入飞书
在飞书开发者后台创建应用
打开飞书开发者后台（open.feishu.cn），登录后点击「创建企业自建应用」。填写应用名称和描述，创建成功后进入应用详情页面。
添加机器人能力
在应用详情页的左侧菜单中，点击「添加应用能力」→ 选择「机器人」并添加。添加成功后左侧会出现「机器人」菜单项。
配置事件订阅
在左侧菜单找到「事件与回调」。接收方式选择「长连接」（WebSocket 模式），这是最简单的方式，不需要公网服务器。然后在事件列表中添加 im.message.receive_v1 事件。
开通权限并发布
在「权限管理」中搜索并开通 im:message 和 im:message:send_as_bot 权限。然后在「版本管理与发布」中创建版本并发布。注意：每次修改权限或事件后，都必须重新创建版本发布！
在桌面端配置
回到飞书开发者后台的「凭证与基础信息」页面，复制 App ID 和 App Secret。打开 SPA 桌面端 →「聊天平台」→ 点击「飞书」→ 粘贴 App ID 和 App Secret 并保存。
绑定到 AI 助手
进入「AI 助手」页面，编辑你要接入飞书的助手。在「通道绑定」区域添加一条绑定，通道类型选择 feishu，保存即可。现在在飞书中给机器人发消息，AI 助手就会自动回复了。