Supervise Codex sessions

Supervise Codex sessions 문서는 OpenClaw 공식 문서(plugins/codex-supervision)를 한국어로 정리한 가이드입니다. Browse non-archived native Codex sessions and paginated transcripts across OpenClaw nodes 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.

핵심 요약

Browse non-archived native Codex sessions and paginated transcripts across OpenClaw nodes

한국어 가이드 범위: plugins/codex-supervision 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

시작하기 전에
Enable supervision
Use the operator CLI
Branch from a local session
Archive a local session
Understand paired-node limits
Metadata and permissions
Compatibility tools
트러블슈팅
관련 문서

상세 내용

본문

Codex supervision is an opt-in capability of the official codex plugin. It shows non-archived Codex CLI, VS Code, Atlas, and ChatGPT source sessions from the Gateway computer and opted-in paired computers in the normal sessions sidebar and Chat pane.

주요 항목:

A stored or idle local session can create a model-locked OpenClaw Chat from
A stored session discovered from another Codex process has unknown live
An active source stays visible but cannot create a branch or be archived until
A session on a paired node exposes its persisted transcript through bounded,
Archived sessions are not listed. A stored or idle local session can be

시작하기 전에

macOS app can install it when you enable Codex features; CLI installations can run openclaw plugins install @openclaw/codex.

주요 항목:

Install the official @openclaw/codex plugin on the Gateway. The OpenClaw
Install and sign in to Codex Desktop or the Codex CLI on each computer whose
Pair remote computers as OpenClaw nodes. Each computer must opt in locally;
Use an owner-controlled Gateway. Session titles, working directories, and Git

Enable supervision

Guided openclaw onboard and macOS first-run setup attempt to install and enable Codex supervision after detecting a native Codex installation and successfully activating the selected inference backend. Codex does not need to be the primary backend. Supervision becomes available when that opportunistic plugin activation succeeds. App Server availability is checked when supervision first connects. An explicit Codex plugin disable or policy block prevents opportunistic activation, and an existing explicit supervision.enabled: false disables agent-facing supervision tools; the operator catalog remains registered whenever the Codex plugin is active unless sessionCatalog.enabled: false disables it. This separate switch leaves the Codex provider, harness, and agent-facing supervision policy unchanged while also removing the paired-node catalog list/read commands from this host. Existing installations can enable the same capability manually:

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          supervision: {
            enabled: true,
          },
        },
      },
    },
  },
}

openclaw nodes pending
openclaw nodes approve <requestId>

Use the operator CLI

The terminal CLI exposes the same non-archived catalog and Gateway-local branch and archive actions:

주요 항목:

--search <text> searches session titles case-insensitively.
--host <id> limits the response to one stable catalog host, such as
--limit <count> sets 1 through 100 rows per host; the default is 50.
--cursor <cursor> continues one host page and therefore requires --host.
--json prints the structured Gateway response.

openclaw codex sessions [--search <text>] [--host <id>] [--limit <count>] [--cursor <cursor>] [--json] [--url <url>] [--token <token>] [--timeout <ms>] [--expect-final]
openclaw codex continue <thread-id> [--json] [--url <url>] [--token <token>] [--timeout <ms>] [--expect-final]
openclaw codex archive <thread-id> --confirm-no-other-runner [--json] [--url <url>] [--token <token>] [--timeout <ms>] [--expect-final]

Branch from a local session

Choose Continue as branch on a stored or idle row from the Gateway computer. OpenClaw creates a normal Chat entry, mirrors bounded user and assistant history through the source's last terminal persisted turn (completed, interrupted, or failed), records a pending harness branch, and opens the Chat. The generic model picker is locked, but no concrete model or provider has been selected yet. The source is not resumed, and the canonical harness thread is not started yet. Repeating the action opens the existing Chat instead of creating another branch.

Archive a local session

Choose Archive on a stored or idle Gateway-local row, then confirm that no other Codex client or OpenClaw runner is using that thread or its spawned descendants. OpenClaw freshly reads the process-local status, proceeds only for idle or notLoaded, calls the native Codex archive operation, and removes the session from the non-archived list. Native Codex also attempts to archive the thread's spawned descendants.

codex unarchive <thread-id>

Understand paired-node limits

Paired nodes expose the versioned read-only codex.appServer.threads.list.v1 and codex.appServer.thread.turns.list.v1 commands. Native node hosts with the Codex CLI available also expose the allowlisted codex.terminal.resume.v1 command. The Gateway receives normalized metadata and explicitly requested bounded transcript pages, never raw App Server endpoints. Opening a row in the operator terminal runs codex resume on the owning host and relays that command's PTY; it does not expose a general shell or gateway-supplied argv.

Metadata and permissions

Catalog projection excludes transcript previews, turns, rollout paths, the Codex home path, Git remotes, commit SHAs, and raw App Server errors. Catalog access and Control UI transcript reads require the operator.write Gateway scope because fleet aggregation uses the standard node.invoke path, even though both node commands are read-only.

주요 항목:

thread and session identifiers
title and working directory
current status and active wait flags
created, updated, and activity timestamps
source, model provider, Codex CLI version, and Git branch

Compatibility tools

The official codex plugin retains the five shipped Supervisor tool names for existing agent and standalone MCP clients:

주요 항목:

codex_endpoint_probe
codex_sessions_list
codex_session_read
codex_session_send
codex_session_interrupt

트러블슈팅

plugin and supervision.enabled are true, the current plugin allowlist permits codex, and the sessions are not archived. Restart the Gateway or node after changing activation.

실습 체크리스트

공식 문서와 로컬 버전을 대조합니다: https://docs.openclaw.ai/plugins/codex-supervision
관련 CLI는 openclaw --help 및 하위 명령 --help로 옵션을 확인합니다.
설정 변경 시 openclaw config / openclaw doctor로 유효성을 검사합니다.
Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.

자주 쓰는 명령·설정 예시

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          supervision: {
            enabled: true,
          },
        },
      },
    },
  },
}

openclaw nodes pending
openclaw nodes approve <requestId>

openclaw codex sessions [--search <text>] [--host <id>] [--limit <count>] [--cursor <cursor>] [--json] [--url <url>] [--token <token>] [--timeout <ms>] [--expect-final]
openclaw codex continue <thread-id> [--json] [--url <url>] [--token <token>] [--timeout <ms>] [--expect-final]
openclaw codex archive <thread-id> --confirm-no-other-runner [--json] [--url <url>] [--token <token>] [--timeout <ms>] [--expect-final]

codex unarchive <thread-id>

Supervise Codex sessions

핵심 요약

Browse non-archived native Codex sessions and paginated transcripts across OpenClaw nodes

한국어 가이드 범위: plugins/codex-supervision 경로의 설정·명령·제약·예시를 학습용으로 재구성합니다.

문서 구성

공식 문서의 주요 섹션은 다음과 같습니다.

시작하기 전에
Enable supervision
Use the operator CLI
Branch from a local session
Archive a local session
Understand paired-node limits
Metadata and permissions
Compatibility tools
트러블슈팅
관련 문서

상세 내용

본문

주요 항목:

A stored or idle local session can create a model-locked OpenClaw Chat from
A stored session discovered from another Codex process has unknown live
An active source stays visible but cannot create a branch or be archived until
A session on a paired node exposes its persisted transcript through bounded,
Archived sessions are not listed. A stored or idle local session can be

시작하기 전에

macOS app can install it when you enable Codex features; CLI installations can run openclaw plugins install @openclaw/codex.

주요 항목:

Install the official @openclaw/codex plugin on the Gateway. The OpenClaw
Install and sign in to Codex Desktop or the Codex CLI on each computer whose
Pair remote computers as OpenClaw nodes. Each computer must opt in locally;
Use an owner-controlled Gateway. Session titles, working directories, and Git

Enable supervision

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          supervision: {
            enabled: true,
          },
        },
      },
    },
  },
}

openclaw nodes pending
openclaw nodes approve <requestId>

Use the operator CLI

The terminal CLI exposes the same non-archived catalog and Gateway-local branch and archive actions:

주요 항목:

--search <text> searches session titles case-insensitively.
--host <id> limits the response to one stable catalog host, such as
--limit <count> sets 1 through 100 rows per host; the default is 50.
--cursor <cursor> continues one host page and therefore requires --host.
--json prints the structured Gateway response.

openclaw codex sessions [--search <text>] [--host <id>] [--limit <count>] [--cursor <cursor>] [--json] [--url <url>] [--token <token>] [--timeout <ms>] [--expect-final]
openclaw codex continue <thread-id> [--json] [--url <url>] [--token <token>] [--timeout <ms>] [--expect-final]
openclaw codex archive <thread-id> --confirm-no-other-runner [--json] [--url <url>] [--token <token>] [--timeout <ms>] [--expect-final]

Branch from a local session

Archive a local session

codex unarchive <thread-id>

Understand paired-node limits

Metadata and permissions

주요 항목:

thread and session identifiers
title and working directory
current status and active wait flags
created, updated, and activity timestamps
source, model provider, Codex CLI version, and Git branch

Compatibility tools

The official codex plugin retains the five shipped Supervisor tool names for existing agent and standalone MCP clients:

주요 항목:

codex_endpoint_probe
codex_sessions_list
codex_session_read
codex_session_send
codex_session_interrupt

트러블슈팅

plugin and supervision.enabled are true, the current plugin allowlist permits codex, and the sessions are not archived. Restart the Gateway or node after changing activation.

실습 체크리스트

공식 문서와 로컬 버전을 대조합니다: https://docs.openclaw.ai/plugins/codex-supervision
관련 CLI는 openclaw --help 및 하위 명령 --help로 옵션을 확인합니다.
설정 변경 시 openclaw config / openclaw doctor로 유효성을 검사합니다.
Gateway·채널·플러그인 변경 후에는 필요 시 Gateway를 재시작합니다.

자주 쓰는 명령·설정 예시

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          supervision: {
            enabled: true,
          },
        },
      },
    },
  },
}

openclaw nodes pending
openclaw nodes approve <requestId>

openclaw codex sessions [--search <text>] [--host <id>] [--limit <count>] [--cursor <cursor>] [--json] [--url <url>] [--token <token>] [--timeout <ms>] [--expect-final]
openclaw codex continue <thread-id> [--json] [--url <url>] [--token <token>] [--timeout <ms>] [--expect-final]
openclaw codex archive <thread-id> --confirm-no-other-runner [--json] [--url <url>] [--token <token>] [--timeout <ms>] [--expect-final]

codex unarchive <thread-id>

Supervise Codex sessions

핵심 요약

문서 구성

상세 내용

본문

시작하기 전에

Enable supervision

Use the operator CLI

Branch from a local session

Archive a local session

Understand paired-node limits

Metadata and permissions

Compatibility tools

트러블슈팅

관련 문서

실습 체크리스트

자주 쓰는 명령·설정 예시

관련 링크

관련 가이드

Supervise Codex sessions

핵심 요약

문서 구성

상세 내용

본문

시작하기 전에

Enable supervision

Use the operator CLI

Branch from a local session

Archive a local session

Understand paired-node limits

Metadata and permissions

Compatibility tools

트러블슈팅

관련 문서

실습 체크리스트

자주 쓰는 명령·설정 예시

관련 링크

관련 가이드