安全:智能体令牌、浏览器会话与中继密钥 0.9.27 新增
一个中继只有一个为它负责的人:你。自 0.9.27 起,其他所有与中继通信的一方都有自己的凭据,权限比你小。智能体有自己的令牌,每台浏览器持有一个会话而不是中继令牌,已配对的中继用密钥登录。本页说明每种凭据能做什么、你在 Settings → Security(设置 → 安全)中能看到什么,以及还有哪些缺口。关于中继究竟暴露了什么,参见安全概览。
谁持有什么 #
| 凭据 | 谁持有 | 它能打开什么 |
|---|---|---|
| 中继令牌 | 你,保存在你的密码管理器里。中继只保存它的哈希 | 一切。你用它让浏览器登录,也用它配对中继 |
| 浏览器会话 | 每台已登录的浏览器,保存在它的 cookie 中,另有一个证明密钥保存在页面的存储里 | 你在网页界面中能做的事 |
| 智能体令牌 | 每个会话(OAR_),以及 oar 命令 |
智能体需要的路由,不含任何属于你的 |
| 中继密钥 | 已配对的中继,每个方向一个密钥 | 只有中继之间互相调用的路由 |
| 登录链接 | 你把它交给的那个人,只能用一次,10 分钟内有效 | 一个新的浏览器会话 |
智能体可以做什么,什么归你 #
每个会话的环境都会得到 OAR_,这是一个绑定到该会话所属对话的令牌。会话的 worker、它的 CLI 和工具,以及 OAR 自己的智能体工具,都用它调用中继。智能体再也找不到中继令牌:环境变量、命令行、config.、日志和对话记录里都没有。
智能体令牌可以:
- 读取会话、设置和用量;
- 向会话发送提示词、停止、归档、压缩和重新启动会话,并运行自己的轮次;
- 发出自己的提问卡片和计划卡片;
- 使用
relay_、中继事件和定时任务;tool - 使用文件、驱动器、git 和上传文件,以及它自己对话的预览;
- 把会话移入一个已有的分组,或从中移出;
- 带着理由排队一次中继重启,并取消它。
以下只归你,智能体令牌会得到 403 AUTH_:
- 回答或忽略任何提问卡片,包括另一个对话里的普通提问卡片、Safety check(安全检查)、审批卡片或计划卡片。
relay_的tool answer_会说 Only the person can answer questions; ask them in the relay UI;question - Inbox(收件箱);
- 设置、提供商登录、配对、推送设备和分享链接;
- 删除会话,以及创建、重命名或删除分组;
- 立即重启、普通关闭、更新和安装;
- 网页界面的实时连接。
一个会话的令牌只代表该会话行事:relay_ 会拒绝针对另一个对话的调用(AUTH_),智能体只能通过 relay_ 的 create_ 启动新会话,而那里适用你的 Allow(允许)和会话数上限。智能体设置 owner_ 时,中继会忽略它。
你在中继主机上运行的脚本使用同样的令牌:在会话内部,用 Authorization: Bearer $OAR_;在会话外部,oar agent- 会打印一个令牌。两者都不是中继令牌。不发送任何令牌的脚本会得到 401 The relay
token is no longer in the config; use OAR_AGENT_TOKEN。
浏览器会话 #
登录时,中继令牌只交换一次——在登录框中或通过登录地址——换成该浏览器的一个会话。此后浏览器的 cookie 保存的是会话,绝不是令牌,而中继只保存会话的哈希。
- 有效期。 会话在最后一次使用后保持 30 天,最长 400 天。中继最多保存 50 个;新会话会挤掉最久未使用的那个。
- 证明密钥。 登录时页面还会得到第二个秘密,保存在页面自己的存储中,并随每个请求发送。浏览器会把中继的 cookie 发送给中继主机的每个端口,因此当你打开智能体在那里运行的开发服务器时,那个服务器会收到它。没有证明密钥,cookie 只能打开浏览器自行加载的附件、生成的图片和媒体(参见这些防护的局限)。在浏览器中清除该站点的数据会删除这个密钥:那台浏览器需要重新登录。
- 密钥只留给中继。 页面只把证明密钥发送到中继自己的地址(端口也算在内)下的
/。智能体放进回复里的、来自其他地址的图片(包括中继主机其他端口上的地址)绝不会得到它,在查看器中也没有 🖍️。api/ - 按路径打开的文件。 页面按路径打开的文件(图片、视频、下载、在新标签页中打开的 PDF)会在地址中带有一个文件授权
k。页面用自己的证明密钥申请它。它只打开那一个文件,只能与这台浏览器的 cookie 一起使用,最长 10 分钟;页面会按需续期,因此长视频可以继续播放。从页面中复制出来的文件链接在那之后就会失效。错误或过期的k会得到403 AUTH_,无论路径是什么,答复都一样,因此它不会透露任何关于文件的信息。FILE_ CAPABILITY - 媒体地址带有标签。 媒体库给出的每个地址都带有一个标签
t;没有标签的媒体地址会得到404,无论是谁请求,因此复制来的 cookie 无法逐个翻遍媒体。标签不会过期,但当relay-被替换时,旧的媒体地址会失效,媒体库会给出新的地址。secrets. json - 0.9.27 之前的浏览器把令牌保存在 cookie 中。那个 cookie 现在什么都打不开了:页面启动时,会用它一次性换取一个会话及其证明密钥,不会出现登录框。更新前就打开着的标签页运行的是旧页面,需要重新加载一次。
- 已退出登录。 会话不再有效的浏览器会在登录页上显示 This browser was signed out;从它回答的通知会显示 Signed out, open OAR。
- 脚本不产生会话。 在
Authorization请求头中带有中继令牌的请求无需会话就以你的身份行事,绝不会在列表中添加浏览器。
Settings → Security(设置 → 安全) #
Settings → Security 关乎谁能使用这个中继。智能体和已配对的中继打不开它。
- Browsers signed in(已登录的浏览器)列出在此有会话的每台浏览器,当前这台排在最前并标有 this browser(此浏览器)。每一行显示:它的名称,取自它报告的浏览器和系统,直到你用 Rename(重命名)改名;何时以及如何登录(中继令牌、登录链接、终端,或从有会话之前沿用而来);最后一次出现的时间及其最后的地址。如果某台浏览器的最后一次请求是经由中继主机上的代理或隧道、从主机本身到达中继的,它会显示 this host (forwarded for …)(本主机,转发自 …),括号中是转发来的地址。
- 某一行上的 Sign out(退出登录)会立即结束那台浏览器的会话,关闭它的实时连接并停止它的推送通知。Sign out all other browsers(让其他所有浏览器退出登录)只保留当前这台;Sign out this browser(让此浏览器退出登录)会在这里调出登录框。每个操作都会先询问。
新登录提醒 #
当一台浏览器用中继令牌、登录链接或终端登录时,其他每台已登录的浏览器都会在登录完成之前收到通知:
- 标题栏下方横幅中的一行,无论有多少次登录都只占一行:New
browser signed in:
, , via … ,带有 Sign it out(让它退出登录)和 Got it(知道了),或者 3 new browsers signed in (latest: …)。Show all(显示全部)会在对话上方打开列表,每台浏览器都显示它如何以及何时登录,并带有 Sign it out;一次 Got it 会关闭全部提醒; - 一条推送通知 New browser signed in,即使某台设备打开着应用也会发送,发给持有会话的每台设备,新登录的那台除外。它带有 Sign it out 操作,轻点它会打开 Settings → Security。5 分钟内的多条通知会相互替换。对应的开关是 Settings → Notifications(设置 → 通知)中的 A new browser signed in(有新浏览器登录)。
经由中继主机上的代理或隧道、从主机本身到达中继的登录会显示 this host(本主机),括号中是转发来的地址,绝不会只显示那个地址。
中继会保留这些通知 7 天。每台浏览器只为自己忽略它们,因此新会话无法对其他浏览器隐藏自己的登录。重新登录的浏览器会再次看到最近 7 天的通知,包括它已经忽略过的。终端登录的通知在那台浏览器保持登录期间一直保留,无论之后还有多少次登录。
登录另一台设备 #
你不再需要在手机上输入中继令牌。
- 在一台已登录的浏览器上,打开 Settings → Security → Sign in another device(设置 → 安全 → 登录另一台设备),然后按 Make a sign-in link(生成登录链接)。
- 在另一台设备上打开该链接,或者按 Show QR code(显示二维码),用那台设备的相机扫描。
该链接(…/)只能让一台浏览器登录一次,10 分钟内有效。标签页会显示它还剩多长时间。谁先打开它,谁就会登录,所以只在只有你能看到的地方展示或发送它。二维码会在以下情况下再次隐藏:一分钟后、你离开页面或关闭设置时、链接已被使用或过期时,以及按下 Hide QR code(隐藏二维码)时。新链接会使上一个链接失效,中继重启也会使它失效。
在中继主机上,oar url --sign- 会在终端中为手机能访问的地址打印这样一个链接及其二维码。中继在 10 分钟内最多生成 3 个这样的链接,新链接会取代之前的那个,之前的链接随即失效;命令会说明这一点。对于以这种方式登录的浏览器,浏览器列表会显示 from the terminal (oar url --sign-in)。
在同一个主机名下、以不同端口访问的两个中继(host:、host:)会在浏览器中共用一个登录 cookie,并互相把对方退出登录。请给每个中继一个自己的主机名。
中继令牌 #
中继令牌是属于人的凭据:把它保存在你的密码管理器里。中继只保存它的哈希,位于数据文件夹的 relay- 中;参见机密存放在哪里。新令牌以 oaro1_ 开头;早期版本的令牌继续有效。
- 它只显示一次。 在终端中运行
oar setup会把新令牌显示一次,同时显示一个登录链接和一个二维码。没有终端时(服务、脚本、智能体),什么都不会打印令牌,因为那些输出会进入智能体能读取的日志。 oar url不打印令牌。 中继做不到:它只持有哈希。- 弄丢了? 从一台仍处于登录状态的浏览器登录另一台设备,或者更换令牌。如果没有任何浏览器处于登录状态,请在中继主机的终端中运行
oar setup --new-。token
生成新的中继令牌 #
Settings → Security → Relay token(设置 → 安全 → 中继令牌)会显示是否已设置令牌、中继只保存它的哈希,以及它是何时创建或最近一次更换的。Generate new relay token(生成新的中继令牌)会先询问,The current token stops working at once. Signed-in browsers stay signed in; agents keep working.,然后把新令牌显示一次:
- 在你按 Show(显示)之前一直隐藏,带有 Save in password manager(保存到密码管理器)、Copy(复制)和 Copy pairing link(复制配对链接);按下第一个时,你的密码管理器会提出以中继的名称保存它;
- 旧令牌最近一次被浏览器页面之外的东西(例如脚本或较旧的已配对中继)使用的时间,以及来自哪个地址;
- 仍在用旧令牌调用的已配对中继,每个都带有 Open there(在那里打开),它会打开那个中继的 Settings → Relays(设置 → 中继),并让 Add a relay(添加中继)准备好接收配对链接。用密钥登录的中继会继续工作,不会列出。
关闭对话框会把令牌从页面中移除。粘贴之后请清空剪贴板:剪贴板历史会保留它。
立即发生的变化:旧令牌失效。已登录的浏览器保持登录,智能体、它们的令牌和会话 worker 照常工作,用密钥配对的中继也继续工作。发送旧令牌的脚本需要新令牌,更好的做法是改用 OAR_。在终端中,oar setup --new- 在你输入 NEW 后做同样的事,并重启中继。
由 0.9.26 或更早版本通过 oar copilot 启动的中继,或用手动指定的 --token 启动的中继,会把旧令牌保留在它的看护进程的命令行上,直到它被停止并重新启动一次。请在生成新令牌之前这样做;参见升级说明。
横幅与 Recommended 圆点 #
更新到 0.9.27 之后,标题栏下方的横幅会显示 Your relay token was readable by agents until this version. Generate a new one. Generate new token(生成新令牌)会打开上面的对话框;Dismiss(关闭)会隐藏它,对整个中继只需一次。如果你关闭横幅后仍然建议更换令牌,Security 选项卡会一直带着一个小圆点,令牌那一行会带着 Recommended(推荐)标签,直到你更换令牌。
当令牌不是由中继自己更改时,横幅还会显示 The relay token was changed outside OAR:例如有人把 auth 放回了 config.,或 relay- 被改动过。如果是你自己做的,就关闭它;否则请生成新令牌。只有你自己已登录的页面会显示它,分享视图绝不会显示。
中继从不提供的文件 #
无论使用哪种凭据,包括中继令牌,OAR 的文件路由都绝不会提供或更改中继自己的文件:relay-、数据库(oar. 及其 -wal 和 -shm 文件、它的备份以及正在写入的备份)和 config.。它们会返回 403 FILE_。文件浏览器不能重命名、移动或删除它们,也不能对包含其中之一的文件夹这样做;媒体库也绝不会提供消息中提到的这类文件。指向其中之一的链接或硬链接同样会被拒绝。这只是把它们挡在文件路由之外:智能体自己的 shell 仍然可以读取它们(参见这些防护的局限)。
已配对的中继 #
已配对的中继不再保存对方的中继令牌。两边都是 0.9.27 或更高版本时,配对只使用对方配对链接中的令牌一次,用来交换密钥。此后每个中继都用自己的密钥登录对方,这个密钥只打开中继之间互相调用的路由:绝不打开设置、文件、配对、会话的计费,也不能回答卡片或提问(403 REMOTE_)。更换某个中继的令牌不再会破坏密钥配对。之前配对的中继在两边都运行 0.9.27 后,大约一分钟内会自行切换到密钥。
- 双向。 勾选 Also add this relay there(同时在对方添加此中继)时,每个中继都会从对方得到一个密钥。
- 单向。 不勾选时,链接中的令牌只用于这次添加,只存在于内存中,绝不保存。对方中继会给本中继一个仅入站密钥,并把本中继列为 Inbound only(仅入站):它从不调用本中继,它的 Remove(移除)会立即撤销该密钥。在本中继这里,那一行显示 One way(单向)。
- 添加期间的令牌。 两边都是 0.9.27 时,链接中的令牌只在添加进行期间保存在内存中,一旦有密钥可用,就绝不会写入数据库。只有结束时没有可用密钥的添加(对方中继较旧,或交换失败)才会保存它,直到有密钥可用为止。这样保存后又丢弃的令牌,可能仍能从数据库的空闲页及其
oar.中读出,直到 SQLite 重新使用这些页;如果这对你很重要,请更换那个中继的令牌。db- wal - Settings → Relays 中的 Re-pair(重新配对)一键重新交换密钥。当本中继持有的任何东西在对方那里都不再有效,或者对方中继版本较旧时,它会打开 Add a relay 并填好地址:粘贴那个中继的配对链接,条目就会原地更新。
- Renew key(更新密钥)和 Revoke key(撤销密钥)只作用于一个中继。密钥每 30 天会自行更新。被撤销的密钥会一直作废,直到你更新它,或者那个中继通过本中继的配对链接再次被添加,这会让它重新得到一个可用的密钥。只有移除该中继并且生成新的中继令牌,才能把它永久拒之门外。
已验证的来源与未验证的来源 #
来自已配对中继的提示词,会以你在这里给那个中继起的名称,标明是哪个中继的密钥让它登录的,而绝不采用请求对自己的说法。
- 已验证。 通过密钥进来的提示词。它可以做限制允许的事。
- 未验证。 在这里没有已确认密钥的中继(早于 0.9.27 的 OAR,或密钥尚未确认)仍能访问它的会话,但它的提示词会显示 claimed(未验证)标签,智能体在其标题行中读到“(unverified)”,而且它什么也打不开:没有回复权限、没有跳转额度、不抑制推送、不能提问或监视。发送方智能体会被告知原因。0.9.27 之前保存的提示词也会显示为未验证。
- 被拒绝的身份声明。 自称是另一个中继的密钥会被拒绝(
REMOTE_),任何其他自称是某个有密钥的中继的凭据也会被拒绝(RELAY_ ORIGIN_ MISMATCH REMOTE_)。每次拒绝都会被记录,并计入那个中继的那一行,N refused claims since start,每个中继的第一次拒绝会在 Inbox 中放一条通知。RELAY_ PEER_ KEY_ REQUIRED - 身份变更会被暂扣。 一旦某个中继有了密钥,或者本中继持有来自它的密钥,它的地址和中继 id 就会被固定。如果它们发生变化,或者另一个中继在它的地址上应答,它的密钥会被撤销,本中继不再向它发送为它保存的任何东西(它给本中继的密钥,或令牌),并且在你于它那一行上按 Confirm(确认)之前,不会签发任何新密钥。把地址改回生成密钥时的那个地址,可以解除仅由地址变更造成的暂扣。
已配对中继的提问要在那个中继上、在那里登录后回答。Inbox 以只读方式显示它们,带有 Open there;对于运行 0.9.27 的中继,还带有选项按钮,会在一个小窗口中打开那里的提问;参见提问与 Inbox。
对敏感文件的编辑 #
Claude、Claude API 和 DeepSeek 会话在编辑 Claude Code 标记为敏感的文件之前会先问你,因为那里的更改可能改变 git、shell 或某个工具的行为:例如 . 这类 shell 启动文件、.,以及 . 或 . 下的任何内容等等。这样的编辑会在每种中继模式下(包括 autopilot)在一张 Safety check 卡片上等待,卡片显示文件和完整的更改,并带有 Allow once(仅允许一次)和 Deny(拒绝)。只有你能回答它:智能体令牌和已配对中继的密钥都会被拒绝。它绝不会允许超出那一次编辑的任何操作,没有回答的卡片会让文件保持不变。监视该会话的智能体或已配对中继只会得到卡片固定的第一行和 File: 行,绝不会得到更改内容。
读取这样的文件,或通过中继发送这样的文件,都不会询问;以 Claude Code 不标记的方式写入它的命令也不会。这张卡片是对智能体编辑的一道检查,而不是沙箱。
这些防护的局限 #
智能体令牌把智能体的工具和你的工具分开。它们不是沙箱:智能体以与中继相同的操作系统用户运行,而该用户仍然可以做到以下这些。
- 更改中继的文件。 智能体可以写入
relay-、secrets. json config.、数据库或中继的代码,然后排队一次重启,从而装上它自己的令牌。中继只会注意到这一点:它在启动时把令牌的哈希与数据库中的副本比较,并报告 The relay token was changed outside OAR。同时改动两者的智能体可以绕过这一点。从同一个文件,它还能生成任何会话的智能体令牌。文件路由会拒绝这些文件,但智能体的 shell 并不经过文件路由。json - 使用终端路径。
oar setup --new-和token oar url --sign-的终端检查只是增加麻烦,而不是边界:智能体可以伪造终端,或用in oar agent-调用该路由。以这种方式进行的登录会像上面那样通知其他每台浏览器,并在浏览器列表中显示“via the terminal”。让这样的浏览器退出登录,然后更换令牌。token - 在中继主机上接管浏览器的会话。 同一台机器、同一用户下的浏览器会把它的 cookie 和证明密钥保存在该用户能读取的地方。两者合在一起就是一个完整的会话:持有它们的人可以做你在网页界面中能做的事,包括生成新令牌。要恢复,请生成新的中继令牌,用它登录,然后使用 Sign out all other browsers。仅仅更换令牌不会让任何浏览器退出登录。
- 读取只需 cookie 的内容。 浏览器按 id 或哈希自行加载的附件、生成的图片和已索引的媒体,仍然只凭 cookie 就能打开,无需证明密钥,因此主机其他端口上收到你的 cookie 的服务器可以获取它们。按路径打开的文件不在其中:它们需要证明密钥或文件授权。智能体令牌本来就能读取所有这些内容。
- 读取已配对中继的凭据,这些凭据由本中继保存在它的数据库中,还有它曾经为某个中继保存过的令牌,这个令牌可能残留在数据库的空闲页中。密钥只能打开那边的中继路由,在那个中继上使用 Revoke key 会让它作废。
- 找到令牌的旧副本,来自 0.9.27 之前:shell 历史记录、备份、复制出来的
config.,或者由旧版本的json oar copilot或手动--token启动的中继的看护进程命令行,直到那个中继被停止并重新启动一次。如果此前有智能体在这个中继上运行过,请在更新后生成新令牌。 - 停止中继。 同一用户的进程可以结束它,因此
oar命令在停止前的检查只是为了方便,而不是保护。
中继令牌本身仍然能打开一切,对任何持有它的人都是如此。