如何将树莓派用作 AI Agent RDP 客户端

Raspberry Pi 体积小、成本低，适合运行命令行自动化。它可以作为 AI Agent 的专用 RDP 客户端，连接并操作远程 Windows 桌面。

实际架构是：

AI Agent → Raspberry Pi → rdp-cli → Windows RDP 会话

树莓派不会替代 Windows，而是运行远程桌面客户端，让 Agent 能观察和控制 Windows 屏幕。

为什么使用树莓派作为 RDP 客户端？

树莓派可以长期在线、靠近本地网络，并把远程自动化任务与个人电脑分开。它可以通过 LAN 或 VPN 连接 Windows，操作没有 API 或 SDK 的老旧应用，例如财务软件、仓库系统、ERP、报表工具和内部桌面程序。

树莓派环境要求

当前 ARM64 版本建议使用：

Raspberry Pi 4
64 位 Raspberry Pi OS 或 Debian
可以访问 Windows 的网络
Windows 已启用 RDP
有权限进行 RDP 登录的账户

官方平台说明列出了 Raspberry Pi 4 和 64 位 Debian 13.7 的测试配置。32 位 Raspberry Pi OS 不支持，其他树莓派型号应先自行验证。

安装并连接

下载 Linux ARM64 程序并运行：

chmod u+x ./rdp-cli-linux-arm64
./rdp-cli-linux-arm64 --help

连接 Windows 时，使用安全的密码输入方式：

printf '%s' "$RDP_PASSWORD" |
  ./rdp-cli-linux-arm64 connect   --host WINDOWS_IP   --user WINDOWS_USER   --password-stdin

保存返回的会话 ID。不要把密码硬编码或输出到日志。

使用“观察—操作—验证”循环

AI Agent 在每次关键操作前都应获取新的截图：

./rdp-cli-linux-arm64 screenshot --session SESSION --out before.png
./rdp-cli-linux-arm64 click --session SESSION --desktop --x X --y Y --observation OBSERVATION
./rdp-cli-linux-arm64 screenshot --session SESSION --out after.png

例如，Agent 可以打开库存软件、登录、选择仓库、输入 SKU、确认弹窗、保存记录，然后检查状态是否更新。命令被接受并不代表 Windows 应用已经完成任务。快速上手指南介绍了这种截图—操作—截图流程。

传输项目文件

如果 RDP 服务器允许驱动器重定向，rdp-cli 可以把文件或完整文件夹上传到会话交换驱动器，处理完成后再下载结果。文件夹结构会保留，适合表格、PDF、测试数据、报告和项目文件夹。

文件传输功能支持查看进度、取消传输、明确确认覆盖，并验证传输内容。

人工接管和限制

用户可以通过原生窗口或授权浏览器打开同一会话，暂停 Agent、手动修正，再把控制权交还给 Agent。VNC 可以查看和控制，但不提供同样的 RDP 文件夹传输流程。

rdp-cli 不会让所有 Windows 应用自动具备 API，也不替代单元测试、后端测试、数据库校验或性能分析。

常见问题

需要桌面环境吗？ 不需要，rdp-cli 是命令行客户端。

支持所有树莓派型号吗？ 官方测试的是 Raspberry Pi 4 64 位 ARM64；32 位系统不支持，其他型号需自行验证。

rdp-cli 本身会运行 AI Agent 吗？ 不会。AI Agent 或自动化框架负责调用 rdp-cli 命令。

总结

在树莓派上运行 rdp-cli，通过 RDP 连接 Windows，获取截图，执行一个操作，再获取截图验证结果。这是从轻量 Linux ARM64 设备自动化老旧 Windows GUI 流程的实用方式。

如何将树莓派用作 Windows 的 AI Agent RDP 客户端