게이트웨이 또는 로컬 노드를 통해 IPFS 및 IPNS 콘텐츠를 가져오고 탐색하기 위한 읽기 전용 보조 도구입니다.
설치 및 다운로드
1. ClawHub CLI
레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.
npx clawhub@latest install ipfs-client
2. 수동 설치
스킬 폴더를 다음 위치 중 하나로 복사하세요
~/.openclaw/skills/ <project>/skills/ 우선순위: 워크스페이스 > 로컬 > 번들
3. 프롬프트 설치
이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.
Clawhub를 사용해서 ipfs-client 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).
다운로드를 원하시나요?
ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.
IPFS Client란 무엇인가요?
IPFS Client는 InterPlanetary File System과의 안전한 읽기 전용 상호작용을 위해 설계된 Openclaw Skills 생태계의 전문 도구입니다. 개발자와 연구자는 파일을 원활하게 가져오고, 복잡한 DAG 구조를 탐색하며, 고정(pinning)이나 게시(publishing)와 같은 상태 변경 작업의 위험 없이 IPNS 주소를 확인할 수 있습니다. 로컬 IPFS 노드와 공용 HTTP 게이트웨이를 연결함으로써 이 스킬은 탈중앙화 데이터에 접근하기 위한 유연한 환경을 제공합니다. NFT 메타데이터를 검사하든 분산형 Web 콘텐츠를 탐색하든, IPFS Client는 curl 및 네이티브 ipfs 명령줄 인터페이스와 같은 익숙한 CLI 도구를 사용하여 안전하고 효율적인 워크플로우를 보장합니다.
IPFS Client 활용 사례
- 탈중앙화 저장소 네트워크에서 파일 및 디렉터리 목록 가져오기.
- IPFS에 호스팅된 NFT 메타데이터 및 관련 미디어 자산 검사.
- IPNS (InterPlanetary Name System) 이름을 확인하여 가변 콘텐츠의 최신 버전 검색.
- 복잡한 링크 데이터 객체를 위한 Merkle DAG 구조 및 링크 탐색.
- 파일 해시 검증 및 글로벌 네트워크 전체의 콘텐츠 라우팅 가용성 확인.
IPFS Client 작동 원리
- 이 스킬은 사용 가능한 로컬 도구를 감지하며, 네이티브 ipfs CLI를 우선시하고 HTTP 게이트웨이 접근에는 curl을 사용합니다.
- 사용자는 조회하려는 CID (Content Identifier) 또는 IPNS 이름을 제공합니다.
- 에이전트는 로컬 노드 (localhost:8080) 또는 ipfs.io 및 dweb.link와 같은 공용 게이트웨이 풀을 사용하도록 환경을 구성합니다.
- 데이터는 검색되어 읽기 쉬운 형식으로 파싱되며, JSON 메타데이터에는 jq와 같은 도구를, 원시 텍스트에는 cat을 자주 활용합니다.
- 고급 쿼리의 경우, 이 스킬은 DAG 링크를 탐색하거나 DHT 공급자를 쿼리하여 네트워크 전반에서 특정 콘텐츠 블록을 찾습니다.
IPFS Client 설정 가이드
Openclaw Skills 환경 내에서 IPFS Client를 사용하려면 curl 또는 ipfs CLI가 설치되어 있는지 확인하십시오. 특정 노드를 우선시하기 위해 선호하는 게이트웨이를 환경 변수로 구성할 수 있습니다:
# 즉시 접근을 위해 공용 게이트웨이 설정
export IPFS_GATEWAY="https://ipfs.io"
# 또는 더 나은 성능을 위해 로컬 노드 사용
export IPFS_GATEWAY="http://localhost:8080"
알려진 해시에 대해 간단한 헤더 검사를 실행하여 설정을 확인하십시오:
curl -I "$IPFS_GATEWAY/ipfs/QmYwAPJzv5CZsnAzt8auVZcgSDUbkXz2x4k2k5xmj8W1gR"
IPFS Client 데이터 스키마 및 분류 체계
IPFS Client는 몇 가지 Web3 고유 데이터 구조를 처리합니다. 다음 표는 이러한 Openclaw Skills에서 다루는 주요 데이터 유형을 설명합니다:
| 데이터 유형 | 형식 | 설명 |
|---|---|---|
| CID | String | 고유하고 불변하는 데이터 해시를 나타내는 콘텐츠 식별자 (v0 또는 v1). |
| DAG | JSON | 링크 데이터를 표현하는 데 사용되는 Merkle 비순환 방향 그래프 구조. |
| IPNS | DNS/Hash | 동적 콘텐츠를 위해 기본 IPFS 콘텐츠 식별자를 가리키는 가변 포인터. |
| Metadata | JSON/MIME | application/json, text/html 및 다양한 이미지 형식을 포함한 콘텐츠 유형. |
IPFS Client 고급 기능
- 깊은 링크 구조 및 객체 참조를 검사하기 위한 재귀적 DAG 탐색.
- DNS TXT 레코드를 통해 .eth 도메인을 IPFS 해시로 확인하는 ENS (Ethereum Name Service) 통합.
- dht findprovs를 사용한 콘텐츠 라우팅 분석으로 특정 데이터 블록을 호스팅하는 노드 식별.
- 공용 노드가 속도 제한에 직면할 때 고가용성을 보장하는 다중 게이트웨이 페일오버 전략.
- 네트워크 게시 없이 로컬 파일과 원격 해시를 검증하기 위한 add --only-hash를 사용한 결정적 해시 생성.
SKILL.md
로드 중
관련 Openclaw 스킬
Exec Error Doctor
명령 실행 실패, shell 오류 및 API schema 불일치를 분류하고 해결하도록 설계된 전문 진단 엔진입니다.
swift-patterns
Apple 네이티브 모범 사례와 최신 API 표준을 사용하여 SwiftUI 애플리케이션을 빌드, 검토 및 리팩터링하기 위한 포괄적인 프레임워크입니다.
Gousto Meal Picker
사용자 지정 식이 요법 규칙과 영양 선호도에 따라 매주 식단 키트를 선택하는 Gousto 고객을 위한 스마트 자동화 도구입니다.
Training Manager
Openclaw Skills를 위해 설계된 포괄적인 워크스페이스 관리 도구로, AI agent의 동작과 기억을 스캐폴딩, 로깅 및 검증합니다.
Resilient Coding Agent
tmux를 사용하여 장기 실행 AI 코딩 에이전트를 오케스트레이터와 분리하여 작업 영속성을 극대화하는 전문 기술입니다.
Japan Finance Agent
6개의 주요 일본 금융 소스에서 데이터를 수집하여 포괄적인 기업 및 거시 경제 분석을 제공하는 통합 MCP agent입니다.
추천*
