Gateway integrations for external apps

기준일: 2026-07-26
공식 기준: Gateway integrations for external apps

Gateway integrations for external apps 문서는 OpenClaw 공식 문서(gateway/external-apps)를 한국어로 정리한 가이드입니다. Current integration path for external apps, scripts, dashboards, CI jobs, and IDE extensions 명령·설정 키·코드 예시는 공식 문서를 그대로 보존하며, 해석과 절차 안내는 한국어로 제공합니다. 최종 동작은 설치된 CLI 버전과 공식 원문을 확인하세요.

핵심 요약

Current integration path for external apps, scripts, dashboards, CI jobs, and IDE extensions

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

문서 구성

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

• What is available today
• Recommended path
• Cooperative host suspension
• App code vs plugin code
• 관련 문서

상세 내용

본문

External apps talk to OpenClaw through the Gateway protocol: WebSocket transport plus RPC methods. Use it when a script, dashboard, CI job, IDE extension, or another process wants to start agent runs, stream events, wait for results, cancel work, or inspect Gateway resources.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

What is available today

Surface	Status	Use it for
Gateway client guide	Release train	npm packages, auth, reconnect, history, events, approvals, and version policy.
Embedding guide	Release train	Child-process environment, readiness, lifecycle, recovery, RPC ownership, and packaging.
Gateway protocol	Ready	WebSocket transport, connect handshake, auth scopes, protocol versioning, and events.
Gateway RPC reference	Ready	Current Gateway methods for agents, sessions, tasks, models, tools, artifacts, and approvals.
openclaw agent	Ready	One-shot script integration when shelling out to the CLI is enough.
openclaw message	Ready	Sending messages or channel actions from scripts.

Recommended path

1. Run or discover a Gateway. 2. Connect over the Gateway protocol. 3. Call documented RPC methods from Gateway RPC reference. 4. Pin the OpenClaw version you test against. 5. Recheck the RPC reference when upgrading OpenClaw.

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

Cooperative host suspension

Hosting controllers that freeze or snapshot a running process can use the host-neutral suspension handshake:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• gateway.suspend.prepare — operator.admin; params
• gateway.suspend.status — operator.read; params
• gateway.suspend.resume — operator.admin; params

{
  "status": "ready",
  "suspensionId": "2c3f...",
  "expiresAtMs": 1770000000000,
  "activeCount": 0,
  "blockers": []
}

App code vs plugin code

Use Gateway RPC when code lives outside OpenClaw:

위 내용은 공식 문서의 해당 섹션 요지입니다. 세부 플래그·기본값은 원문과 --help를 확인하세요.

주요 항목:

• Node scripts that start or observe agent runs
• CI jobs that call a Gateway
• dashboards and admin panels
• IDE extensions
• external bridges that do not need to become channel plugins
• integration tests with fake or real Gateway transports
• provider plugins
• channel plugins
• tool or lifecycle hooks
• agent harness plugins
• trusted runtime helpers

관련 문서

주요 항목:

• Building a Gateway client
• Embedding OpenClaw
• Gateway protocol
• Gateway RPC reference
• CLI agent command
• CLI message command
• Agent loop
• Agent runtimes
• Sessions
• Background tasks
• ACP agents
• Plugin SDK overview

실습 체크리스트

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

자주 쓰는 명령·설정 예시

{
  "status": "ready",
  "suspensionId": "2c3f...",
  "expiresAtMs": 1770000000000,
  "activeCount": 0,
  "blockers": []
}

관련 링크

• 공식 원문: gateway/external-apps
• OpenClaw 문서 홈

이 가이드는 공식 문서를 한국어 학습용으로 재구성한 것입니다. 옵션 기본값·플래그 이름은 설치 버전에 따라 달라질 수 있습니다.