执行环境与权限
工作流的稳定性很大程度取决于“它跑在什么环境里”。开始搭建前，请先确认任务要在哪类环境运行，以及这个环境是否具备必要权限。
很多 RPA 失败不是节点写错，而是环境没准备好：浏览器没连上、登录态失效、桌面权限没开、机器休眠或外部系统访问受限。
你要选哪类执行环境
Section titled “你要选哪类执行环境”| 你想做的事 | 推荐环境 | 为什么 |
|---|---|---|
| 自动操作公开网页 | 内置浏览器 | 启动快、调试方便，第一次推荐 |
| 操作公司后台、需要稳定的浏览器 | 云浏览器 | 浏览器跑在云端，登录态可保留，不被本机干扰 |
| 操作手机 App | 云手机 | 不依赖你本机插着真机，便于巡检和测试 |
| 操作本地客户端、桌面软件 | 本地桌面 | 必须在你或共用机器上执行，需要桌面权限 |
| 仅调用 API / 处理数据 | 不涉及环境 | 用 HTTP / 数据节点即可，无需浏览器、手机或桌面 |
第一次练习强烈建议从“内置浏览器”开始。 它最容易看到效果，也最容易调试。
特点：
- 客户端自带，启动快，不依赖你本机已安装的 Chrome。
- 适合做公开网页操作、读取页面信息、简单填表。
- 调试时可以直接看到操作过程。
适用：
- 第一次练习浏览器 RPA。
- 操作不需要长期登录态的网页。
- 临时抓取、临时填表。
不适用：
- 需要保留长期登录态的后台（关掉客户端登录态可能不持久）。
- 多人轮流使用同一登录账号的场景。
特点：
- 浏览器跑在云端，不挂在你本机。
- 登录态可以稳定保存，不容易被本机重启 / 切换网络打断。
- 多个工作流可以共用一个云浏览器实例。
适用：
- 公司业务后台、电商平台、数据后台。
- 需要在团队内复用浏览器登录态。
- 需要 24×7 跑的定时巡检 / 抓取。
注意：
- 第一次使用前，要在云浏览器里完成一次登录（按对方平台的登录流程）。
- 触发风控的网站，要评估频率和登录次数，避免频繁切换 IP。
特点：
- 远程一台 Android（或对应平台）真机，由 MagicAI 控制。
- 不依赖你本机插数据线。
- 可作为 App 巡检 / 自动化测试的执行环境。
适用：
- 移动端 App 自动化（点击、滑动、读取界面）。
- 多机型并行任务。
不适用：
- 强依赖本机环境的特殊任务（例如硬件传感器）。
特点：
- 工作流直接控制你（或共用电脑）上的桌面应用。
- 可以操作本地客户端、Office、专有桌面软件。
- 同一时刻一台机器只能跑一个桌面 RPA，避免互相抢鼠标键盘。
适用：
- 本地办公软件、专有客户端。
- 必须在内网机器上执行的流程。
不适用：
- 你正常工作的电脑（本地桌面 RPA 在跑时，鼠标键盘会被占用）。
不同环境需要的权限
Section titled “不同环境需要的权限”macOS（仅在用桌面 RPA / 截图 / 录制时需要）
Section titled “macOS（仅在用桌面 RPA / 截图 / 录制时需要）”打开 系统设置 → 隐私与安全性，给 MagicAI 勾选：
- 辅助功能：用于点击、键盘控制、桌面 RPA。
- 屏幕录制：用于截图、OCR、元素识别。
- 输入监控：用于全局快捷键、按键模拟。
- 完全磁盘访问（按需）：当 RPA 需要读取受限目录时。
Windows（仅在用桌面 RPA 时需要）
Section titled “Windows（仅在用桌面 RPA 时需要）”- 第一次启动 MagicAI 时不要拒绝防火墙提示。
- 杀毒软件 / 终端管理软件请放行 MagicAI 主程序。
- 操作浏览器时避免另一个版本的 Chrome 同时使用同一调试端口。
- 高 DPI 显示器若坐标偏移，可在客户端设置中开启 DPI 适配。
【醒目图片占位 | env-windows-permissions】
请放置 Windows 防火墙提示弹窗与杀毒软件信任配置截图。
浏览器 / 手机 / 云端环境
Section titled “浏览器 / 手机 / 云端环境”- 内置浏览器、云浏览器、云手机：不需要操作系统权限。
- 仍然需要遵守目标网站 / App 的访问规则（频率、IP 白名单、是否允许自动化）。
外部系统访问
Section titled “外部系统访问”任何要访问外部系统的工作流，凭据请统一放进 连接，不要写在节点参数、提示词或日志中。
第一次配环境的建议路径
Section titled “第一次配环境的建议路径”- 第一次练习选 内置浏览器，访问公开网页。
- 跑通后再换 云浏览器，配置真实业务后台账号。
- 需要操作 App 时再启用 云手机。
- 需要在你电脑上跑的桌面操作，最后用 本地桌面，并配 macOS / Windows 权限。
| 你遇到的情况 | 处理方式 |
|---|---|
| 浏览器节点提示“没有可用浏览器” | 在编辑器里选择执行环境为内置浏览器或云浏览器 |
| 云浏览器登录态失效 | 进入云浏览器手动登录一次，重新发布工作流 |
| 桌面 RPA 无法点击 / 截图全黑 | 检查 macOS / Windows 系统权限 |
| 鼠标键盘被抢 | 把本地桌面任务挪到一台不需要交互的机器 |
| 触发对方风控 | 降低频率、错峰执行、申请 IP 白名单 |
- 想搭一个真实示例：搭建浏览器 RPA 工作流。
- 想学习元素定位和调试：录制、元素与调试。
- 想集中管理外部账号 / 凭据：连接外部系统。
- 想理解工作流整体：什么是工作流自动化。