OpenClaw从入门到应用——工具（Tools）：

通过OpenClaw实现副业收入：《OpenClaw赚钱实录：从“养龙虾“到可持续变现的实践指南》

提升模式（/elevated 指令）

功能说明

• /elevated on在网关主机上运行，并保留执行审批（与/elevated ask相同）。
• /elevated full在网关主机上运行，并自动批准执行（跳过执行审批）。
• /elevated ask在网关主机上运行，但保留执行审批（与/elevated on相同）。
• on/ask不会强制设置exec.security=full；配置的安全/询问策略仍然适用。
• 仅当代理处于沙盒模式时才会改变行为（否则执行原本就在主机上运行）。
• 指令形式：/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仅适用于该条消息。
• 群组：在群聊中，仅在提及代理时提升指令才会被响应。绕过提及要求的纯指令消息被视为已提及。
• 主机执行：提升模式强制exec在网关主机上运行；full还会设置security=full。
• 审批：full跳过执行审批；当白名单/询问规则有要求时，on/ask会遵循这些审批。
• 非沙盒代理：对执行位置无影响；仅影响开关控制、日志记录和状态。
• 工具策略依然适用：如果工具策略拒绝了exec，则无法使用提升模式。
• 独立于/exec：/exec为授权发送者调整会话默认值，且不需要提升模式。

解析顺序

1. 消息上的内联指令（仅适用于该条消息）。
2. 会话覆盖（通过发送纯指令消息设置）。
3. 全局默认值（配置中的agents.defaults.elevatedDefault）。

设置会话默认值

• 发送一条只包含指令的消息（允许有空白字符），例如/elevated full。
• 系统会发送确认回复（提升模式已设置为 full.../提升模式已禁用。）。
• 如果提升访问被禁用，或发送者不在已批准的白名单中，指令将回复一个可操作的错误，并且不会更改会话状态。
• 发送不带参数的/elevated（或/elevated:）以查看当前的提升级别。

可用性与白名单

• 功能开关：tools.elevated.enabled（即使代码支持，也可以默认通过配置将其关闭）。
• 发送者白名单：tools.elevated.allowFrom，其中包含针对不同提供商的白名单（例如discord、whatsapp）。
• 不带前缀的白名单条目仅匹配发送者范围内的身份值（SenderId、SenderE164、From）；接收者路由字段绝不会用于提升授权。
• 可变的发送者元数据需要使用显式前缀：
  • name:<value>匹配SenderName
  • username:<value>匹配SenderUsername
  • tag:<value>匹配SenderTag
  • id:<value>、from:<value>、e164:<value>可用于显式的身份定位
• 单个代理开关：agents.list[].tools.elevated.enabled（可选；只能进一步限制）。
• 单个代理白名单：agents.list[].tools.elevated.allowFrom（可选；设置后，发送者必须同时匹配全局和单个代理的白名单）。
• Discord 回退：如果省略了tools.elevated.allowFrom.discord，则使用channels.discord.allowFrom列表作为回退（旧版：channels.discord.dm.allowFrom）。设置tools.elevated.allowFrom.discord（即使为[]）可覆盖此行为。单个代理白名单不会使用此回退。
• 所有开关都必须通过；否则提升模式被视为不可用。

日志记录与状态

• 提升的执行调用记录在信息级别。
• 会话状态包含提升模式（例如elevated=ask、elevated=full）。