有没有最简单的第一次跑通教程？

[lturner73]

swagger 页面打开了，手机 app 也装了，但中间怎么连上的不太明白。.env 里一堆配置，除了填了 key 之外不敢乱改。能不能给个最简路径，先不管 IM 那些高级功能，就想看到手机能被我控制一下。

[HarveySang]

可以，第一次跑通建议先只走最简单的本地链路，不用管 IM、Discord、飞书这些远程入口。

第一步，先启动 backend：

cd server
./start.sh

这个脚本会启动本地 backend，并准备 backend 需要的依赖和数据。

第二步，把 Android app 装到手机上并启动：

cd client
./start.sh

然后手机侧确认这几件事：

• USB debugging / USB 调试已经授权；
• Accessibility Service / 无障碍服务已经开启；
• overlay / 悬浮窗权限已经开启；
• 手机保持连接，不要把 OpenGUI app 杀掉。

第三步，回到 server 目录，先确认 OpenGUI 能看到手机：

pnpm opengui -- devices --json

如果这里能看到设备，再跑最小任务：

pnpm opengui -- do "Observe the current Android screen and summarize what you see" --json

.env 第一次不用全改。真正跑任务时，先保证模型相关的 VLM_API_KEY、VLM_BASE_URL、VLM_MODEL 是可用的就行。

我们后面会把这个「第一次跑通」路径在 README / getting started 里写得更明显一点。