Sabrina 需要连接一个运行中的 OpenClaw 实例才能工作。OpenClaw 是 AI agent 平台，Sabrina 是它的浏览器工作台。
版本要求： OpenClaw 最新版本，Sabrina ≥ 0.1.13。
这份文档给第一次使用 Sabrina 的用户。
目标只有一个：把 Sabrina 接到你的 OpenClaw 上，然后直接开始用。
适合：
- Sabrina 和 OpenClaw 在同一台机器
- 你已经能在终端里正常运行
openclaw
推荐顺序：
- 启动 Sabrina
- 打开
OpenClaw设置页 - 直接点
自动连接这台机器 - 如果需要，再点一次
重新检查
成功后你会看到：
- 已接入
- 当前浏览器开始复用 OpenClaw
- 模型、技能、记忆都能直接用
适合：
- 你的 OpenClaw 跑在另一台机器上
- 你想在 Sabrina 里切过去使用它
Sabrina 现在把“连接地址 + 连接码”当成另一台机器的主路径。
适合：
- 不方便直接 SSH
- 想通过 Sabrina 生成一次性连接码并在另一台机器上认领
推荐顺序：
- 点
连接另一台机器 - 填
连接地址 - 点
生成连接码 - Sabrina 会给你一条需要在另一台机器执行的命令
- 在那台 OpenClaw 机器上执行那条命令
- 等待 Sabrina 显示远端已认领、worker 已就绪
- 回到 Sabrina，点
连接这台机器 - 如果以后还会切回来，点
保存这台机器
如果你想先确认参数，也可以在终端里检查：
openclaw sabrina probe --target remote --driver relay-paired --relay-url https://relay.example.com --connect-code 482913Sabrina 现在支持：
- 保存多个 OpenClaw 目标
- 但一次只激活一个
建议：
- 经常使用的机器先保存
- 需要切换时，直接在“已保存的 OpenClaw”里点
连接
这通常不是另一台机器上的 OpenClaw 本身挂了，而是 本机 Sabrina connector bridge 没起来。
优先这样做：
- 确认 Sabrina 正在运行
- 回到
OpenClaw设置页 - 重新做一次连接或检查
现在插件也会尝试自动恢复陈旧的本地桥信息，但如果 Sabrina 根本没打开，还是需要先启动 Sabrina。
SSH 是仍然支持的连接方式，适合直接有 SSH 访问权限的场景。
SSH 连接方式：
- 在目标配置里填入 SSH 地址（格式：
user@host或user@host:port） - 确保本机 SSH 密钥已配置，能无密码登录目标机器
- Sabrina 会通过
ssh-clidriver 在远端执行 OpenClaw
SSH 和连接码是两条并行路径，代码里均为一等公民（driver 分别为 ssh-cli 和 relay-paired）。
什么时候优先选连接码而不是 SSH：
- 目标机器没有暴露 SSH 端口（如防火墙限制）
- 不方便管理 SSH 密钥
- 希望通过一次性连接码临时授权
如果你看到的是旧版 SSH 目标，保留没问题，也可以新建一个 连接地址 + 连接码 目标作为替代。
连接地址（Relay URL）是中继服务的 HTTPS 地址，用于 Sabrina 和远端 OpenClaw 之间的配对通信。
Sabrina 没有内置公共中继服务，中继地址需要你自己提供或部署：
- 如果你的团队或 OpenClaw 提供商提供了中继服务，直接填入对方给你的地址。
- 如果你想自己搭建，仓库里包含
packages/sabrina-relay-dev，可以在任意支持 Node.js 的服务器上运行。 - 地址格式为 HTTPS URL，例如
https://relay.your-domain.com。
填好地址后，Sabrina 会在点击 生成连接码 时将配对信息发布到该中继。
先确认：
连接地址正确- 远端机器已经执行 Sabrina 给出的命令
- 连接码还没过期
如果你在帮助别人远程接入 OpenClaw，最省心的路径通常是：
- 先让用户填
连接地址 - 生成连接码并拉起远端 worker
检查通过后再连接- 常用远端先保存成目标，后面直接切换