메인 콘텐츠로 건너뛰기
외부 앱은 현재 Gateway 프로토콜을 통해 OpenClaw와 통신해야 합니다. 스크립트, 대시보드, CI 작업, IDE 확장 프로그램 또는 다른 프로세스가 에이전트 실행을 시작하거나, 이벤트를 스트리밍하거나, 결과를 기다리거나, 작업을 취소하거나, Gateway 리소스를 검사하려는 경우 Gateway WebSocket 및 RPC 메서드를 사용하세요.
아직 공개 npm 클라이언트 패키지는 없습니다. 릴리스 노트에서 게시된 패키지를 발표하고 이 페이지에 설치 지침이 포함되기 전까지는 OpenClaw 클라이언트 패키지 이름을 애플리케이션 의존성으로 추가하지 마세요.
이 페이지는 OpenClaw 프로세스 외부의 코드를 위한 것입니다. OpenClaw 내부에서 실행되는 Plugin 코드는 대신 문서화된 openclaw/plugin-sdk/* 하위 경로를 사용해야 합니다.

​
현재 사용할 수 있는 항목

표면상태사용 용도
Gateway 프로토콜준비됨WebSocket 전송, 연결 핸드셰이크, 인증 범위, 프로토콜 버전 관리, 이벤트.
Gateway RPC 참조준비됨에이전트, 세션, 작업, 모델, 도구, 아티팩트, 승인을 위한 현재 Gateway 메서드.
openclaw agent준비됨CLI를 호출하는 것으로 충분한 경우의 일회성 스크립트 통합.
openclaw message준비됨스크립트에서 메시지 또는 채널 작업 보내기.
소스 트리에는 향후 클라이언트 라이브러리를 위한 내부 패키지 작업이 포함되어 있지만, 이는 공개 설치 표면이 아닙니다. 패키지가 게시되고 버전이 지정될 때까지는 미리 보기 구현 세부 정보로 간주하세요.

​
권장 경로

  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을 위한 것입니다.

​
관련