---
read_when:
    - コマンド権限に auto、ask、allowlist、full、deny を選択する
    - tools.exec.mode を通じた Codex Guardian レビュー済み承認の設定
    - OpenClaw exec 承認と ACPX ハーネス権限の比較
summary: ホスト実行、Codex Guardian 承認、ACPX ハーネスセッションの権限モード
title: 権限モード
x-i18n:
    generated_at: "2026-06-27T13:15:54Z"
    model: gpt-5.5
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: 6ce89cadb45b3b96ce9ab62b35c06610d02f0ff02f15ef7d2128c59fbebb325a
    source_path: tools/permission-modes.md
    workflow: 16
---

権限モードは、エージェントがホストコマンドを実行したり、ファイルを書き込んだり、backend harness に追加アクセスを求めたりする前に、どれだけの権限を持つかを決定します。OpenClaw にまず許可リストを使わせ、未一致の場合は Codex ネイティブ自動レビューまたは人間の承認ルートを使わせたい場合は、`tools.exec.mode: "auto"` から始めます。

<Note>
  権限モードは `tools.exec.host=auto` とは別です。`tools.exec.host`
  はコマンドをどこで実行するかを選びます。`tools.exec.mode` はホスト exec が
  どのように承認されるかを選びます。
</Note>

## 推奨デフォルト

すべての未一致を人間への確認にせず、有用なホストアクセスが必要なコーディングエージェントには `auto` を使います。

```bash
openclaw config set tools.exec.mode auto
openclaw approvals get
openclaw gateway restart
```

次に、有効なポリシーを確認します。

```bash
openclaw exec-policy show
```

`auto` モードでは、OpenClaw は決定的な許可リスト一致を直接実行します。承認の未一致はまず OpenClaw のネイティブ自動レビューに渡され、必要に応じて設定済みの人間の承認ルートへフォールバックします。

## OpenClaw ホスト exec モード

`tools.exec.mode` はホスト `exec` の正規化されたポリシーサーフェスです。

| モード      | 動作                                         | 使用する場合                                            |
| ----------- | -------------------------------------------- | ------------------------------------------------------- |
| `deny`      | ホスト exec をブロックします。               | ホストコマンドを一切許可しない場合。                    |
| `allowlist` | 許可リスト済みのコマンドのみを実行します。   | 既知で安全なコマンドセットがある場合。                  |
| `ask`       | 許可リスト一致を実行し、未一致では確認します。 | 人間が新しいコマンドをレビューすべき場合。              |
| `auto`      | 許可リスト一致を実行し、その後自動レビューを使います。 | コーディングセッションに実用的な保護付きアクセスが必要な場合。 |
| `full`      | プロンプトなしでホスト exec を実行します。   | この信頼済みホスト/セッションで承認ゲートをスキップすべき場合。 |

完全なホスト exec ポリシー、ローカル承認ファイル、許可リストスキーマ、安全なバイナリ、転送動作については、[Exec approvals](/ja-JP/tools/exec-approvals) を参照してください。

## Codex Guardian のマッピング

ネイティブ Codex app-server セッションでは、ローカル Codex 要件が許可する場合、`tools.exec.mode: "auto"` は Codex Guardian にレビューされる承認へマッピングされます。OpenClaw は通常、次を送信します。

| Codex フィールド    | 一般的な値        |
| ------------------- | ----------------- |
| `approvalPolicy`    | `on-request`      |
| `approvalsReviewer` | `auto_review`     |
| `sandbox`           | `workspace-write` |

`auto` モードでは、OpenClaw は `approvalPolicy: "never"` や `sandbox: "danger-full-access"` のような従来の安全でない Codex オーバーライドを保持しません。承認なしの姿勢を意図的に使いたい場合にのみ `tools.exec.mode: "full"` を使います。

app-server のセットアップ、認証順序、ネイティブ Codex ランタイムの詳細については、[Codex harness](/ja-JP/plugins/codex-harness) を参照してください。

## ACPX ハーネス権限

ACPX セッションは非対話型のため、TTY 権限プロンプトをクリックできません。ACPX は `plugins.entries.acpx.config` 配下の別個のハーネスレベル設定を使います。

| 設定                        | 一般的な値      | 意味                                      |
| --------------------------- | --------------- | ----------------------------------------- |
| `permissionMode`            | `approve-reads` | 読み取りのみを自動承認します。            |
| `permissionMode`            | `approve-all`   | 書き込みとシェルコマンドを自動承認します。 |
| `permissionMode`            | `deny-all`      | すべての権限プロンプトを拒否します。      |
| `nonInteractivePermissions` | `fail`          | プロンプトが必要になる場合は中止します。  |
| `nonInteractivePermissions` | `deny`          | プロンプトを拒否し、可能な場合は続行します。 |

ACPX 権限は OpenClaw exec 承認とは別に設定します。

```bash
openclaw config set plugins.entries.acpx.config.permissionMode approve-all
openclaw config set plugins.entries.acpx.config.nonInteractivePermissions fail
openclaw gateway restart
```

`approve-all` は、プロンプトなしのハーネスセッションに相当する ACPX の非常時用設定として使います。セットアップの詳細と失敗モードについては、[ACP agents setup](/ja-JP/tools/acp-agents-setup#permission-configuration) を参照してください。

## モードの選択

| 目的                                          | 設定                                                        |
| --------------------------------------------- | ----------------------------------------------------------- |
| ホストコマンドを完全にブロックする            | `tools.exec.mode: "deny"`                                   |
| 既知で安全なコマンドのみを実行させる          | `tools.exec.mode: "allowlist"`                              |
| すべての新しいコマンド形状について人間に確認する | `tools.exec.mode: "ask"`                                    |
| 人間の前に Codex/OpenClaw 自動レビューを使う  | `tools.exec.mode: "auto"`                                   |
| ホスト exec 承認を完全にスキップする          | `tools.exec.mode: "full"` と一致するホスト承認ファイル      |
| 非対話型 ACPX セッションで書き込み/exec を可能にする | `plugins.entries.acpx.config.permissionMode: "approve-all"` |

モード変更後もコマンドがプロンプトを表示する、または失敗する場合は、両方のレイヤーを確認します。

```bash
openclaw approvals get
openclaw exec-policy show
```

ホスト exec は OpenClaw 設定とホストローカル承認ファイルのうち、より厳しい結果を使います。ACPX ハーネス権限がホスト exec 承認を緩めることはなく、ホスト exec 承認が ACPX ハーネスプロンプトを緩めることもありません。

## 関連

- [Exec approvals](/ja-JP/tools/exec-approvals)
- [Exec approvals - advanced](/ja-JP/tools/exec-approvals-advanced)
- [Codex harness](/ja-JP/plugins/codex-harness)
- [ACP agents setup](/ja-JP/tools/acp-agents-setup#permission-configuration)