외부 앱용 Gateway 통합

외부 앱은 현재 Gateway 프로토콜을 통해 OpenClaw와 통신해야 합니다. 스크립트, 대시보드, CI 작업, IDE 확장 프로그램 또는 다른 프로세스가 에이전트 실행을 시작하거나, 이벤트를 스트리밍하거나, 결과를 기다리거나, 작업을 취소하거나, Gateway 리소스를 검사하려는 경우 Gateway WebSocket 및 RPC 메서드를 사용하세요.

현재 사용할 수 있는 항목

소스 트리에는 향후 클라이언트 라이브러리를 위한 내부 패키지 작업이 포함되어 있지만, 이는 공개 설치 표면이 아닙니다. 패키지가 게시되고 버전이 지정될 때까지는 미리 보기 구현 세부 정보로 간주하세요.

권장 경로

1. Gateway를 실행하거나 검색합니다.
2. Gateway 프로토콜을 통해 연결합니다.
3. Gateway RPC 참조의 문서화된 RPC 메서드를 호출합니다.
4. 테스트 기준으로 삼는 OpenClaw 버전을 고정합니다.
5. OpenClaw를 업그레이드할 때 RPC 참조를 다시 확인합니다.

에이전트 실행의 경우 agent RPC로 시작하고 최종 결과가 필요할 때는 agent.wait와 함께 사용하세요. 지속적인 대화 상태에는 sessions.* 메서드를 사용하세요. UI 통합의 경우 Gateway 이벤트를 구독하고 앱이 이해하는 이벤트 계열만 렌더링하세요.

앱 코드와 Plugin 코드

코드가 OpenClaw 외부에 있는 경우 Gateway RPC를 사용하세요.

• 에이전트 실행을 시작하거나 관찰하는 Node 스크립트
• Gateway를 호출하는 CI 작업
• 대시보드 및 관리자 패널
• IDE 확장 프로그램
• 채널 Plugin이 될 필요가 없는 외부 브리지
• 가짜 또는 실제 Gateway 전송을 사용하는 통합 테스트

코드가 OpenClaw 내부에서 실행되는 경우 Plugin SDK를 사용하세요.

• 제공자 Plugin
• 채널 Plugin
• 도구 또는 수명 주기 훅
• 에이전트 하네스 Plugin
• 신뢰할 수 있는 런타임 헬퍼

외부 앱은 openclaw/plugin-sdk/*를 가져오면 안 됩니다. 해당 하위 경로는 OpenClaw가 로드하는 Plugin을 위한 것입니다.

관련

• Gateway 프로토콜
• Gateway RPC 참조
• CLI 에이전트 명령
• CLI 메시지 명령
• 에이전트 루프
• 에이전트 런타임
• 세션
• 백그라운드 작업
• ACP 에이전트
• Plugin SDK 개요