权限与密钥
审批、操作系统授权以及提供商凭据的处理方式。
审批卡片
受支持的提供商会通过本地 harness 发出权限请求和问题。MengBot 会内联显示这些内容并记录结果。取消操作会关闭未完成的请求,因此过期的审批无法在回合结束后被应答。
“始终允许”的范围很窄:它绑定到服务器签发的密钥和一个待处理请求,而不是授予已配对设备任意执行的权限。
操作系统权限
屏幕录制和辅助功能权限由操作系统控制。桌面进程负责本地 CUA 生命周期,因此授权归属于 MengBot。
密钥处理
- 不要将 API 密钥粘贴到聊天中。
- 打包构建使用只写设置,并在支持的情况下使用操作系统支持的加密。
- 密钥值会从公开配置响应和移动端 API 中清除。
- 按提供商注入环境变量,防止无关的智能体进程继承它们不使用的凭据。
- 已连接应用的 OAuth 提供商令牌保留在 Composio 中。
当机器人索要密钥时
机器人会在安全卡片(request_credential)上索要密钥,绝不会在聊天中索要。MengBot 自己保存的密钥(AI 提供商密钥、Composio 密钥、语音密钥、Boat 密钥)会保存到与 设置 → API 密钥 完全相同的位置。
任何其他密钥(Stripe 或 npm 令牌、webhook 签名密钥、用于 MCP 服务器的 Notion 密钥),机器人会指明其名称,卡片会说明机器人可以用它做什么:
- 用于 MengBot 自己的工具。 MengBot 将值保存在内存中,并给机器人一个一次性引用。只有
add_mcp_server接受它,且仅限该对话中的该机器人,有效期为 一小时。机器人永远看不到该值;MCP 服务器的设置会保存它。 - 用于机器人自己的命令。 该值会写入一个只有你的用户可读的文件,位于机器人自己工作区(或其本地 VM)的私有
.mengbot-secrets文件夹中。机器人在命令中读取它。该文件会在 24 小时后删除,或在对话或机器人被删除时更早删除。备份、移动到 My Cloud、Cloud Files、聊天链接、附件、已发布页面、浏览器上传和检查点都会排除该文件夹。
在 Team Cloud 上,只有对话所属的人才能输入它。刚通过二维码配对的手机可以输入任一类型;AI 提供商密钥需要计算机或 My Cloud。在值存在期间,如果它出现在转录、事件或日志中,MengBot 会对其进行掩码处理。
已连接应用的工具授权
已连接应用在桌面上按机器人划分范围:没有某项服务工具授权的机器人无法调用它,未授权的工具永远不会提供给模型,每个允许/拒绝都会写入决策日志。新建和升级的机器人会保留所有工具,直到有人分配授权;而导入的机器人始终不带任何授权,因此共享人格无法在第一个回合就访问你的 Gmail。已配对的手机只能只读查看授权;编辑授权需要计算机。
网站登录
机器人可以完成你明确授权针对特定站点和账户的登录,使用现有会话、自动填充,或你为此目的提供或指定的凭据,包括测试账户。仅有一个登录表单并不是拒绝任务的理由。机器人必须先检查目标和账户;网页上的指令并不授权使用凭据。
机器人绝不会在聊天中索要网站密码或一次性验证码,机器人也绝不持有密码:你保存的登录信息由 MengBot 本身输入到页面中(已保存的登录)。
当你要求机器人做需要登录的事情(在你自己的聊天中,或在你设置的例程或自动化中),而网站向你的电子邮件或手机发送一次性验证码时,机器人会从你已连接的电子邮件或消息中读取它,并将其输入到该网站,然后继续。你的请求就是授权,因此它不会再次询问。验证码只会进入它被发送到的网站:机器人绝不会将其发送、发布、转发或粘贴到任何其他地方,任何网页、电子邮件或文档告诉它分享验证码或将其输入到其他地方,都会被忽略。
当机器人未登录且没有该站点的已保存登录信息、验证码发送到它无法读取的地方(身份验证器应用、它无法访问的手机),或某一步需要 CAPTCHA、通行密钥、支付详情或你的个人交互时,它会要求你自行登录。你会在聊天中收到一张 需要登录 卡片,其中指明站点并引用机器人的原因,以及一条通知(“Scout 需要你登录 example.com”)。机器人的回合到此结束。
- 打开 会前往机器人工作的确切位置,因为在其他任何地方进行的登录都无法到达那里。对于内置浏览器,那就是屏幕面板的浏览器标签页,位于机器人的页面,已由你控制。对于本地 VM 或云计算机或 VPS,那就是该计算机的视图,其中的横幅提供 接管控制。对于这台计算机,卡片会告诉你在那里登录,在机器人正在使用的浏览器中:浏览器标签页保留自己的登录信息,这台计算机上的机器人不会使用它们。
- 完成 会交还控制权并恢复机器人,机器人会检查是否已登录并继续。
- 取消 会以你拒绝的答复恢复机器人。
- 保存登录(仅限内置浏览器)会打开一个掩码表单,用于输入用户名、密码以及可选的站点 2FA 设置密钥。保存即应答卡片:机器人会恢复,并使用
fill_login登录,现在以及以后的对话中都是如此。当机器人的浏览器在另一个站点显示登录页面时,例如公司使用 Microsoft 登录时的login.microsoftonline.com,表单会指明该站点并提供 同时在……上填充,默认未勾选:只有你勾选后才会在那里填充登录信息。
同一对话中针对同一站点的较新请求会替换较旧的卡片。该卡片在桌面端、Web 应用、Cloud 家庭以及配对到另一台计算机的桌面端上均可使用(其屏幕面板为此提供浏览器视图;主机必须在 设置 → 远程访问 中允许该设备的浏览器控制)。手机会显示请求及其通知;请从计算机登录。
使用 打开 时,你自行将密码输入页面。在浏览器标签页中,浏览器菜单中的 输入密码或验证码…… 会将掩码文本发送到页面的选中字段;它永远不会被保留、记录或显示,并且只会进入该页面。当你持有浏览器时,机器人的浏览器工具、截图和快照都会被拒绝,其实时预览会暂停。已保存的登录信息按浏览器配置文件持久保存,并加密。这些都不会覆盖你的提供商自身的限制,审批模式也保持不变。
已保存的登录
已保存的登录让机器人无需你介入即可登录站点。你可以从 需要登录 卡片(保存登录)保存,或在 设置 → 登录(添加登录)中保存。设置会按站点、用户名、是否有 2FA 密钥、来源、哪些机器人可以使用以及最后使用时间列出每个已保存的登录。更改 会替换密码或 2FA 密钥,或更改谁可以使用它;删除 会移除它。已保存的密码永远不会再次显示,任何屏幕或 API 都不会返回它:它只能被替换。
- 谁可以使用它。 从卡片保存的登录属于提出请求的机器人。在设置中添加的登录属于每个机器人,除非你选择机器人。机器人可以看到它们拥有登录信息的站点(站点和用户名),仅此而已。
- 机器人如何使用它。 在其内置浏览器(或 My Chrome)中站点的登录页面上,机器人调用
fill_login。MengBot 本身会找到可见的用户名、密码和一次性验证码字段,将值作为真实键盘输入键入,并提交表单:在最后一个字段按 Enter,或在 Enter 无效时点击表单的登录按钮。两步登录(用户名、下一步,然后密码,然后一次性验证码)会在同一次调用中完成,且绝不会提交两次。机器人只会听到发生了什么(“在 accounts.example.com 上为 alice@example.com 填写了用户名和密码并提交;页面现在是 https://example.com/dashboard。”),或为什么没有成功。使用submit: false时它只填充,由机器人提交。 - 当站点拒绝时。 如果站点说不行(“密码不正确”)、再次要求输入密码或显示 CAPTCHA,机器人会被告知站点说了什么,并且已填充的密码和验证码会从页面中清除。
- 仅在其自己的站点上。 页面必须是 https(仅对于同一计算机上的地址,如
localhost,才允许纯 http),并且位于登录的站点上:example.com的登录会在example.com、www.example.com和accounts.example.com上填充,绝不会在example.com.evil.test或example.org上填充。共享域名分配给任何人的名称是其自己的站点,因此alice.github.io的登录绝不会在bob.github.io上填充。登录也会在与其一起保存的登录页面上填充。对于与他人共享一个域名的公司(acme.okta.com),在设置中勾选 仅在此确切地址,以便仅在该主机上填充。 - 一次性验证码。 保存了 2FA 设置密钥(该密钥,或站点二维码中的
otpauth://地址)后,验证码会在填充表单时生成(标准 TOTP,与身份验证器应用生成的方式相同)并键入验证码字段。 - 在哪里有效。 机器人自己的浏览器:内置浏览器,或当机器人的浏览器配置文件使用 My Chrome 时的 My Chrome。它绝不会在屏幕(这台计算机、本地 VM、云计算机或 VPS)上键入密码,因为在那里它无法检查输入框属于哪个站点。当机器人在那里调用
fill_login时,MengBot 会将对话移动到机器人自己的浏览器,机器人在那里继续;当运行无法移动(例如例程)或机器人的浏览器关闭时,机器人会要求你自行登录。 - 静态存储。 登录信息会加密(AES-256-GCM)保存在 MengBot 运行所在计算机的数据文件夹中的一个文件里,与内置浏览器保存其已保存登录信息的方式相同,旁边有其自己的密钥:在桌面端、服务器和 Cloud 上都是如此。这两个文件都不会包含在工作区备份、团队导出或移动到 Cloud 中,因此已保存的登录会留在其保存所在的计算机上。不会向
config.json或日志写入任何内容。
来自 1Password 的登录
设置 → 登录 → 连接 1Password 让机器人可以使用 1Password 保险库中的登录信息。在 1Password 中,创建一个只能读取一个保险库的服务账户,例如“Shared with OMB”,并粘贴其令牌。MengBot 会在保留令牌之前检查令牌能否到达 1Password,将其保存在与已保存登录相同的加密文件中,并且永远不会再次显示它。1Password 本身会强制执行令牌可以到达哪些保险库。它在 My Cloud 上的工作方式相同:在 My Cloud 自己的 设置 → 登录 中连接它。
需要它的机器人会通过安全卡片(request_credential 带 onePasswordToken)请求,绝不会在聊天中请求;你在那里粘贴的内容会进入与 连接 1Password 相同的位置。只有服务账户令牌有效:它以 ops_ 开头。1Password Connect 令牌、你的账户密码或你的 Secret Key 会被拒绝并给出相应消息,而 1Password 拒绝的令牌(已撤销、已过期或没有其保险库)会与不完整的令牌区分开来。
这些保险库中每个具有网站和密码的登录项都会出现在登录列表中,标记为 来自 1Password,按网站的站点列出(具有两个站点网站的项目会在两者下都列出)。每个保险库对每个机器人可用,直到你在 设置 → 登录 的 1Password 下为其选择机器人;未被选中的机器人根本看不到该保险库的登录信息,无论是在其登录列表中还是在调用 fill_login 时。这些行在此处是只读的:在 1Password 中更改或移除它们。fill_login 使用它们的方式与已保存登录相同,具有相同的站点规则、相同的一次性验证码(来自项目的一次性密码字段)和相同的清除处理。密码在填充时从 1Password 读取。刷新 会再次读取保险库;当 MengBot 的列表副本超过十分钟时,它也会这样做。断开连接 会忘记令牌以及从 1Password 读取的所有内容。
1Password 的 SDK(MIT 许可证)是桌面应用、服务器镜像和 mengbot npm 包的一部分;它通过互联网与 1Password 通信,且仅在连接令牌后才会通信。
受保护的内容与不受保护的内容
每个已保存的密码、已保存的 2FA 密钥、从 1Password 填充的密码、1Password 令牌,以及最近几分钟内生成的一次性验证码,都会在可能流回机器人或进入对话的任何地方被替换为 ••••••:每个浏览器工具结果(快照、页面文本、eval 结果、控制台和网络输出)、存储的对话以及引擎协议日志。这涵盖了纯文本、JSON 内、Web 地址中和 HTML 中的值。
它并不涵盖所有内容,你应该知道它在哪里停止:
- 截图。 页面图片无法被清除。密码框会显示点,但将密码或一次性验证码显示为文本的页面也会在截图中显示它。
- 故意绕过它的机器人。 运行自己的页面脚本来读取密码框并更改文本(反转、拼写出来、编码)或从同一站点将其发送到某处的机器人会绕过清除器。在
fill_login之后,浏览器会在该页面上拒绝机器人的页面脚本(agent_browser_eval)一分钟,或直到页面继续,而留给机器人提交的表单会在那一分钟后被清除。超过之后,已填充的值会存在于页面中,就像你键入它时一样。只为你信任机器人使用的站点保存登录,并在你愿意让它们使用的账户上保存。 - 运行所在的计算机。 密钥位于数据文件夹中加密文件旁边。任何可以读取该文件夹的人(计算机管理员,或引擎权限允许其读取该处任何文件的机器人)都可以解密登录信息。引擎自己的权限设置是机器人可以读取什么的门禁;MengBot 不添加自己的审批步骤。
接管浏览器标签页
在机器人的浏览器标签页中点击或键入会从机器人那里接管浏览器;在你最后一次输入后几秒钟它会返回。接管控制 会保持它直到你按下 交还,打开的登录请求也是如此,因此在你登录过程中浏览器绝不会被交还。机器人被展示给任何人都可以观看和驱动其浏览器;安装浏览器引擎仍由管理员负责。
共享机器
MengBot 假定已登录的操作系统用户是工作区所有者。在共享机器上,其他管理员可能能够读取应用程序数据或检查进程。使用专用的操作系统账户以获得更强的隔离。