---
read_when:
- 调整提升权限模式的默认设置、允许列表或斜杠命令行为
- 了解沙箱隔离的智能体如何访问主机
summary: 提升权限的 Exec 模式：从沙箱隔离的智能体中在沙箱外运行命令
title: 提升权限模式
x-i18n:
generated_at: "2026-07-11T20:59:10Z"
model: gpt-5.6
postprocess_version: locale-links-v1
provider: openai
source_hash: ab035f2f0d0074da4e7661d9d690d89aa5eea25b7920ce48a2a03dffccded85b
source_path: tools/elevated.md
workflow: 16
---
当智能体在沙箱内运行时，其 `exec` 命令会被限制在沙箱环境中。**提升权限模式**允许智能体突破这一限制，改为在沙箱外运行命令，并可配置审批关卡。
提升权限模式仅在智能体处于**沙箱隔离**状态时才会改变行为。对于未进行沙箱隔离的智能体，exec 已经在主机上运行。
## 指令
使用斜杠命令按会话控制提升权限模式：
| 指令 | 作用 |
| ---------------- | ------------------------------------------------------------------------------------------------------------------ |
| `/elevated on` | 在配置的主机路径上于沙箱外运行，同时保留审批 |
| `/elevated ask` | 与 `on` 相同（别名） |
| `/elevated full` | 在配置的主机路径上于沙箱外运行；当模式/主机审批策略已允许全部操作时，跳过审批 |
| `/elevated off` | 恢复为仅限沙箱内执行 |
也可使用 `/elev on|off|ask|full`。
发送不带参数的 `/elevated` 可查看当前级别。
## 工作原理
必须在配置中启用提升权限模式，并且发送者必须在允许列表中：
```json5
{
tools: {
elevated: {
enabled: true,
allowFrom: {
discord: ["user-id-123"],
whatsapp: ["+15555550123"],
},
},
},
}
```
发送仅包含指令的消息，以设置会话默认值：
```
/elevated full
```
也可以内联使用（仅适用于该消息）：
```
/elevated on run the deployment script
```
启用提升权限后，`exec` 调用会离开沙箱。有效主机默认为
`gateway`；当配置的或会话的 exec 目标为 `node` 时，则为
`node`。在 `full` 模式下，如果解析后的 exec 模式/主机审批策略
已经完全宽松（security 为 `full`、ask 为 `off`），则会跳过 exec
审批；否则仍会应用常规审批策略。在 `on`/`ask` 模式下，始终应用
已配置的审批规则。
## 解析顺序
1. 消息中的**内联指令**（仅适用于该消息）
2. **会话覆盖设置**（通过发送仅包含指令的消息进行设置）
3. **全局默认值**（配置中的 `agents.defaults.elevatedDefault`）
## 可用性和允许列表
- **全局关卡**：`tools.elevated.enabled`（必须为 `true`）
- **发送者允许列表**：`tools.elevated.allowFrom`，包含各渠道的列表
- **按智能体配置的关卡**：`agents.list[].tools.elevated.enabled`（只能进一步限制；全局关卡和按智能体配置的关卡都必须为 `true`）
- **按智能体配置的允许列表**：`agents.list[].tools.elevated.allowFrom`（发送者必须同时匹配全局和按智能体配置的允许列表）
- **渠道提供的后备允许列表**：当未配置 `tools.elevated.allowFrom.` 时，渠道插件可以选择通过 SDK 适配器钩子提供后备允许列表。目前没有内置渠道实现此钩子，因此实际上当前每个提供商都需要显式设置 `tools.elevated.allowFrom.` 条目。
- **所有关卡都必须通过**；否则提升权限模式将被视为不可用
允许列表条目格式：
| 前缀 | 匹配对象 |
| ----------------------- | ------------------------------ |
| （无） | 发送者 ID、E.164 或 From 字段 |
| `name:` | 发送者显示名称 |
| `username:` | 发送者用户名 |
| `tag:` | 发送者标签 |
| `id:`、`from:`、`e164:` | 显式指定身份 |
## 提升权限模式不控制的内容
- **工具策略**：如果工具策略禁止 `exec`，提升权限模式无法覆盖该限制。
- **主机选择策略**：提升权限模式不会将 `auto` 变成可随意跨主机覆盖的选项。它使用配置的或会话的 exec 目标规则，仅当目标已经是 `node` 时才选择 `node`。
- **与 `/exec` 相互独立**：`/exec` 指令为已授权的发送者调整按会话配置的 exec 默认值（主机、安全性、询问方式、节点），且不要求启用提升权限模式。
bash 聊天命令（`!` 前缀；`/bash` 别名）使用独立关卡，除其自身的 `tools.bash.enabled` 标志外，还要求启用 `tools.elevated`。禁用提升权限模式也会阻止 `!` shell 命令。
## 相关内容
由智能体执行 shell 命令。
`exec` 的审批和允许列表系统。
Gateway 网关级沙箱配置。
三个关卡在工具调用期间的组合方式。