> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 昇格モード

エージェントがサンドボックス内で実行される場合、その `exec` コマンドはサンドボックス環境に閉じ込められます。**昇格モード**では、構成可能な承認ゲートを使って、エージェントが代わりにサンドボックスを抜け出し、サンドボックス外でコマンドを実行できます。

<Info>
  昇格モードは、エージェントが**サンドボックス化**されている場合にのみ動作を変更します。サンドボックス化されていないエージェントでは、exec はすでにホスト上で実行されます。
</Info>

## ディレクティブ

スラッシュコマンドで、セッションごとに昇格モードを制御します。

| ディレクティブ          | 実行内容                                                         |
| ---------------- | ------------------------------------------------------------ |
| `/elevated on`   | 構成済みのホストパス上でサンドボックス外で実行し、承認を維持します                            |
| `/elevated ask`  | `on` と同じです (エイリアス)                                           |
| `/elevated full` | 構成済みのホストパス上でサンドボックス外で実行し、モード/ホストの承認ポリシーがすでに許容的な場合は承認をスキップします |
| `/elevated off`  | サンドボックスに閉じ込められた実行に戻します                                       |

`/elev on|off|ask|full` としても利用できます。

現在のレベルを確認するには、引数なしで `/elevated` を送信します。

## 仕組み

<Steps>
  <Step title="可用性を確認する">
    Elevated は構成で有効化されている必要があり、送信者は許可リストに含まれている必要があります。

    ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
    {
      tools: {
        elevated: {
          enabled: true,
          allowFrom: {
            discord: ["user-id-123"],
            whatsapp: ["+15555550123"],
          },
        },
      },
    }
    ```
  </Step>

  <Step title="レベルを設定する">
    セッションのデフォルトを設定するには、ディレクティブのみのメッセージを送信します。

    ```
    /elevated full
    ```

    またはインラインで使用します (そのメッセージにのみ適用されます)。

    ```
    /elevated on run the deployment script
    ```
  </Step>

  <Step title="コマンドはサンドボックス外で実行されます">
    昇格が有効な場合、`exec` 呼び出しはサンドボックスを離れます。有効なホストは
    デフォルトでは `gateway`、または構成済み/セッションの exec ターゲットが
    `node` の場合は `node` です。`full` モードでは、解決された exec の
    モード/ホスト承認ポリシーがすでに完全に許容的 (security `full`、
    ask `off`) な場合、exec 承認はスキップされます。それ以外の場合は、
    通常の承認ポリシーが引き続き適用されます。`on`/`ask` モードでは、
    構成済みの承認ルールが常に適用されます。
  </Step>
</Steps>

## 解決順序

1. メッセージ上の**インラインディレクティブ** (そのメッセージにのみ適用)
2. **セッションオーバーライド** (ディレクティブのみのメッセージを送信して設定)
3. **グローバルデフォルト** (構成内の `agents.defaults.elevatedDefault`)

## 可用性と許可リスト

* **グローバルゲート**: `tools.elevated.enabled` (`true` である必要があります)
* **送信者の許可リスト**: チャンネルごとのリストを持つ `tools.elevated.allowFrom`
* **エージェントごとのゲート**: `agents.list[].tools.elevated.enabled` (さらに制限することのみ可能。グローバルゲートとエージェントごとのゲートの両方が `true` である必要があります)
* **エージェントごとの許可リスト**: `agents.list[].tools.elevated.allowFrom` (送信者はグローバル + エージェントごとの両方に一致する必要があります)
* **チャンネル提供のフォールバック許可リスト**: チャンネル Plugin は、`tools.elevated.allowFrom.<provider>` が構成されていない場合に使用されるフォールバック許可リストを、SDK アダプターフックを通じて任意で提供できます。現在このフックを実装しているバンドル済みチャンネルはないため、実際には現時点で各プロバイダーに明示的な `tools.elevated.allowFrom.<provider>` エントリが必要です。
* **すべてのゲートを通過する必要があります**。そうでない場合、昇格は利用不可として扱われます

許可リストエントリの形式:

| プレフィックス                 | 一致対象                        |
| ----------------------- | --------------------------- |
| (なし)                    | 送信者 ID、E.164、または From フィールド |
| `name:`                 | 送信者の表示名                     |
| `username:`             | 送信者のユーザー名                   |
| `tag:`                  | 送信者タグ                       |
| `id:`, `from:`, `e164:` | 明示的な ID 指定                  |

## 昇格が制御しないもの

* **ツールポリシー**: `exec` がツールポリシーによって拒否されている場合、昇格でそれを上書きすることはできません。
* **ホスト選択ポリシー**: 昇格は `auto` を自由なクロスホストオーバーライドに変えるものではありません。構成済み/セッションの exec ターゲットルールを使用し、ターゲットがすでに `node` の場合にのみ `node` を選択します。
* **`/exec` とは別**: `/exec` ディレクティブは、承認済み送信者向けにセッションごとの exec デフォルト (host、security、ask、node) を調整するもので、昇格モードを必要としません。

<Note>
  bash チャットコマンド (`!` プレフィックス、`/bash` エイリアス) は別のゲートであり、独自の `tools.bash.enabled` フラグに加えて `tools.elevated` が有効化されている必要があります。昇格を無効化すると、`!` シェルコマンドもロックアウトされます。
</Note>

## 関連

<CardGroup cols={2}>
  <Card title="Exec ツール" href="/ja-JP/tools/exec" icon="terminal">
    エージェントからのシェルコマンド実行。
  </Card>

  <Card title="Exec 承認" href="/ja-JP/tools/exec-approvals" icon="shield">
    `exec` の承認と許可リストシステム。
  </Card>

  <Card title="サンドボックス化" href="/ja-JP/gateway/sandboxing" icon="box">
    Gateway レベルのサンドボックス構成。
  </Card>

  <Card title="サンドボックス vs ツールポリシー vs 昇格" href="/ja-JP/gateway/sandbox-vs-tool-policy-vs-elevated" icon="scale-balanced">
    ツール呼び出し中に 3 つのゲートがどのように合成されるか。
  </Card>
</CardGroup>