将 1Password 连接到 Browser Use Cloud ,让你的智能体自动填写密码和 TOTP 验证码,以登录并完成网页任务。将凭据存储在专用保险库中,然后通过服务账号授予智能体访问权限。
在本简短教程中,我们将逐步指导你把 1Password 连接到 Browser Use 并实现登录自动化。
简要说明
- 为你的登录凭据创建一个保险库。
- 创建一个具有读取权限的服务账号。
- 使用其 token 连接到 Browser Use。
- 运行登录并验证已认证的页面。
什么是 1Password?
1Password 是一款密码管理器,用于存储登录信息和其他敏感信息。它将这些记录整理到保险库中,因此你可以将个人、共享和自动化凭据分开保存。
登录项保存账号的用户名、密码和网站。它还可以存储用于生成 基于时间的一次性密码(TOTP),即一些网站在你输入密码后要求提供的动态轮换验证码。
工作原理
Browser Use 通过 1Password 服务账号连接到你的密码库,这是为软件创建的身份。其 token 授予对你所选保险库和操作的访问权限。在这里,它可以读取一个保险库,并使用其中的凭据填写登录表单。
只读的保险库访问权限并不会限制已登录网站账号本身可以执行的操作。输入的凭据也仍然 可被页面和浏览器/CDP 工具访问.
使用服务账号连接进行 API 或仪表盘自动化,并预先设定保险库访问权限,正如我们在这里所做的。在仪表盘中选择 个人“Agentic Autofill”选项 当你想通过个人 1Password 账户批准登录访问权限时。
我们将使用 The Internet,这是一个带有登录表单和受保护页面的公开测试站点。它的共享用户名和密码让你无需使用私人账户即可测试连接。你可以在 的登录页面上看到这两者。.
创建保险库
首先创建一个保险库,其中只包含这些测试凭据。
在 1Password.com 上打开你的保险库,然后点击“VAULTS”旁边的“+”按钮。在“Create Vault”对话框中,输入 Browser Use Demo 在“Vault Name”字段中,然后点击“Create”。 保险库说明 还包括从“主页”页面或桌面应用创建一个。
在侧边栏中选择新建的保险库。点击“New Item”,选择“Login”,然后输入 The Internet 作为标题。填写以下值:
| 字段 | 值 |
|---|---|
| 用户名 | tomsmith |
| 密码 | SuperSecretPassword! |
| 网站 | https://the-internet.herokuapp.com/login |
检查底部的保险库选择器是否显示 Browser Use Demo,然后点击“Save”。
保持网站字段准确。在 V4 中,Browser Use 会从该条目已保存的网站中推导出凭据的允许输入主机。 允许输入的主机 从该条目已保存的网站中推导。缺少网站可能导致该条目在运行时不可用。每个允许的主机也涵盖其子域名;Browser Use 不会遵循 1Password 的精确域名自动填充设置。
创建服务账号
在 1Password 中,打开“Developer”>“Directory”,然后在“Access Tokens”下选择“Service Account”。 服务账号创建指南 还提供了创建向导的链接。
按如下方式配置:
- 输入
Browser Use Demo作为服务账号名称,以便你之后能在 1Password 中识别此连接,然后点击“Next”。 - 保持保险库创建功能处于禁用状态。该连接只需从你已创建的保险库中读取凭据即可。
- 选择“
Browser Use Demo包含你的测试登录信息的保险库。保持所有其他保险库未选中,以限制该账号的访问权限。 - 点击保险库旁边的权限图标。保持勾选“Read Items”,并让“Write Items”和“Share Items”保持未勾选。
- 点击“Next”,并保持环境未选中。查看所选保险库及其只读权限,然后点击“Create Account”。
token 出现时请保存好;向导只会显示一次。请将其存放在你授予智能体访问权限的那个保险库之外的保险库中。不要把它放进文章的示例文件或智能体的任务提示中。
服务账号的密码库访问权限和许可之后无法编辑。更改该范围需要新建一个服务账号。
连接 Browser Use
打开 Browser Use 中的 中的 1Password 设置 并确认已选择正确的项目。在“Service account”下,选择“Connect 1Password”。将 token 粘贴到“1Password Service Account Token”字段中并连接。
连接成功后,集成应显示为“Active”。如有需要,展开集成卡片,然后选择 Browser Use Demo “Vault Management”下,并确认 The Internet 出现。
请将这三个值区分开:
| 用途1Password 服务账号 token让集成访问其获准的保险库保险库 ID为一次运行选择保险库Browser Use API 密钥对发往 Browser Use 的请求进行身份验证该集成要求每个项目恰好有一个活跃的 1Password 连接,并且不适用于零数据保留项目。仪表板会为你处理 API 请求。只有当你使用下面的 API 示例时,才需要直接使用最后两个值。运行登录返回 Browser Use 任务编辑器。在“Run settin | 用途 |
|---|---|
| 1Password 服务账号 token | 让集成访问其获准的保险库 |
| 保险库 ID | 为一次运行选择保险库 |
| Browser Use API 密钥 | 对发往 Browser Use 的请求进行身份验证 |
该集成要求每个项目恰好有一个活跃的 1Password 连接,并且不适用于零数据保留项目。
仪表板会为你处理 API 请求。只有当你使用下面的 API 示例时,才需要直接使用最后两个值。
运行登录
返回 Browser Use 任务编辑器。在“Run settings”中,打开“Workspace”,选择“New workspace”,并将“Browser profile”保留为“No Profile”,以便进行干净的测试。打开“Credentials”,选择“Use a whole vault”,然后选择 Browser Use Demo。 1Password 集成指南 还记录了选择单个凭据字段的操作。
将此提示词粘贴到任务编辑器中,然后点击“运行任务”:
Open https://the-internet.herokuapp.com/login.
Sign in using the credentials from the connected The Internet
vault item. Use the credential-typing tools rather than copying
the example credentials printed on the page.
If the vault credentials are unavailable, stop and report that.
Verify the URL ends in /secure, the heading is Secure Area,
and a Logout link is visible. Report these checks and stop.
Do not include credential values in your response.观看运行过程并检查结果页面。点击“Login”只是一次尝试操作;通过认证后的页面才是有用的结果。对于此演示,请留意成功消息、“Secure Area”标题和“Logout”链接。
在我们的仪表板测试中,智能体输入了 the_internet_username ,并通过凭据工具完成。两者都针对预期来源返回了 和 。随后它到达了 并验证了“Secure Area”标题和可见的“Logout”链接。由于该演示会在页面上打印其凭据,仅凭登录成功并不能证明使用了保险库。还要检查运行中的凭据输入操作。服务账号的使用详情可以提供额外的访问证据。使用 API对于应用程序或计划任务,请使用 V4 REST 端点。下载 login.json 并替换 the_internet_password ,并通过凭据工具完成。两者都返回了 code: typed 和 ok: true ,并针对预期来源返回了该结果。随后它到达了 /secure 并验证了“Secure Area”标题和可见的“Logout”链接。
由于该演示会在页面上打印其凭据,仅凭登录成功并不能证明使用了保险库。还要检查运行中的凭据输入操作。服务账号的 使用详情 可以提供额外的访问证据。
使用 API
对于应用程序或计划任务,请使用 V4 REST 端点。下载 login.json 并替换 YOUR_VAULT_ID 替换为演示保险库的 ID。你可以在“Agents”页面生成的 REST 代码片段中的“1Password”部分获取该 ID。
该文件保留了上述完整提示词:使用凭据输入工具,如果保险库凭据不可用则停止,避免复制页面上打印的凭据,并在不报告凭据值的情况下验证全部三项页面检查。
通过你的环境提交,使用你连接 1Password 所在项目的密钥。在包含 的目录中,提交该文件: BROWSER_USE_API_KEY 通过你的环境,使用你连接 1Password 所在项目的密钥。在包含以下内容的目录中: login.json提交该文件:
curl --fail-with-body \
https://api.browser-use.com/api/v4/runs \
-H "X-Browser-Use-API-Key: $BROWSER_USE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @login.json响应中包含一个运行 ID。一个 queued 响应表示任务已被接受;这并不表示登录成功。设置 RUN_ID 该 ID,并检查 运行状态与结果:
curl --fail-with-body \
"https://api.browser-use.com/api/v4/runs/$RUN_ID" \
-H "X-Browser-Use-API-Key: $BROWSER_USE_API_KEY"再次检查,直到 status 是 completed, failed,或 cancelled阅读 result 以及任何 error,并将它们与上面的页面检查进行比较。一个 completed 运行仍需通过这些登录检查。请将示例保持在 V4 上;较旧的 V2 任务片段使用不同的请求结构。
故障排查
从连接向外推进:服务账号访问权限、保险库内容、目标地址,然后是浏览器操作。
| 症状 | 需要检查的内容 |
|---|---|
| 无法创建服务账号或选择保险库 | 检查你的 1Password 权限,以及该保险库是否允许服务账号访问。 |
| Token 已失效 | 检查它是否已过期、被撤销,或在未更新 Browser Use 的情况下被轮换。 |
一个项目会出现在 skippedVaultItems | 请为登录项添加一个有效的网站。标记为“从不自动填充”的网站不符合条件。 |
API 返回 422 | 阅读错误详情。所有凭据被跳过,或超过 20 个组合保险库字段和显式绑定,都可能导致拒绝。 |
| 无法在目标位置输入凭据 | 对照已保存的网站检查实际的登录主机名。对于显式 V4 绑定,请使用不带路径或通配符的裸主机名。 |
凭据域规则限制了密钥可以在哪些位置输入;它们并不是浏览器范围的导航限制。不要为了让错误消失而放宽这些规则。请先确认哪个站点应接收该凭据。
生产环境建议
为目标应用使用专用账户,并只授予完成任务所需的权限。将无关的登录信息排除在自动化保险库之外。整库选项会使该保险库中所有受支持的凭据字段都可供本次运行使用。
对于使用身份验证器代码的站点,Browser Use 可以使用存储在登录项上的 TOTP 字段。其他验证方式可能需要不同的工作流程。请先验证基本登录,然后再添加这些步骤。
轮换服务账号令牌时,请在旧令牌过期前更新 Browser Use 连接。当不再需要该集成时,请撤销访问权限。
你的第一个真实任务可以保持小规模:登录、打开一个只读页面,并报告一个可见的值。一旦凭据使用和结果都得到验证,就把该任务扩展到你真正想要自动化的工作上。
结论
现在你已经有了将 1Password 连接到 Browser Use 并检查需要身份验证的任务的设置路径。请将保险库限制为自动化所需的登录信息,验证智能体确实使用了这些凭据,并先在一个小型可运行任务的基础上构建,然后再扩大其范围。
来源与延伸阅读:
- Browser Use:1Password 与 2FA 涵盖集成、TOTP 验证码和凭据设置。
- 1Password:服务账号入门 介绍账户创建、保险库访问和令牌处理。
- 1Password:使用一次性密码 展示了如何将身份验证器代码添加到登录项。
- 1Password:管理服务账号 涵盖使用报告、令牌轮换和撤销访问权限。
发布于 2026 年 11 月 9 日
继续阅读
所有文章
综合报道
/2026年11月6日AI 智能体最佳代理服务商(2026)
比较七家住宅代理服务商在浏览器自动化和 AI 智能体方面的表现,包含实操任务测试、入门价格以及粘性会话的取舍。
Nik Tomazic

解读
/2026年11月5日计算机使用 vs 浏览器使用:AI 智能体应如何控制软件
计算机使用智能体读取截图并点击整个桌面上的像素。浏览器使用智能体则通过页面和 CDP 驱动真实浏览器。两者的区别,以及何时选择哪一种。
Gregor Zunic

对比
/2026年11月3日Browser Use 与 Kernel:定价、隐身性与性能对比
Browser Use 与 Kernel 对比:定价、代理、隐身性、性能与会话管理,助你为自动化选择合适的浏览器基础设施。
Nik Tomazic