Skip to Content
👋 欢迎来到 HowToUseMoltbot 快速入门
工具Elevated 模式

Elevated 模式(/elevated 指令)

作用

  • /elevated on 在网关主机上运行并保留 exec 审批(同 /elevated ask)。
  • /elevated full 在网关主机上运行自动通过 exec(跳过 exec 审批)。
  • /elevated ask 在网关主机上运行但保留 exec 审批(同 /elevated on)。
  • on/ask 强制 exec.security=full;仍按配置的 security/ask 策略执行。
  • 仅当代理处于沙箱时改变行为(否则 exec 已在主机上运行)。
  • 指令形式:/elevated on|off|ask|full/elev on|off|ask|full
  • 仅接受 on|off|ask|full;其他值返回提示且不改变状态。

控制范围

  • 可用性门控tools.elevated 为全局基线;agents.list[].tools.elevated 可进一步按代理限制(均需允许)。
  • 每会话状态/elevated on|off|ask|full 设置当前会话键的 elevated 级别。
  • 行内指令:消息中的 /elevated on|ask|full 仅对该条消息生效。
  • 群组:在群聊中,仅当提及代理时才会处理 elevated 指令;绕过提及要求的纯指令消息视为已提及。
  • 主机执行:elevated 强制 exec 在网关主机执行;full 还会设置 security=full
  • 审批full 跳过 exec 审批;on/ask 在 allowlist/ask 规则要求时仍会走审批。
  • 非沙箱代理:对执行位置无影响;仅影响门控、日志和状态。
  • 工具策略仍适用:若工具策略拒绝 exec,则无法使用 elevated。
  • /exec 独立/exec 为授权发送方调整每会话默认值,不要求 elevated。

解析顺序

  1. 消息中的行内指令(仅对该条消息)。
  2. 发送仅含指令的消息所设的会话覆盖。
  3. 全局默认(配置中的 agents.defaults.elevatedDefault)。

设置会话默认

  • 发送仅含该指令的消息(可含空白),例如 /elevated full
  • 会收到确认回复(Elevated mode set to full... / Elevated mode disabled.)。
  • 若 elevated 被禁用或发送方不在批准白名单内,指令会返回可操作的错误且不改变会话状态。
  • 发送 /elevated(或 /elevated:)且无参数可查看当前 elevated 级别。

可用性与白名单

  • 功能门控:tools.elevated.enabled(默认可由配置关闭)。
  • 发送方白名单:tools.elevated.allowFrom,可按提供商设白名单(如 discordwhatsapp)。
  • 每代理门控:agents.list[].tools.elevated.enabled(可选;只能进一步限制)。
  • 每代理白名单:agents.list[].tools.elevated.allowFrom(可选;设置后发送方须同时满足全局与每代理白名单)。
  • Discord 回退:若未设置 tools.elevated.allowFrom.discord,则使用 channels.discord.dm.allowFrom。设置 tools.elevated.allowFrom.discord(可为 [])可覆盖。每代理白名单使用该回退。
  • 所有门控均需通过;否则 elevated 视为不可用。

日志与状态

  • Elevated 的 exec 调用以 info 级别记录。
  • 会话状态中包含 elevated 模式(如 elevated=askelevated=full)。
最后更新于: