本页内容
本页内容
网关
1密码
OpenClaw 以四种独立方式与 1Password 配对:
- Config Secrets:
openclaw.json中的任何SecretRef字段在运行时都可以通过opCLI来解析,因此API密钥永远不会存在于配置文件中。 - 代理工作流程: 捆绑的
1password技能教代理登录并使用op读取或注入机密以完成自己的任务。 - 桌面环境: 官方 1Password MCP 服务器允许交互式桌面代理批准访问 1Password 环境。
- 浏览器登录:
claude-cli后端可以使用 Claude Code 的 Chrome 与 1Password for Claude 的集成,让代理无需登录网站即可登录网站密码曾经到达模型或 OpenClaw。
要求
- 1密码CLI(
op)安装在网关主机上。 - A 1无人值守插件路径的密码服务帐户。
- 对于直接技能工作流程,服务帐户、桌面应用程序集成或独立
op signin。
使用插件解决配置机密
启用捆绑插件并创建其服务帐户令牌文件。在首先运行此命令的 shell 中将服务帐户的令牌导出为 OP_SERVICE_ACCOUNT_TOKEN - 该块将该值写入磁盘,然后从环境中清除它,因此如果没有它,您将获得一个空令牌文件:
当设置 OPENCLAW_STATE_DIR 时,使用该目录而不是 ~/.openclaw。然后生成并应用 SecretRef 计划:
设置命令至少需要一个目标。在应用计划之前,状态可能会报告提供程序未配置,同时仍报告 prerequisites ready: yes;申请后,ready: yes 确认提供者、受信任的 op 可执行文件和接受的非空令牌文件均已准备好。
该插件接受本机 op://<vault>/<item>/<field> 和 op://<vault>/<item>/<section>/<field> 引用。它仅解析已注册的 OpenClaw 凭证目标,限制并行 op read 调用,并强制关闭桌面应用程序集成。有关手动配置、自定义目标和单独审核的代理工具,请参阅 插件指南。
适用于代理的 1password 技能
OpenClaw 捆绑了 1password 技能,该技能教导代理选择可用的身份验证模式、验证访问权限,并优先选择 op run 或 op inject 而不是将秘密值写入磁盘。
代理将其用于故意超出插件狭隘合同的工作流程,例如创建或旋转项目或将凭据注入一次性命令。当凭证已连接到 OpenClaw SecretRef 目标时,拥有的 OpenClaw 工作流程应解析它;代理无需直接呼叫op。
官方1密码MCP服务器
官方 MCP 服务器是 1Password Environments 的测试版桌面工作流程。它需要 1Password 桌面应用程序和每次交互的明确批准。它可以管理环境变量名称并通过内存中的 .env 文件将值挂载到本地进程中;秘密值不会返回到 MCP 客户端或模型。
它不提供对任意保管库项目的无头服务帐户访问,并且 OpenClaw 插件不会调用它。如果 MCP- 托管环境启动 OpenClaw 并已安装变量,请使用 OpenClaw 的 env SecretRefs 作为这些值。当网关本身应在启动或重新加载时解析 1Password 引用时,请使用该插件。
使用 Claude 的 1Password 浏览器登录
1Password for Claude 允许 Claude 请求登录,而 1Password 浏览器扩展则通过加密通道将凭据直接填充到页面中。该秘密永远不会进入模型上下文、转录本或 OpenClaw。当 OpenClaw 运行 claude-cli 后端 并启用 Claude Code 的 Chrome 集成时,代理任务可以将该流程用于需要真实登录会话的网站。
除了后端本身之外,这还需要什么:
- A macOS网关主机与Chrome, 这克劳德在Chrome扩大连接、1Password 桌面应用程序和 1Password 浏览器扩展(均8.12.28或稍后)。
- Claude Code 登录直接 Anthropic 计划(Pro、Max、Team 或 Enterprise)。 Chrome 集成不可通过 Amazon Bedrock、Google 云或其他第三方提供商提供。
- Anthropic 侧的一次性 1Password 连接:Claude 的 1Password 通过 Claude 桌面应用程序或 1Password 指南 中描述的扩展流程设置,目前是一个macOS 测试版。在 1Password Business 上,管理员必须首先在策略下启用“允许 AI 代理为用户自动填充”; Anthropic Team/Enterprise 计划也将集成关闭,直到所有者启用它。
- A CLI 后端插件,将
--chrome添加到 Claude 启动参数中;捆绑后端不启用 Chrome。 - A 网关主机上的人员:每个凭证使用都会显示在那里确认的 1Password 提示(例如使用 Touch ID)。在限制性执行策略下,浏览器工具调用自身也会首先以 OpenClaw 批准的方式转发到您的频道。
在将其连接到 OpenClaw 之前,请验证网关主机上交互式会话中的各个部分:运行 claude --chrome,确认扩展已连接,并检查 claude-in-chrome 工具是否包含凭证工具。如果它们没有出现在那里,它们也不会通过 OpenClaw 出现。
一次性密码由同一页面1Password填写;切勿通过聊天传递验证码或密码。无头或远程网关目前无法使用此流程,因为审批和浏览器都位于网关主机上。
安全说明
- 通过 exec 提供程序解析的秘密值保留在网关内存中;配置快照和
config.get响应编辑 SecretRef 字段。 - 插件解析器和代理强制
OP_LOAD_DESKTOP_APP_SETTINGS=false和OP_BIOMETRIC_UNLOCK_ENABLED=false,因此无人值守读取无法触发桌面批准或 macOS 权限对话框。 - 在传递服务帐户令牌之前,插件会解析
op可执行文件并拒绝其他本地帐户可写的路径或具有无法验证的 Windows ACL 或所有权的路径。绝对CLAW_1PASSWORD_OP覆盖也需接受相同的检查。 - A 解析器请求仅限于 32 个引用。读取一次运行四次,每次读取超时七秒;提供程序范围内的 90 秒超时涵盖了完全支持的批处理以及进程和权限检查开销。
- 切勿将秘密值放入
openclaw.json、日志或聊天中。将服务帐户的范围仅限于 OpenClaw 需要的保管库和项目。
故障排查
op丢失:在网关主机上安装 CLI,检查它是否在PATH上,或将CLAW_1PASSWORD_OP设置为其绝对路径。op不受信任:使用当前用户或 root 拥有的可执行文件,并从可执行文件及其父链中删除 group/other 写访问权限。- 身份验证失败:使用
openclaw onepassword status检查插件令牌文件、其内容以及服务帐户的保管库权限。 - A 引用被拒绝:当名称很长或包含不受支持的 1Password 引用字符时,显式包含保管库并使用稳定的保管库、项目、部分和字段 ID。
Homebrew 命令符号链接
如果手动执行提供程序报告 command must not be a symlink 为 /opt/homebrew/bin/op 或 /usr/local/bin/op,请使用 插件设置流程。手动执行提供程序需要非符号链接命令。将 Homebrew 链接解析为版本化的 Caskroom 路径仅在该版本保持安装状态时有效;稍后的软件包升级或清理可以将其删除。
该插件针对每个解析器请求从网关进程的 PATH 解析 op,然后在传递服务帐户令牌之前检查真正的可执行文件及其父目录。现有的 CLAW_1PASSWORD_OP 覆盖可以命名稳定的绝对 Homebrew 链路并接收相同的检查。该插件在升级后遵循替换链接,而不将其版本目标存储在 openclaw.json 中。组或其他可写可执行文件仍然会失败,就像让另一个用户替换已检查路径的父目录一样。
迁移之前,将每个现有凭据目标映射到其旧命令读取的确切 1Password 引用。手册提供者可以将该参考放在 args 中并使用不相关的 SecretRef id;将该 ID 复制到插件中将选择不同的秘密或失败。如果 onepassword 已经命名了手动提供程序,请使用 --provider-alias <alias> 选择未使用的提供程序别名:替换该提供程序也会更改使用其别名的未列出的引用。如上所示创建插件令牌文件,然后生成具有显式映射的计划,例如:
在使用上面的状态、空运行、应用、审核和重新加载命令之前,请检查计划的提供程序别名和每个目标。仅在所有对旧手册提供者的引用均已移动后才删除该提供者;在该检查中包括身份验证配置文件和通道凭据。