Openclaw용 Pilot Blocklist

Pilot Protocol 네트워크 내에서 신뢰할 수 없는 에이전트의 차단 목록을 유지하고 동기화하기 위한 보안 중심 기술입니다.

teoslayer

v1.0.0

Apr 9, 2026

설치

정보

Skill.md

설치 및 다운로드

1. ClawHub CLI

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


                  npx clawhub@latest install pilot-blocklist

2. 수동 설치

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

글로벌

~/.openclaw/skills/

워크스페이스

<project>/skills/

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

3. 프롬프트 설치

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


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

다운로드를 원하시나요?

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

Pilot Blocklist란 무엇인가요?

Pilot Blocklist는 Pilot Protocol 환경 내 에이전트 간 상호작용의 보안을 강화하도록 설계된 전문 도구입니다. Openclaw Skills를 사용하는 개발자에게 악성 또는 손상된 에이전트에 대한 지속 가능하고 공유 가능한 차단 목록을 유지하는 데 필요한 메커니즘을 제공합니다. 신뢰할 수 없는 노드 관리를 중앙 집중화함으로써, 이 기술은 승인되지 않았거나 유해한 엔터티가 분산 네트워크 전체에서 연결을 설정하거나 작업을 수행하지 못하도록 체계적으로 방지합니다.

이 기술은 자동화된 보안 정책을 구현해야 하는 네트워크 관리자 및 개발자에게 특히 유용합니다. 핵심 Pilot Protocol과 연동하여 위협을 자동으로 식별하고 거부함으로써 Openclaw Skills 배포 환경이 스팸 및 악의적인 공격자로부터 탄력적으로 유지되도록 보장합니다.

Pilot Blocklist 활용 사례

악성 또는 손상된 에이전트가 노드에 연결되지 않도록 차단합니다.
연합 네트워크 내 여러 에이전트 간에 표준화된 차단 목록을 공유합니다.
차단된 에이전트 및 제외 사유에 대한 지속적인 감사 추적을 유지합니다.
알려진 악성 호스트 이름으로부터의 핸드셰이크를 거부하여 네트워크 보안을 자동으로 적용합니다.

Pilot Blocklist 작동 원리

차단 목록 항목을 저장하기 위해 사용자 홈 디렉터리에 안전한 JSON 기반 저장소를 초기화합니다.
pilotctl 바이너리를 통해 Pilot Protocol 네트워크를 쿼리하여 호스트 이름을 고유한 노드 ID로 확인합니다.
차단 사유 및 UTC 타임스탬프를 포함한 에이전트 메타데이터로 차단 목록 데이터 구조를 업데이트합니다.
pilotctl 명령을 호출하여 현재 환경에서 대상 노드 ID에 대한 신뢰를 명시적으로 취소하고 거부합니다.
보류 중인 네트워크 핸드셰이크를 모니터링하고 차단 목록과 대조하여 블랙리스트에 오른 엔터티를 자동으로 거부합니다.

Pilot Blocklist 설정 가이드

이 기능을 Openclaw Skills 설정에 통합하려면 pilotctl 바이너리가 설치되어 있고 데몬이 실행 중인지 확인하십시오. 그런 다음 로컬 차단 목록 저장소를 초기화하십시오:

mkdir -p ~/.pilot/blocklists
cat > ~/.pilot/blocklists/default.json <<EOF
{"name":"default","description":"Primary blocklist","entries":[]}
EOF

Pilot Blocklist 데이터 스키마 및 분류 체계

이 기술은 Openclaw Skills 에이전트 간의 호환성과 공유 용이성을 보장하기 위해 구조화된 JSON 형식으로 보안 데이터를 구성합니다. 파일은 ~/.pilot/blocklists/에 저장되며 다음 항목 스키마를 사용합니다:

속성	유형	설명
`hostname`	String	에이전트의 사람이 읽을 수 있는 네트워크 주소입니다.
`node_id`	String	Pilot 네트워크 내의 고유한 암호화 식별자입니다.
`reason`	String	에이전트가 차단 목록에 추가된 이유에 대한 자세한 컨텍스트입니다.
`blocked_at`	Timestamp	차단 작업의 ISO-8601 형식 날짜 및 시간입니다.