概述
Elevated 模式允许沙箱内的 Agent 突破沙箱限制，在宿主机（gateway 或 node）上执行命令。仅对沙箱 Agent 有效，非沙箱 Agent 的 exec 本就在宿主机运行。
核心功能
- 四种级别：
/elevated on//elevated ask：在宿主机执行，保留审批门控/elevated full：在宿主机执行，跳过审批（break-glass）/elevated off：返回沙箱限制执行
- 作用域：
- 内联指令（仅当前消息生效）
- 会话覆盖（发送独立指令消息，持续整个会话）
- 全局默认（
agents.defaults.elevatedDefault配置）
- 解析优先级：内联指令 > 会话覆盖 > 全局默认
- bash 聊天命令（
!前缀）：需要tools.elevated.enabled=true才能使用
配置/权限
启用配置：
{
tools: {
elevated: {
enabled: true,
allowFrom: {
discord: ["user-id-123"],
whatsapp: ["+15555550123"]
}
}
}
}多层门控（所有门控必须通过）：
tools.elevated.enabled：全局开关tools.elevated.allowFrom：发送者白名单（per-channel）agents.list[].tools.elevated.enabled：per-agent 开关（只能进一步限制）agents.list[].tools.elevated.allowFrom：per-agent 发送者白名单
白名单条目格式：
| 前缀 | 匹配方式 |
|---|---|
| 无前缀 | Sender ID、E.164 或 From 字段 |
name: | 显示名 |
username: | 用户名 |
tag: | 标签 |
不受 Elevated 控制的内容：
- 工具策略（
exec被 deny 时 elevated 无法覆盖） - 宿主机选择策略（不会将
auto变为跨主机覆盖）
相关页面
- tool-exec — exec 工具本体
- tool-exec-approvals — exec 审批与白名单系统