​

ACP agent

​

어떤 페이지를 봐야 하나요?

​

별도 설정 없이 바로 동작하나요?

• 새 설치에는 이제 번들 acpx 런타임 플러그인이 기본으로 활성화되어 포함됩니다.
• 번들 acpx 플러그인은 플러그인 로컬에 고정된 acpx 바이너리를 우선 사용합니다.
• 시작 시 OpenClaw는 해당 바이너리를 점검하고 필요하면 자체 복구합니다.
• 빠른 준비 상태 점검이 필요하면 /acp doctor부터 시작하세요.

• 대상 harness adapter는 해당 harness를 처음 사용할 때 npx로 필요 시 가져올 수 있습니다.
• 해당 harness에 대한 vendor auth는 여전히 호스트에 존재해야 합니다.
• 호스트에 npm/네트워크 접근이 없으면 캐시를 미리 준비하거나 다른 방식으로 adapter를 설치하기 전까지 첫 실행 adapter 가져오기가 실패할 수 있습니다.

• /acp spawn codex: OpenClaw는 acpx를 부트스트랩할 준비가 되어 있어야 하지만, Codex ACP adapter는 여전히 첫 실행 시 가져오기가 필요할 수 있습니다.
• /acp spawn claude: Claude ACP adapter도 동일하며, 추가로 해당 호스트에 Claude 측 auth가 필요합니다.

​

빠른 운영자 흐름

1. 세션 spawn:
   • /acp spawn codex --bind here
   • /acp spawn codex --mode persistent --thread auto
2. 바인딩된 conversation 또는 thread에서 작업합니다(또는 해당 session key를 명시적으로 지정).
3. 런타임 상태 확인:
   • /acp status
4. 필요에 따라 런타임 옵션 조정:
   • /acp model <provider/model>
   • /acp permissions <profile>
   • /acp timeout <seconds>
5. 컨텍스트를 교체하지 않고 활성 세션을 조정:
   • /acp steer tighten logging and continue
6. 작업 중지:
   • /acp cancel (현재 turn 중지), 또는
   • /acp close (세션 종료 + 바인딩 제거)

​

사람을 위한 빠른 시작

• “이 Discord 채널을 Codex에 바인딩해.”
• “여기 스레드에서 지속적인 Codex 세션을 시작하고 집중 상태를 유지해.”
• “이 작업을 일회성 Claude Code ACP 세션으로 실행하고 결과를 요약해.”
• “이 iMessage 채팅을 Codex에 바인딩하고 후속 작업도 같은 workspace에서 계속해.”
• “이 작업에 Gemini CLI를 스레드에서 사용하고, 후속 작업도 같은 스레드에서 계속해.”

1. runtime: "acp"를 선택합니다.
2. 요청된 harness 대상(agentId, 예: codex)을 resolve합니다.
3. 현재 conversation 바인딩이 요청되었고 활성 채널이 이를 지원하면, ACP 세션을 해당 conversation에 바인딩합니다.
4. 그렇지 않고 thread 바인딩이 요청되었으며 현재 채널이 이를 지원하면, ACP 세션을 해당 thread에 바인딩합니다.
5. 초점 해제/종료/만료될 때까지 바인딩된 후속 메시지를 같은 ACP 세션으로 라우팅합니다.

​

ACP와 sub-agent의 차이

​

ACP가 Claude Code를 실행하는 방식

1. OpenClaw ACP 세션 control plane
2. 번들 acpx 런타임 플러그인
3. Claude ACP adapter
4. Claude 측 런타임/세션 메커니즘

• ACP Claude는 직접 claude-cli/... fallback 런타임과 같은 것이 아닙니다.
• ACP Claude는 ACP 제어, 세션 재개, 백그라운드 작업 추적, 선택적인 conversation/thread 바인딩을 갖춘 harness 세션입니다.
• claude-cli/...는 텍스트 전용 로컬 CLI 백엔드입니다. CLI 백엔드를 참고하세요.

• /acp spawn, 바인딩 가능한 세션, 런타임 제어, 또는 지속적인 harness 작업이 필요하면 ACP를 사용
• 원시 CLI를 통한 단순 로컬 텍스트 fallback이 필요하면 CLI 백엔드를 사용

​

바인딩된 세션

​

현재 conversation 바인딩

• OpenClaw는 채널 transport, auth, 안전성, 전달을 계속 소유합니다.
• 현재 conversation은 spawn된 ACP session key에 고정됩니다.
• 해당 conversation의 후속 메시지는 같은 ACP 세션으로 라우팅됩니다.
• /new와 /reset은 같은 바인딩된 ACP 세션을 제자리에서 재설정합니다.
• /acp close는 세션을 닫고 현재 conversation 바인딩을 제거합니다.

• --bind here는 같은 채팅 surface를 유지합니다. Discord에서는 현재 채널이 그대로 현재 채널로 유지됩니다.
• --bind here는 새 작업을 spawn하는 경우 여전히 새 ACP 세션을 만들 수 있습니다. 바인딩은 그 세션을 현재 conversation에 연결합니다.
• --bind here는 자체적으로 자식 Discord thread나 Telegram topic을 만들지 않습니다.
• ACP 런타임은 여전히 자체 작업 디렉터리(cwd) 또는 백엔드 관리 workspace를 디스크에 가질 수 있습니다. 이 런타임 workspace는 채팅 surface와 별개이며 새 메시징 thread를 의미하지 않습니다.
• 다른 ACP agent로 spawn하고 --cwd를 전달하지 않으면 OpenClaw는 기본적으로 요청자의 workspace가 아니라 대상 agent의 workspace를 상속합니다.
• 상속된 workspace 경로가 없으면(ENOENT/ENOTDIR), OpenClaw는 잘못된 트리를 조용히 재사용하는 대신 백엔드 기본 cwd로 fallback합니다.
• 상속된 workspace는 존재하지만 접근할 수 없으면(예: EACCES), spawn은 cwd를 버리지 않고 실제 접근 오류를 반환합니다.

• 채팅 surface: 사람들이 계속 대화하는 곳 (Discord channel, Telegram topic, iMessage chat)
• ACP 세션: OpenClaw가 라우팅하는 지속적인 Codex/Claude/Gemini 런타임 상태
• 자식 thread/topic: --thread ...로만 생성되는 선택적 추가 메시징 surface
• 런타임 workspace: harness가 실행되는 파일 시스템 위치 (cwd, repo checkout, 백엔드 workspace)

• /acp spawn codex --bind here: 이 채팅을 유지하고 Codex ACP 세션을 spawn 또는 연결한 뒤 이후 메시지를 여기서 해당 세션으로 라우팅
• /acp spawn codex --thread auto: OpenClaw가 자식 thread/topic을 만들고 그곳에 ACP 세션을 바인딩할 수 있음
• /acp spawn codex --bind here --cwd /workspace/repo: 위와 같은 채팅 바인딩이지만 Codex는 /workspace/repo에서 실행됨

• 현재 conversation 바인딩 지원을 광고하는 채팅/메시지 채널은 공유 conversation-binding 경로를 통해 --bind here를 사용할 수 있습니다.
• 커스텀 thread/topic 의미론이 있는 채널도 동일한 공유 인터페이스 뒤에서 채널별 정규화를 제공할 수 있습니다.
• --bind here는 항상 “현재 conversation을 제자리에서 바인딩”함을 의미합니다.
• 일반적인 현재 conversation 바인딩은 공유 OpenClaw 바인딩 저장소를 사용하며 일반적인 gateway 재시작 후에도 유지됩니다.

• /acp spawn에서는 --bind here와 --thread ...를 함께 사용할 수 없습니다.
• Discord에서 --bind here는 현재 채널 또는 thread를 제자리에서 바인딩합니다. OpenClaw가 --thread auto|here를 위해 자식 thread를 만들어야 할 때만 spawnAcpSessions가 필요합니다.
• 활성 채널이 현재 conversation ACP 바인딩을 노출하지 않으면 OpenClaw는 명확한 미지원 메시지를 반환합니다.
• resume 및 “new session” 질문은 채널 질문이 아니라 ACP 세션 질문입니다. 현재 채팅 surface를 바꾸지 않고도 런타임 상태를 재사용하거나 교체할 수 있습니다.

​

thread 바인딩 세션

• OpenClaw는 thread를 대상 ACP 세션에 바인딩합니다.
• 해당 thread의 후속 메시지는 바인딩된 ACP 세션으로 라우팅됩니다.
• ACP 출력은 같은 thread로 다시 전달됩니다.
• 초점 해제/종료/보관/유휴 시간 초과 또는 최대 기간 만료 시 바인딩이 제거됩니다.

• acp.enabled=true
• acp.dispatch.enabled는 기본적으로 켜져 있음 (false로 설정하면 ACP dispatch를 일시 중지)
• 채널 adapter ACP thread-spawn 플래그 활성화(adapter별)
  • Discord: channels.discord.threadBindings.spawnAcpSessions=true
  • Telegram: channels.telegram.threadBindings.spawnAcpSessions=true

​

thread를 지원하는 채널

• session/thread 바인딩 capability를 노출하는 모든 채널 adapter
• 현재 내장 지원:
  • Discord thread/channel
  • Telegram topic(그룹/슈퍼그룹의 forum topic 및 DM topic)
• 플러그인 채널도 동일한 바인딩 인터페이스를 통해 지원을 추가할 수 있습니다.

​

채널별 설정

​

바인딩 모델

• bindings[].type="acp"는 지속적인 ACP conversation 바인딩을 표시합니다.
• bindings[].match는 대상 conversation을 식별합니다.
  • Discord 채널 또는 thread: match.channel="discord" + match.peer.id="<channelOrThreadId>"
  • Telegram forum topic: match.channel="telegram" + match.peer.id="<chatId>:topic:<topicId>"
  • BlueBubbles DM/그룹 채팅: match.channel="bluebubbles" + match.peer.id="<handle|chat_id:*|chat_guid:*|chat_identifier:*>"
    안정적인 그룹 바인딩에는 chat_id:* 또는 chat_identifier:*를 우선하세요.
  • iMessage DM/그룹 채팅: match.channel="imessage" + match.peer.id="<handle|chat_id:*|chat_guid:*|chat_identifier:*>"
    안정적인 그룹 바인딩에는 chat_id:*를 우선하세요.
• bindings[].agentId는 소유 OpenClaw agent id입니다.
• 선택적 ACP override는 bindings[].acp 아래에 둡니다.
  • mode (persistent 또는 oneshot)
  • label
  • cwd
  • backend

​

agent별 런타임 기본값

• agents.list[].runtime.type="acp"
• agents.list[].runtime.acp.agent (harness id, 예: codex 또는 claude)
• agents.list[].runtime.acp.backend
• agents.list[].runtime.acp.mode
• agents.list[].runtime.acp.cwd

1. bindings[].acp.*
2. agents.list[].runtime.acp.*
3. 전역 ACP 기본값(예: acp.backend)

{
  agents: {
    list: [
      {
        id: "codex",
        runtime: {
          type: "acp",
          acp: {
            agent: "codex",
            backend: "acpx",
            mode: "persistent",
            cwd: "/workspace/openclaw",
          },
        },
      },
      {
        id: "claude",
        runtime: {
          type: "acp",
          acp: { agent: "claude", backend: "acpx", mode: "persistent" },
        },
      },
    ],
  },
  bindings: [
    {
      type: "acp",
      agentId: "codex",
      match: {
        channel: "discord",
        accountId: "default",
        peer: { kind: "channel", id: "222222222222222222" },
      },
      acp: { label: "codex-main" },
    },
    {
      type: "acp",
      agentId: "claude",
      match: {
        channel: "telegram",
        accountId: "default",
        peer: { kind: "group", id: "-1001234567890:topic:42" },
      },
      acp: { cwd: "/workspace/repo-b" },
    },
    {
      type: "route",
      agentId: "main",
      match: { channel: "discord", accountId: "default" },
    },
    {
      type: "route",
      agentId: "main",
      match: { channel: "telegram", accountId: "default" },
    },
  ],
  channels: {
    discord: {
      guilds: {
        "111111111111111111": {
          channels: {
            "222222222222222222": { requireMention: false },
          },
        },
      },
    },
    telegram: {
      groups: {
        "-1001234567890": {
          topics: { "42": { requireMention: false } },
        },
      },
    },
  },
}

• OpenClaw는 사용 전에 설정된 ACP 세션이 존재하도록 보장합니다.
• 해당 채널 또는 topic의 메시지는 설정된 ACP 세션으로 라우팅됩니다.
• 바인딩된 conversation에서 /new와 /reset은 같은 ACP session key를 제자리에서 재설정합니다.
• 일시적 런타임 바인딩(예: thread-focus 흐름으로 생성된 바인딩)은 존재할 경우 계속 적용됩니다.
• 명시적 cwd 없이 cross-agent ACP spawn을 할 경우 OpenClaw는 agent config에서 대상 agent workspace를 상속합니다.
• 상속된 workspace 경로가 없으면 백엔드 기본 cwd로 fallback하고, 실제 접근 실패는 spawn 오류로 표시됩니다.

​

ACP 세션 시작(인터페이스)

​

sessions_spawn에서

{
  "task": "Open the repo and summarize failing tests",
  "runtime": "acp",
  "agentId": "codex",
  "thread": true,
  "mode": "session"
}

• runtime의 기본값은 subagent이므로 ACP 세션에는 runtime: "acp"를 명시적으로 설정하세요.
• agentId를 생략하면 설정된 경우 OpenClaw는 acp.defaultAgent를 사용합니다.
• 지속적인 바인딩 conversation을 유지하려면 mode: "session"에 thread: true가 필요합니다.

• task (필수): ACP 세션에 전송되는 초기 프롬프트
• runtime (ACP에 필수): 반드시 "acp"여야 함
• agentId (선택 사항): ACP 대상 harness id. 설정된 경우 acp.defaultAgent로 fallback
• thread (선택 사항, 기본값 false): 지원되는 경우 thread 바인딩 흐름 요청
• mode (선택 사항): run (일회성) 또는 session (지속형)
  • 기본값은 run
  • thread: true이고 mode를 생략하면 런타임 경로에 따라 OpenClaw가 지속형 동작을 기본값으로 사용할 수 있음
  • mode: "session"에는 thread: true가 필요함
• cwd (선택 사항): 요청된 런타임 작업 디렉터리(백엔드/런타임 정책에 따라 검증됨). 생략하면 ACP spawn은 설정된 경우 대상 agent workspace를 상속합니다. 상속된 경로가 없으면 백엔드 기본값으로 fallback하고, 실제 접근 오류는 그대로 반환됩니다.
• label (선택 사항): session/banner 텍스트에 사용되는 운영자 대상 label
• resumeSessionId (선택 사항): 새 세션을 만드는 대신 기존 ACP 세션 재개. agent는 session/load를 통해 conversation history를 재생합니다. runtime: "acp" 필요.
• streamTo (선택 사항): "parent"는 초기 ACP 실행 진행 요약을 system event로 요청자 세션에 다시 스트리밍함
  • 가능할 때 허용되는 응답에는 전체 relay history를 tail할 수 있는 session 범위 JSONL 로그(<sessionId>.acp-stream.jsonl)를 가리키는 streamLogPath가 포함됨

​

기존 세션 재개

{
  "task": "Continue where we left off — fix the remaining test failures",
  "runtime": "acp",
  "agentId": "codex",
  "resumeSessionId": "<previous-session-id>"
}

• 노트북에서 휴대폰으로 Codex 세션을 넘기기 — agent에게 중단한 지점부터 이어서 하라고 지시
• CLI에서 대화형으로 시작한 코딩 세션을 이제 agent를 통해 headless로 계속하기
• gateway 재시작 또는 유휴 시간 초과로 중단된 작업 이어가기

• resumeSessionId는 runtime: "acp"가 필요합니다 — sub-agent 런타임과 함께 사용하면 오류가 반환됩니다.
• resumeSessionId는 업스트림 ACP conversation history를 복원합니다. thread와 mode는 여전히 새로 만드는 OpenClaw 세션에 정상적으로 적용되므로, mode: "session"에는 여전히 thread: true가 필요합니다.
• 대상 agent는 session/load를 지원해야 합니다(Codex와 Claude Code는 지원).
• 세션 ID를 찾지 못하면 spawn은 명확한 오류와 함께 실패합니다 — 새 세션으로 조용히 fallback하지 않습니다.

​

운영자 smoke test

1. 대상 호스트에서 배포된 gateway 버전/커밋을 확인합니다.
2. 배포된 소스에 src/gateway/sessions-patch.ts의 ACP lineage 허용(subagent:* or acp:* sessions)이 포함되어 있는지 확인합니다.
3. 라이브 agent에 임시 ACPX 브리지 세션을 엽니다(예: jpclawhq의 razor(main)).
4. 해당 agent에 다음으로 sessions_spawn을 호출하게 합니다.
   • runtime: "acp"
   • agentId: "codex"
   • mode: "run"
   • task: Reply with exactly LIVE-ACP-SPAWN-OK
5. agent가 다음을 보고하는지 확인합니다.
   • accepted=yes
   • 실제 childSessionKey
   • validator 오류 없음
6. 임시 ACPX 브리지 세션을 정리합니다.

Use the sessions_spawn tool now with runtime: "acp", agentId: "codex", and mode: "run".
Set the task to: "Reply with exactly LIVE-ACP-SPAWN-OK".
Then report only: accepted=<yes/no>; childSessionKey=<value or none>; error=<exact text or none>.

• thread에 바인딩된 지속형 ACP 세션을 의도적으로 테스트하는 경우가 아니라면 이 smoke test는 mode: "run"으로 유지하세요.
• 기본 게이트에 streamTo: "parent"를 요구하지 마세요. 이 경로는 요청자/세션 capability에 의존하며 별도의 통합 점검입니다.
• thread 바인딩 mode: "session" 테스트는 실제 Discord thread 또는 Telegram topic에서의 두 번째, 더 풍부한 통합 단계로 취급하세요.

​

샌드박스 호환성

• 요청자 세션이 샌드박스 상태면 ACP spawn은 sessions_spawn({ runtime: "acp" })와 /acp spawn 모두에서 차단됩니다.
  • 오류: Sandboxed sessions cannot spawn ACP sessions because runtime="acp" runs on the host. Use runtime="subagent" from sandboxed sessions.
• runtime: "acp"가 있는 sessions_spawn은 sandbox: "require"를 지원하지 않습니다.
  • 오류: sessions_spawn sandbox="require" is unsupported for runtime="acp" because ACP sessions run outside the sandbox. Use runtime="subagent" or sandbox="inherit".

​

/acp command에서

/acp spawn codex --mode persistent --thread auto
/acp spawn codex --mode oneshot --thread off
/acp spawn codex --bind here
/acp spawn codex --thread here

• --mode persistent|oneshot
• --bind here|off
• --thread auto|here|off
• --cwd <absolute-path>
• --label <name>

​

세션 대상 resolve

1. 명시적 대상 인수(또는 /acp steer의 --session)
   • 먼저 key 시도
   • 다음으로 UUID 형태 session id 시도
   • 다음으로 label 시도
2. 현재 thread 바인딩(이 conversation/thread가 ACP 세션에 바인딩된 경우)
3. 현재 요청자 세션 fallback

​

Spawn 바인딩 모드

• --bind here는 “이 채널 또는 채팅을 Codex 기반으로 만들기”에 가장 단순한 운영자 경로입니다.
• --bind here는 자식 thread를 만들지 않습니다.
• --bind here는 현재 conversation 바인딩 지원을 노출하는 채널에서만 사용할 수 있습니다.
• --bind와 --thread는 같은 /acp spawn 호출에서 함께 사용할 수 없습니다.

​

Spawn thread 모드

• thread 바인딩이 아닌 surface에서는 기본 동작이 사실상 off입니다.
• thread 바인딩 spawn에는 채널 정책 지원이 필요합니다.
  • Discord: channels.discord.threadBindings.spawnAcpSessions=true
  • Telegram: channels.telegram.threadBindings.spawnAcpSessions=true
• 자식 thread를 만들지 않고 현재 conversation을 고정하려면 --bind here를 사용하세요.

​

ACP 제어

• /acp spawn
• /acp cancel
• /acp steer
• /acp close
• /acp status
• /acp set-mode
• /acp set
• /acp cwd
• /acp permissions
• /acp timeout
• /acp model
• /acp reset-options
• /acp sessions
• /acp doctor
• /acp install

​

ACP command cookbook

​

런타임 옵션 매핑

• /acp model <id>는 런타임 config key model에 매핑됩니다.
• /acp permissions <profile>은 런타임 config key approval_policy에 매핑됩니다.
• /acp timeout <seconds>는 런타임 config key timeout에 매핑됩니다.
• /acp cwd <path>는 런타임 cwd override를 직접 업데이트합니다.
• /acp set <key> <value>는 일반 경로입니다.
  • 특별 처리: key=cwd는 cwd override 경로를 사용합니다.
• /acp reset-options는 대상 세션의 모든 런타임 override를 지웁니다.

​

acpx harness 지원(현재)

• claude
• codex
• copilot
• cursor (Cursor CLI: cursor-agent acp)
• droid
• gemini
• iflow
• kilocode
• kimi
• kiro
• openclaw
• opencode
• pi
• qwen

​

필수 config

{
  acp: {
    enabled: true,
    // 선택 사항. 기본값은 true이며, /acp 제어는 유지한 채 ACP dispatch를 일시 중지하려면 false로 설정합니다.
    dispatch: { enabled: true },
    backend: "acpx",
    defaultAgent: "codex",
    allowedAgents: [
      "claude",
      "codex",
      "copilot",
      "cursor",
      "droid",
      "gemini",
      "iflow",
      "kilocode",
      "kimi",
      "kiro",
      "openclaw",
      "opencode",
      "pi",
      "qwen",
    ],
    maxConcurrentSessions: 8,
    stream: {
      coalesceIdleMs: 300,
      maxChunkChars: 1200,
    },
    runtime: {
      ttlMinutes: 120,
    },
  },
}

{
  session: {
    threadBindings: {
      enabled: true,
      idleHours: 24,
      maxAgeHours: 0,
    },
  },
  channels: {
    discord: {
      threadBindings: {
        enabled: true,
        spawnAcpSessions: true,
      },
    },
  },
}

• Discord: channels.discord.threadBindings.spawnAcpSessions=true

​

acpx 백엔드를 위한 플러그인 설정

/acp doctor

openclaw plugins install acpx
openclaw config set plugins.entries.acpx.enabled true

openclaw plugins install ./path/to/local/acpx-plugin

/acp doctor

​

acpx command 및 버전 config

1. command는 ACPX 플러그인 패키지 내부의 플러그인 로컬 node_modules/.bin/acpx를 기본값으로 사용합니다.
2. 예상 버전은 extension pin을 기본값으로 사용합니다.
3. 시작 시 ACP 백엔드를 즉시 not-ready 상태로 등록합니다.
4. 백그라운드 ensure 작업이 acpx --version을 검증합니다.
5. 플러그인 로컬 바이너리가 없거나 버전이 맞지 않으면 다음을 실행합니다. npm install --omit=dev --no-save acpx@<pinned> 후 다시 검증합니다.

{
  "plugins": {
    "entries": {
      "acpx": {
        "enabled": true,
        "config": {
          "command": "../acpx/dist/cli.js",
          "expectedVersion": "any"
        }
      }
    }
  }
}

• command는 절대 경로, 상대 경로, 또는 command 이름(acpx)을 받을 수 있습니다.
• 상대 경로는 OpenClaw workspace 디렉터리 기준으로 resolve됩니다.
• expectedVersion: "any"는 엄격한 버전 일치를 비활성화합니다.
• command가 커스텀 바이너리/경로를 가리키면 플러그인 로컬 자동 install은 비활성화됩니다.
• 백엔드 상태 확인이 실행되는 동안에도 OpenClaw 시작은 non-blocking 상태를 유지합니다.

​

자동 의존성 install

​

플러그인 tool MCP 브리지

openclaw config set plugins.entries.acpx.config.pluginToolsMcpBridge true

• ACPX 세션 bootstrap에 openclaw-plugin-tools라는 내장 MCP 서버를 주입합니다.
• 설치되고 활성화된 OpenClaw 플러그인이 이미 등록한 플러그인 tool을 노출합니다.
• 이 기능을 명시적이고 기본 비활성 상태로 유지합니다.

• 이 설정은 ACP harness tool surface를 확장합니다.
• ACP agent는 gateway에서 이미 활성화된 플러그인 tool에만 접근할 수 있습니다.
• 이를 해당 플러그인이 OpenClaw 자체에서 실행되도록 허용하는 것과 같은 신뢰 경계로 취급하세요.
• 활성화하기 전에 설치된 플러그인을 검토하세요.

​

권한 config

​

permissionMode

​

nonInteractivePermissions

​

Configuration

openclaw config set plugins.entries.acpx.config.permissionMode approve-all
openclaw config set plugins.entries.acpx.config.nonInteractivePermissions fail

중요: OpenClaw는 현재 기본값으로 permissionMode=approve-reads와 nonInteractivePermissions=fail을 사용합니다. 비대화형 ACP 세션에서는 권한 프롬프트를 발생시키는 모든 쓰기 또는 exec가 AcpRuntimeError: Permission prompt unavailable in non-interactive mode와 함께 실패할 수 있습니다. 권한을 제한해야 한다면, 세션이 크래시하지 않고 점진적으로 기능이 저하되도록 nonInteractivePermissions를 deny로 설정하세요.

​

문제 해결