​

ACP agents

​

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

​

별도 설정 없이 바로 되나요?

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

• 대상 harness adapter는 해당 harness를 처음 사용할 때 npx로 온디맨드 가져올 수 있습니다.
• 해당 harness에 대한 벤더 인증은 여전히 호스트에 존재해야 합니다.
• 호스트에 npm/네트워크 접근이 없으면, 캐시를 미리 데우거나 adapter를 다른 방식으로 설치하기 전까지 첫 실행 adapter 가져오기가 실패할 수 있습니다.

• /acp spawn codex: OpenClaw는 acpx 부트스트랩 준비가 되어 있어야 하지만, Codex ACP adapter는 여전히 첫 실행 시 가져오기가 필요할 수 있습니다.
• /acp spawn claude: Claude ACP adapter도 마찬가지이며, 그 호스트의 Claude 측 인증도 필요합니다.

​

빠른 operator 흐름

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

​

사람을 위한 빠른 시작

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

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

​

ACP와 서브에이전트 비교

​

ACP가 Claude Code를 실행하는 방식

1. OpenClaw ACP 세션 제어 평면
2. 번들된 acpx 런타임 plugin
3. Claude ACP adapter
4. Claude 측 런타임/세션 메커니즘

• ACP Claude는 ACP 제어, 세션 재개, 백그라운드 작업 추적, 선택적 대화/스레드 바인딩을 갖춘 harness 세션입니다.
• CLI 백엔드는 별도의 텍스트 전용 로컬 대체 런타임입니다. CLI 백엔드를 참고하세요.

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

​

바인딩된 세션

​

현재 대화 바인딩

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

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

• 채팅 표면: 사람들이 계속 대화하는 곳(Discord 채널, Telegram 토픽, iMessage 채팅)
• ACP 세션: OpenClaw가 라우팅하는 지속적인 Codex/Claude/Gemini 런타임 상태
• 자식 스레드/토픽: --thread ...로만 생성되는 선택적 추가 메시징 표면
• 런타임 워크스페이스: harness가 실행되는 파일시스템 위치(cwd, 리포지토리 체크아웃, 백엔드 워크스페이스)

• /acp spawn codex --bind here: 이 채팅을 유지하고 Codex ACP 세션을 spawn 또는 연결한 뒤, 앞으로 여기의 메시지를 그 세션으로 라우팅
• /acp spawn codex --thread auto: OpenClaw가 자식 스레드/토픽을 만들고 거기에 ACP 세션을 바인딩할 수 있음
• /acp spawn codex --bind here --cwd /workspace/repo: 위와 동일한 채팅 바인딩이지만, Codex는 /workspace/repo에서 실행

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

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

​

스레드 바인딩 세션

• OpenClaw는 스레드를 대상 ACP 세션에 바인딩합니다.
• 해당 스레드의 후속 메시지는 바인딩된 ACP 세션으로 라우팅됩니다.
• ACP 출력은 같은 스레드로 다시 전달됩니다.
• unfocus/close/archive/idle-timeout 또는 max-age 만료 시 바인딩이 제거됩니다.

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

​

스레드를 지원하는 채널

• 세션/스레드 바인딩 기능을 노출하는 모든 채널 adapter
• 현재 내장 지원:
  • Discord 스레드/채널
  • Telegram 토픽(그룹/슈퍼그룹의 포럼 토픽 및 DM 토픽)
• Plugin 채널도 동일한 바인딩 인터페이스를 통해 지원을 추가할 수 있습니다.

​

채널별 설정

​

바인딩 모델

• bindings[].type="acp"는 지속적인 ACP 대화 바인딩을 표시합니다.
• bindings[].match는 대상 대화를 식별합니다:
  • Discord 채널 또는 스레드: match.channel="discord" + match.peer.id="<channelOrThreadId>"
  • Telegram 포럼 토픽: 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 세션이 존재하도록 보장합니다.
• 해당 채널이나 토픽의 메시지는 설정된 ACP 세션으로 라우팅됩니다.
• 바인딩된 대화에서는 /new와 /reset이 같은 ACP 세션 키를 제자리에서 재설정합니다.
• 임시 런타임 바인딩(예: 스레드 focus 흐름으로 생성된 바인딩)은 존재할 경우 계속 적용됩니다.
• 명시적 cwd가 없는 크로스 agent ACP spawn의 경우, OpenClaw는 agent config에서 대상 agent 워크스페이스를 상속합니다.
• 누락된 상속 워크스페이스 경로는 백엔드 기본 cwd로 대체되며, 실제 접근 실패는 spawn 오류로 표시됩니다.

​

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

​

sessions_spawn에서 시작

{
  "task": "리포지토리를 열고 실패하는 테스트를 요약해",
  "runtime": "acp",
  "agentId": "codex",
  "thread": true,
  "mode": "session"
}

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

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

​

기존 세션 재개

{
  "task": "중단한 지점부터 계속해 — 남은 테스트 실패를 수정해",
  "runtime": "acp",
  "agentId": "codex",
  "resumeSessionId": "<previous-session-id>"
}

• Codex 세션을 노트북에서 휴대폰으로 넘기기 — agent에게 하던 작업을 이어받도록 지시
• CLI에서 대화형으로 시작한 코딩 세션을 이제 agent를 통해 헤드리스로 계속하기
• gateway 재시작이나 유휴 시간 초과로 중단된 작업 이어받기

• resumeSessionId에는 runtime: "acp"가 필요하며, 서브에이전트 런타임과 함께 사용하면 오류를 반환합니다.
• resumeSessionId는 업스트림 ACP 대화 기록을 복원합니다. thread와 mode는 새로 생성하는 OpenClaw 세션에 여전히 정상적으로 적용되므로, mode: "session"에는 여전히 thread: true가 필요합니다.
• 대상 agent는 session/load를 지원해야 합니다(Codex와 Claude Code는 지원).
• 세션 ID를 찾을 수 없으면 spawn은 명확한 오류와 함께 실패합니다. 새 세션으로 조용히 대체되지 않습니다.

​

operator 스모크 테스트

1. 대상 호스트에서 배포된 gateway 버전/커밋을 확인합니다.
2. 배포된 소스에 src/gateway/sessions-patch.ts의 ACP 계보 허용 (subagent:* or acp:* sessions)이 포함되어 있는지 확인합니다.
3. 라이브 agent(예: jpclawhq의 razor(main))에 임시 ACPX 브리지 세션을 엽니다.
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>.

• 스레드 바인딩 지속 ACP 세션을 의도적으로 테스트하는 것이 아니라면 이 스모크 테스트는 mode: "run"으로 유지하세요.
• 기본 게이트에서는 streamTo: "parent"를 요구하지 마세요. 이 경로는 요청자/세션 기능에 의존하므로 별도의 통합 검사입니다.
• 스레드 바인딩 mode: "session" 테스트는 실제 Discord 스레드 또는 Telegram 토픽에서 두 번째의 더 풍부한 통합 패스로 취급하세요.

​

샌드박스 호환성

• 요청자 세션이 샌드박스 환경이면, sessions_spawn({ runtime: "acp" })와 /acp spawn 모두에서 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 명령에서 시작

/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>

​

세션 대상 해석

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

​

spawn 바인딩 모드

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

​

spawn 스레드 모드

• 스레드 바인딩이 없는 표면에서는 기본 동작이 사실상 off입니다.
• 스레드 바인딩 spawn에는 채널 정책 지원이 필요합니다:
  • Discord: channels.discord.threadBindings.spawnAcpSessions=true
  • Telegram: channels.telegram.threadBindings.spawnAcpSessions=true
• 자식 스레드를 만들지 않고 현재 대화를 고정하고 싶다면 --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 명령 요리책

​

런타임 옵션 매핑

• /acp model <id>는 런타임 config 키 model에 매핑됩니다.
• /acp permissions <profile>은 런타임 config 키 approval_policy에 매핑됩니다.
• /acp timeout <seconds>는 런타임 config 키 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

​

필요한 설정

{
  acp: {
    enabled: true,
    // Optional. Default is true; set false to pause ACP dispatch while keeping /acp controls.
    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 백엔드용 plugin 설정

/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 명령 및 버전 설정

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

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

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

​

자동 의존성 설치

​

plugin 도구 MCP 브리지

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

• ACPX 세션 부트스트랩에 openclaw-plugin-tools라는 내장 MCP 서버를 주입합니다.
• 설치 및 활성화된 OpenClaw plugin이 이미 등록한 plugin 도구를 노출합니다.
• 이 기능을 명시적이고 기본 비활성 상태로 유지합니다.

• 이는 ACP harness 도구 표면을 확장합니다.
• ACP agent는 gateway에서 이미 활성화된 plugin 도구에만 접근합니다.
• 이를 해당 plugin을 OpenClaw 자체에서 실행하도록 허용하는 것과 같은 신뢰 경계로 취급하세요.
• 활성화하기 전에 설치된 plugin을 검토하세요.

​

런타임 타임아웃 설정

openclaw config set plugins.entries.acpx.config.timeoutSeconds 180

​

권한 설정

​

permissionMode

​

nonInteractivePermissions

​

설정

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을 사용합니다. non-interactive ACP 세션에서는 권한 프롬프트를 유발하는 모든 쓰기 또는 exec가 AcpRuntimeError: Permission prompt unavailable in non-interactive mode와 함께 실패할 수 있습니다. 권한을 제한해야 한다면 nonInteractivePermissions를 deny로 설정하여 세션이 충돌하는 대신 점진적으로 성능 저하되도록 하세요.

​

문제 해결