OpenClaw 白皮书
提升模式(/elevated 指令)
功能说明
- ✦
/elevated on在 Gateway 网关主机上运行并保留 exec 审批(与/elevated ask相同)。 - ✦
/elevated full在 Gateway 网关主机上运行并自动批准 exec(跳过 exec 审批)。 - ✦
/elevated ask在 Gateway 网关主机上运行但保留 exec 审批(与/elevated on相同)。 - ✦
on/ask不会强制exec.security=full;配置的安全/询问策略仍然适用。 - ✦仅在智能体被沙箱隔离时改变行为(否则 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 on|ask|full仅适用于该消息。 - ✦群组:在群聊中,仅当智能体被提及时才遵守提升指令。绕过提及要求的纯命令消息被视为已提及。
- ✦主机执行:elevated 强制
exec到 Gateway 网关主机;full还设置security=full。 - ✦审批:
full跳过 exec 审批;on/ask在允许列表/询问规则要求时遵守审批。 - ✦非沙箱隔离智能体:对位置无影响;仅影响门控、日志和状态。
- ✦工具策略仍然适用:如果
exec被工具策略拒绝,则无法使用 elevated。 - ✦与
/exec分开:/exec为授权发送者调整每会话默认值,不需要 elevated。
解析顺序
- ✦消息上的内联指令(仅适用于该消息)。
- ✦会话覆盖(通过发送仅含指令的消息设置)。
- ✦全局默认值(配置中的
agents.defaults.elevatedDefault)。
设置会话默认值
- ✦发送一条仅包含指令的消息(允许空白),例如
/elevated full。 - ✦发送确认回复(
Elevated mode set to full.../Elevated mode disabled.)。 - ✦如果 elevated 访问被禁用或发送者不在批准的允许列表中,指令会回复一个可操作的错误且不改变会话状态。
- ✦发送不带参数的
/elevated(或/elevated:)以查看当前的 elevated 级别。
可用性 + 允许列表
- ✦功能门控:
tools.elevated.enabled(即使代码支持,也可以通过配置将默认值设为关闭)。 - ✦发送者允许列表:
tools.elevated.allowFrom,带有每提供商允许列表(例如discord、whatsapp)。 - ✦每智能体门控:
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=ask、elevated=full)。