Openclaw용 pilot-stream-data

영구적인 Pilot Protocol 연결을 사용하여 agent 간의 실시간 NDJSON 데이터 전송을 위한 고성능 스트리밍 스킬입니다.

teoslayer

v1.0.0

Apr 9, 2026

설치

정보

Skill.md

설치 및 다운로드

1. ClawHub CLI

레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.


                  npx clawhub@latest install pilot-stream-data

2. 수동 설치

스킬 폴더를 다음 위치 중 하나로 복사하세요

글로벌

~/.openclaw/skills/

워크스페이스

<project>/skills/

우선순위: 워크스페이스 > 로컬 > 번들

3. 프롬프트 설치

이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.


                  Clawhub를 사용해서 pilot-stream-data 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).

다운로드를 원하시나요?

ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.

pilot-stream-data란 무엇인가요?

pilot-stream-data 스킬은 저지연, 구조화된 데이터 전송을 위해 설계된 Openclaw Skills 에코시스템 내의 특화된 도구입니다. Pilot Protocol의 영구 연결을 활용하여 AI agent와 시스템 프로세스가 NDJSON(Newline Delimited JSON) 형식으로 지속적인 정보 스트림을 교환할 수 있도록 합니다. 이 접근 방식은 로그나 센서 판독값과 같은 고주파 데이터에 대해 표준 요청-응답 주기보다 훨씬 효율적입니다.

신뢰성과 확장성을 위해 구축된 이 스킬은 백프레셔 처리에 대한 네이티브 지원을 포함하여 데이터 생산자가 트래픽 피크 중에 소비자를 압도하지 않도록 보장합니다. 분산 모니터링 네트워크를 구축하든 멀티 에이전트 협업 환경을 구축하든, pilot-stream-data는 현대적인 Openclaw Skills 구현에 필요한 강력한 전송 계층을 제공합니다.

pilot-stream-data 활용 사례

agent 간 센서 텔레메트리 및 IoT 장치 메트릭의 실시간 전송.
실시간 디버깅을 위한 시스템 로그 또는 애플리케이션 추적의 지속적인 스트리밍.
저지연 업데이트가 필요한 동기화된 작업을 위한 에이전트 간 통신.
간헐적인 폴링보다 영구적인 연결이 선호되는 양방향 데이터 흐름.

pilot-stream-data 작동 원리

수신자 agent는 pilotctl 유틸리티를 사용하여 특정 Pilot Port에서 리스너를 초기화합니다.
송신자 agent는 대상 ID 및 포트에 대한 영구 연결을 설정합니다.
데이터는 개별 JSON 객체로 직렬화되고 개행 문자가 추가되어 NDJSON 스트림을 형성합니다.
Pilot Protocol은 기본 전송을 관리하고 스트림 무결성을 유지하기 위해 흐름 제어 및 백프레셔를 처리합니다.
소비자 agent는 일반적으로 실시간 파싱을 위해 jq와 같은 도구를 사용하여 들어오는 스트림을 한 줄씩 처리합니다.

pilot-stream-data 설정 가이드

이 Openclaw Skills 모듈을 사용하려면 pilot-protocol이 설치되어 있고 데몬이 실행 중인지 확인하세요.

# Start the pilot protocol daemon
pilotctl daemon start

# Ensure dependencies are available
sudo apt-get install jq bc

# Initialize a listener to test the setup
pilotctl --json listen 1002

pilot-stream-data 데이터 스키마 및 분류 체계

이 스킬은 NDJSON 기반의 스트리밍 스키마를 활용합니다. 모든 메시지는 독립적인 JSON 객체입니다. 일반적인 데이터 구조는 다음과 같습니다.

Field	Type	Description
type	string	메시지 유형 (예: 'data', 'stream_start', 'heartbeat')
timestamp	integer	이벤트의 Unix epoch 타임스탬프
seq	integer	패킷 손실 감지를 위한 증분 시퀀스 번호
payload	object	사용자 정의 데이터 필드 (예: temp, humidity, status)