返回
gstack 教程系列 Developer Tools

gstack 教程 6B：多代理浏览器（跨代理协调）

/pair-agent 在 AI 代理之间共享浏览器。跨代理协调，带范围令牌、标签隔离和用于认证测试的 cookie 导入。

教程概述

系列索引: gstack 教程系列

/pair-agent 让多个 AI 代理共享一个浏览器。每个都有自己的标签页，与其他隔离。

你将学到

  • ✅ /pair-agent 用于跨代理协调
  • ✅ 范围令牌和标签隔离
  • ✅ /setup-browser-cookies 用于认证测试
  • ✅ 真实的协调模式

为什么需要多代理浏览器？

单代理限制

一个 AI 代理一次只能做一件事。但通常你需要：

  • 同时比较两个页面
  • 测试账户之间的用户交互
  • 协调前端和后端测试

多代理解决方案

flowchart TD
    A[Claude Code] --> B[GStack 浏览器]
    C[OpenClaw] --> B
    D[Codex] --> B
    B --> E[标签 1: Claude]
    B --> F[标签 2: OpenClaw]
    B --> G[标签 3: Codex]

    style B fill:#e1f5ff

/pair-agent — 跨代理协调

工作原理

  1. 启动浏览器 — GStack 浏览器打开
  2. 打印说明 — 要粘贴到其他代理的代码块
  3. 交换凭证 — 一次性设置密钥换取会话令牌
  4. 创建隔离标签 — 每个代理获得自己的标签
  5. 一起观看 — 看到两个代理在工作

使用

/pair-agent

输出：

GStack 浏览器已启动。与另一个代理共享：

[将此代码块粘贴到你的其他代理聊天中]

---BEGIN PAIR BLOCK---
SESSION_ID: abc-123
TOKEN: scoped_token_xyz
URL: http://localhost:9222
---END PAIR BLOCK---

另一个代理将：
1. 接收配对代码块
2. 连接到浏览器
3. 获得自己的隔离标签
4. 能够独立浏览

安全功能

功能 目的
范围令牌 有限权限，可撤销
标签隔离 代理无法访问彼此的标签
速率限制 防止滥用
活动归属 知道哪个代理做了什么
域限制 可选白名单

支持的代理

  • Claude Code
  • OpenClaw
  • Hermes
  • Codex
  • Cursor
  • 任何可以 curl 的代理

/setup-browser-cookies — 会话管理器

功能

从你的真实浏览器导入 cookies 到 AI 浏览器会话。

支持的浏览器

  • Google Chrome
  • Arc
  • Brave
  • Microsoft Edge

使用

/setup-browser-cookies

输出：

选择浏览器来源：
[1] Chrome
[2] Arc
[3] Brave
[4] Edge

输入选择：1

✅ 从 Chrome 导入了 47 个 cookies
- github.com: logged_in, user_session
- google.com: SID, HSID, SSID
- ...

你的 AI 代理现在可以访问认证页面。

何时使用

  • 测试认证功能
  • 保留登录状态
  • 访问付费/受保护内容
  • 个人自动化

安全说明

Cookies 仅在会话期间存储在内存中。永远不会写入磁盘或传输。

协调模式

模式 1：并行比较

两个代理并排比较页面：

代理 1：浏览预发布网站，发现布局问题
代理 2：浏览生产网站，比较

结果：带截图的并排比较

模式 2：用户交互测试

测试账户之间的交互：

代理 1：用户 A 发送消息
代理 2：用户 B 接收消息

结果：实时交互测试

模式 3：前端 + 后端

一个代理测试 UI，另一个测试 API：

代理 1：点击前端流程
代理 2：监控 API 响应

结果：全栈验证

示例：测试聊天应用

设置

# 代理 1 (Claude Code)
/pair-agent

# [复制配对代码块]

# 代理 2 (OpenClaw)
[粘贴配对代码块]

代理 1（用户 A）

/setup-browser-cookies  # 导入登录 cookies
/browse https://chat.example.com
$B type "#message" "来自用户 A 的你好"
$B click "button[type='submit']"
$B screenshot

代理 2（用户 B）

/setup-browser-cookies  # 导入不同账户的 cookies
/browse https://chat.example.com
$B wait ".message"
$B text ".message:last-child"
# 输出: "来自用户 A 的你好"
$B screenshot

结果

两个代理实时从不同账户看到同一个聊天。

技能快速参考

命令 用途
/pair-agent 与另一个代理共享浏览器
/setup-browser-cookies 从真实浏览器导入 cookies
$B handoff 切换到可见浏览器
$B resume 切换后恢复

总结

多代理浏览器实现：

  1. 跨代理协调 — 多个 AI 代理，一个浏览器
  2. 标签隔离 — 每个代理在自己的标签中
  3. Cookie 导入 — 测试认证页面
  4. 安全性 — 范围令牌、活动归属

关键要点

  • ✅ 使用 /pair-agent 进行多代理测试
  • ✅ 导入 cookies 进行认证访问
  • ✅ 每个代理获得隔离标签
  • ✅ 实时观看代理工作

系列导航：