mcpField
A
agent-browser-wsl2-setup

agent-browser-wsl2-setup

github.com/arthurzakirovAgent 工作流1162 次安装2 周前更新
代码仓库

关于 agent-browser-wsl2-setup

用于在 WSL2 中配置 agent-browser 的技能，涵盖安装和运行时设置。它区分原生 Linux Chrome 与 Windows 主机浏览器桥接，并分别提供操作步骤。

主要功能

  1. 01安装 agent-browser 及运行时
  2. 02配置运行时设置脚本
  3. 03测试 WSL2 原生 Chrome 浏览
  4. 04连接 Windows 浏览器桥接
  5. 05提供故障排查与架构参考

适用场景

  1. 01在新的 WSL2 机器上准备 agent-browser
  2. 02测试原生 Linux Chrome 浏览
  3. 03将 agent-browser 接入 Windows 浏览器
  4. 04排查 agent-browser 配置故障

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/arthurzakirov/agentdesk --skill agent-browser-wsl2-setup

安装后在 Claude Code 中输入/agent-browser-wsl2-setup确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

agents/
openai.yaml
references/
architecture.md
dead-ends.md
troubleshooting.md
scripts/
connect-windows-browser.sh
ensure-wslconfig.ps1
setup-agent-browser-runtime.sh
setup-agent-browser-wsl2.sh
setup-native-wsl-chrome.sh

详细介绍

Agent Browser WSL2 设置

此技能仅负责 agent-browser 设置。

浏览器可用性由 $wsl2-browser-setup 负责。如果以下两项均不成立，请先使用该技能：

  • WSL2 内的原生 Linux google-chrome 可用于实际浏览和登录
  • 可从 WSL2 通过 /json/version 访问 Windows 主机浏览器桥接

引导设置分工

在新机器上，直接通过 AI 运行以下两个命令：

npm install -g agent-browser
agent-browser install

然后让人类运行以下交互式命令：

npx skills add vercel-labs/agent-browser

重要事项：

  • npm install -g agent-browser 是非交互式命令，尽可能由 AI 运行
  • agent-browser install 是非交互式命令，尽可能由 AI 运行
  • npx skills add vercel-labs/agent-browser 是交互式命令，应由人类运行

人类完成交互式的 npx skills add ... 流程后，继续运行运行时设置脚本。

运行时设置

运行：

bash "${CODEX_HOME:-$HOME/.codex}/skills/agent-browser-wsl2-setup/scripts/setup-agent-browser-runtime.sh"

该脚本会：

  • 在缺少 agent-browser 时安装它
  • 在需要时运行 agent-browser install
  • 在缺少 vercel-labs/agent-browser 时克隆它

模式 A：WSL 原生浏览器

如果 $wsl2-browser-setup 提供的浏览器路径是 WSL2 内的原生 Linux Chrome，请直接测试 agent-browser：

agent-browser doctor --offline --quick
agent-browser open https://example.com
agent-browser snapshot -i -c

如果手动浏览正常，但这里仍然卡住，请停止在此处排查浏览器问题，改用模式 B。

模式 B：Windows 主机浏览器桥接

如果 $wsl2-browser-setup 提供的浏览器路径是 Windows 主机浏览器桥接，请将 agent-browser 连接到现有的 CDP 端点：

bash "${CODEX_HOME:-$HOME/.codex}/skills/agent-browser-wsl2-setup/scripts/connect-windows-browser.sh" --session windows-host --bridge-port 9333
agent-browser --session windows-host get title
agent-browser --session windows-host snapshot -i -c

在原生浏览器路径得到整理之前，这是经过验证的控制路径。

旧版组合封装脚本

scripts/setup-agent-browser-wsl2.sh 仍作为兼容性封装脚本存在，用于较早的一次性 Windows 桥接流程。

建议改用拆分后的技能：

  1. $wsl2-browser-setup
  2. $agent-browser-wsl2-setup

捆绑资源

评论

支持 Markdown