---
read_when:
    - Claude Code에서 OpenClaw Gateway MCP 도구를 사용하려는 경우
    - 외부 하네스를 위한 임시 세션 바인딩 MCP 권한 부여가 필요합니다
summary: '`openclaw attach`에 대한 CLI 참조(범위가 지정된 Gateway MCP 권한으로 Claude Code 실행)'
title: CLI 연결
x-i18n:
    generated_at: "2026-07-12T00:39:49Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    provider: openai
    source_hash: 0d8ac60724adef1439af09179806af537b8f2925f06b3715850e4dd3b83b080f
    source_path: cli/attach.md
    workflow: 16
---

`openclaw attach`는 하나의 Gateway 세션에 바인딩된 엄격한 임시 MCP 구성으로 Claude Code를 실행합니다.

```sh
openclaw attach
openclaw attach --session agent:main:telegram:123 --ttl 600000
openclaw attach --print-config
```

옵션:

- `--session <key>`는 권한 부여를 Gateway 세션에 바인딩합니다. 기본값은 기본 세션입니다.
- `--ttl <ms>`는 밀리초 단위의 양수 권한 부여 TTL을 요청합니다. Gateway는 자체 상한을 적용합니다.
- `--bin <path>`는 Claude Code 바이너리를 선택합니다. 기본값: `claude`.
- `--print-config`는 임시 `.mcp.json`을 작성하고 실행 명령과 환경 변수를 출력하며, TTL이 만료될 때까지 권한 부여를 활성 상태로 유지합니다(Claude Code를 생성하거나 권한 부여를 취소하지 않습니다).

베어러 토큰은 argv가 아닌 환경 변수를 통해 전달됩니다. OpenClaw는 주변 Claude MCP 서버가 연결된 세션에 참여하지 않도록 `--strict-mcp-config --mcp-config <path>`와 함께 Claude Code를 실행합니다. 일반 실행(`--print-config` 미사용)은 Claude Code 프로세스가 종료될 때 권한 부여를 취소합니다.

참고 항목: [Gateway CLI](/ko/cli/gateway), [MCP CLI](/ko/cli/mcp), [ACP CLI](/ko/cli/acp).