安装
一、安装前置须知
1.环境准备
1.
2.
Windows安装需管理员权限；Mac首次运行需在系统安全设置放行应用；安卓开启未知来源安装权限；iOS内测需TestFlight，所有设备务必开启本地网络权限。
2.系统配置要求
| 系统 | 最低系统版本 | 预留磁盘空间 |
|---|---|---|
| Windows | Win10 1903及以上/Win11全系 | ≥500MB |
| macOS | macOS 10.15及以上 | ≥500MB |
| Android | Android8.0及以上 | ≥200MB |
| iOS/iPadOS | iOS14.0+ | ≥200MB |
| Linux | Ubuntu20.04、Debian11及以上 | ≥300MB |
二、分平台安装步骤
（一）Windows客户端
1.
2.
3.
4.
（二）macOS客户端
1.
方式1：图形界面放行（推荐）
1.
2.
方式2：终端快速放行（找不到设置按钮时使用）
1.
2.
3.
M系列芯片Mac如遇扩展权限提醒，同样在隐私与安全性页面开启对应权限。
（三）iOS&iPadOS（内测版）
1.
2.
3.
（四）Android客户端
1.
2.
3.
（五）Linux（Ubuntu/Debian）
1.
2.
3.
4.
三、首次初始化配置
1.
2.
3.
4.
四、常见问题FAQ
Mac端问题
A：使用上方两种放行方式任意一种完成权限放行即可正常启动。
Q2：终端执行命令提示权限不足
A：M芯片机型可重启长按电源键进入恢复模式调整权限；Intel机型确认账号具备管理员权限后重试。
Q3：软件打开闪退
1.
2.
3.
Q4：搜索不到机器人
关闭系统自带防火墙，断开VPN、代理软件，核对设备与机器人在同一个WiFi。
Windows问题
右键以管理员运行，临时关闭杀毒软件后重装。
Q2：搜不到设备
关闭防火墙，确认电脑和机器人共用一台路由器网络。
移动端问题
关闭手机纯净模式，开启对应应用的安装未知应用权限。
Q2：iOS TestFlight安装失败
链接名额用尽可重新申领邀请链接，切换网络重试。
Q3：手机看不到机器人列表
在系统设置内开启软件本地网络权限。
Linux问题
运行
sudo apt -f install自动补齐依赖。Q2：桌面无软件图标
终端输入启动命令直接运行。
通用问题
更换Edge/Chrome浏览器下载，暂停迅雷等下载工具，切换热点重试。
Q2：全平台搜不到机器人
三点自查：同局域网、路由器关闭AP隔离、设备防火墙全部关闭。
修改于 2026-06-02 03:42:17