OSWorld项目在Apple芯片MacBook上的Chrome连接问题解决方案

问题背景

在使用OSWorld项目时，Apple芯片MacBook用户可能会遇到浏览器连接失败的问题。具体表现为运行项目时出现"Failed to connect"错误，系统提示无法找到"chromium-browser"文件。这是由于项目最初设计时针对的是x86架构的Chrome浏览器，而在Apple芯片(M1/M2)MacBook上使用的是特殊的Chromium版本。

错误分析

错误日志显示系统尝试连接Chrome浏览器时失败，主要原因有两个：

1. 在Apple芯片MacBook上，浏览器可执行文件名为"chromium"而非"chromium-browser"
2. 项目默认配置中使用了错误的浏览器名称

解决方案

方法一：修改配置文件并创建新快照

1. 首先需要修改虚拟机中的配置文件：

   • 打开虚拟机中的~/server/main.py文件
   • 找到第109行左右的代码
   • 将"chromium-browser"修改为"chromium"

2. 创建新的虚拟机快照：

   vmrun -T fusion snapshot path/to/vm snapshot_name
   

3. 在运行脚本时指定新的快照名称：

   env = DesktopEnv(
       path_to_vm=args.path_to_vm,
       snapshot_name="snapshot_name",  # 使用新创建的快照名称
       action_space=agent.action_space,
       screen_size=(args.screen_width, args.screen_height),
       headless=args.headless,
       require_a11y_tree=args.observation_type in ["a11y_tree", "screenshot_a11y_tree", "som"],
   )
   

方法二：等待官方更新

开发团队已经注意到这个问题，并计划在本周内更新虚拟机的设置和相关脚本，以解决Chromium兼容性和系统休眠问题。用户可以关注项目更新，获取官方修复版本。

注意事项

1. 在创建新快照时，确保系统没有进入休眠模式，否则可能导致快照创建失败
2. 修改配置文件后必须创建新快照才能使更改生效
3. Apple芯片用户应使用专门为ARM架构优化的虚拟机镜像

技术原理

这个问题的本质在于不同操作系统和架构下浏览器可执行文件的命名差异。在Linux系统中，Chrome浏览器通常安装为"chromium-browser"，而在macOS特别是Apple芯片设备上，则简化为"chromium"。项目最初的设计可能没有充分考虑跨平台兼容性，导致了这一问题。

通过修改配置文件和创建新快照的方式，可以确保虚拟机启动时使用正确的浏览器可执行文件路径，从而解决连接失败的问题。