IPFS Client for Openclaw

A read-only assistant for fetching and exploring IPFS and IPNS content via gateways or local nodes.

apexfork
v0.1.0
Feb 16, 2026
0
749
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install ipfs-client

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install ipfs-client using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is IPFS Client?

The IPFS Client is a specialized tool within the Openclaw Skills ecosystem designed for secure, read-only interaction with the InterPlanetary File System. It allows developers and researchers to seamlessly fetch files, explore complex DAG structures, and resolve IPNS addresses without the risks associated with state-modifying operations like pinning or publishing. By bridging the gap between local IPFS nodes and public HTTP gateways, this skill provides a flexible environment for accessing decentralized data. Whether you are inspecting NFT metadata or exploring distributed web content, IPFS Client ensures a safe and efficient workflow using familiar CLI tools like curl and the native ipfs command line interface.

IPFS Client Use Cases

  • Fetching files and directory listings from decentralized storage networks.
  • Inspecting NFT metadata and associated media assets hosted on IPFS.
  • Resolving IPNS (InterPlanetary Name System) names to retrieve the latest version of mutable content.
  • Exploring Merkle DAG structures and links for complex linked-data objects.
  • Validating file hashes and checking content-routing availability across the global network.

How IPFS Client Works

  1. The skill detects available local tools, prioritizing the native ipfs CLI followed by curl for HTTP gateway access.
  2. Users provide a CID (Content Identifier) or IPNS name for the desired lookup.
  3. The agent configures the environment to use either a local node (localhost:8080) or a pool of public gateways like ipfs.io and dweb.link.
  4. Data is retrieved and parsed into a readable format, often utilizing tools like jq for JSON metadata or cat for raw text.
  5. For advanced queries, the skill traverses DAG links or queries DHT providers to locate specific content blocks across the network.

IPFS Client Setup

To use the IPFS Client within your Openclaw Skills environment, ensure you have curl or the ipfs CLI installed. You can configure your preferred gateway as an environment variable to prioritize specific nodes:

# Set a public gateway for instant access
export IPFS_GATEWAY="https://ipfs.io"

# Or use a local node for better performance
export IPFS_GATEWAY="http://localhost:8080"

Verify your setup by running a simple header check against a known hash:

curl -I "$IPFS_GATEWAY/ipfs/QmYwAPJzv5CZsnAzt8auVZcgSDUbkXz2x4k2k5xmj8W1gR"

IPFS Client Data Schema & Taxonomy

The IPFS Client processes several Web3-specific data structures. The following table describes the primary data types handled by these Openclaw Skills:

Data Type Format Description
CID String Content Identifier (v0 or v1) representing unique, immutable data hashes.
DAG JSON Merkle Directed Acyclic Graph structure used for representing linked data.
IPNS DNS/Hash Mutable pointers to underlying IPFS content identifiers for dynamic content.
Metadata JSON/MIME Content types including application/json, text/html, and various image formats.

IPFS Client Advanced Features

  • Recursive DAG traversal to inspect deep link structures and object references.
  • Integration with ENS (Ethereum Name Service) to resolve .eth domains to IPFS hashes via DNS TXT records.
  • Content routing analysis using dht findprovs to identify nodes currently hosting specific data blocks.
  • Multi-gateway fallback strategies to ensure high availability when public nodes encounter rate limits.
  • Deterministic hash generation using add --only-hash to verify local files against remote hashes without network publishing.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Requires
Github Stars: 0
forks: 0

Featured*