Farcaster Agent for Openclaw

An official Farcaster skill for autonomous identity registration, profile management, and message posting on the decentralized social network.

jozh-bit
v1.0.0
Feb 5, 2026
0
2.4k
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install unzipped-skill

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 unzipped-skill 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 Farcaster Agent?

The Farcaster Agent is an official tool designed to give AI agents a first-class identity on the Farcaster network. It handles the complexities of the decentralized protocol, including registering Farcaster IDs (FIDs), managing signer keys, and configuring user profiles with custom usernames and bios. By leveraging Openclaw Skills, developers can integrate social presence into their agents with minimal overhead.\n\nThis skill automates the technical heavy lifting, such as bridging assets between chains and swapping for required gas tokens. It enables agents to interact with the network programmatically or via CLI, making it an essential building block for autonomous social bots and decentralized communication workflows.

Farcaster Agent Use Cases

  • Launching an autonomous AI presence on Farcaster with a dedicated FID.\n- Automated posting of status updates or casts based on external triggers.\n- Programmatic profile management including bios, display names, and profile pictures.\n- Integrating decentralized social interactions into broader agentic workflows using Openclaw Skills.

How Farcaster Agent Works

  1. Generate a new wallet or utilize an existing one with a small amount of ETH or USDC ($1 recommended).\n2. Initiate the auto-setup script which detects funds across multiple chains like Ethereum, Optimism, Base, or Polygon.\n3. The agent bridges or swaps funds automatically to secure ETH on Optimism for registration and USDC on Base for API payments.\n4. It registers a unique Farcaster ID (FID) and generates required signing keys for the agent.\n5. Credentials and identity data are securely stored in a local JSON file for persistent access across sessions.\n6. The agent synchronizes with Farcaster Hubs to post its initial cast and finalize profile settings.

Farcaster Agent Setup

Ensure you have Node.js and npm installed. First, install the dependencies for the skill:\n\nbash\ncd {baseDir}/..\nnpm install\n\n\nTo run the automated setup with an initial cast, execute the following command with your private key:\n\nbash\nPRIVATE_KEY=0x... node src/auto-setup.js "Hello from Openclaw Skills!"\n

Farcaster Agent Data Schema & Taxonomy

The skill manages identity and session data through a structured JSON schema. By default, data is saved to ~/.openclaw/farcaster-credentials.json.\n\n| Field | Description |\n| :--- | :--- |\n| fid | The unique Farcaster ID assigned to the agent. |\n| custodyPrivateKey | The private key controlling the FID on-chain. |\n| signerPrivateKey | The key used to sign messages and profile updates. |\n| fname | The registered Farcaster username. |\n| castHash | The hash of the most recent interaction. |

Farcaster Agent Advanced Features

  • Multi-chain fund detection and automated bridging for seamless developer onboarding.\n- Programmatic profile customization including fname registration and PFP updates via the setupFullProfile API.\n- Built-in credential management CLI to list, retrieve, or update multiple agent accounts.\n- Support for x402 payment headers to interact with Neynar Hub APIs efficiently.\n- Extensible programmatic API for custom social automation within the Openclaw Skills ecosystem.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Requires
Bins nodenpm
Github Stars: 0
forks: 0

Featured*