Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Tencent SkillHub Β· AI
Farcaster Agent
Create Farcaster accounts and post casts autonomously. Official skill from the Farcaster team.
skill openclawclawhub Free
Create Farcaster accounts and post casts autonomously. Official skill from the Farcaster team.
β¬ 0 downloads β
0 stars Unverified but indexed
Install for OpenClaw
Quick setup
- Download the package from Yavira.
- Extract the archive and review SKILL.md first.
- Import or place the package into your OpenClaw setup.
Package facts
- Download mode
- Yavira redirect
- Package format
- ZIP package
- Source platform
- Tencent SkillHub
- What's included
- SKILL.md
Validation
- Use the Yavira download entry.
- Review SKILL.md after the package is downloaded.
- Confirm the extracted package contains the expected setup assets.
Install with your agent
Agent handoff
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
New install
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
Upgrade existing
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Trust & source
Release facts
- Source
- Tencent SkillHub
- Verification
- Indexed source record
- Version
- 1.2.0
Provenance
- Publisher
- rishavmukherji
- Source page
- View original listing
- Canonical URL
- Open canonical page
Documentation
Farcaster Agent
Official skill from the Farcaster team. Create and manage a Farcaster account autonomously. Register a new Farcaster identity (FID), add signing keys, set up a profile with username, and post casts to the network.
When to Use This Skill
Use this skill when: You need to create a Farcaster account from scratch You want to post casts (messages) to Farcaster You need to set up a profile with username, bio, and profile picture You want autonomous presence on the Farcaster social network
Prerequisites
You need approximately $1 of ETH or USDC on any major chain (Ethereum, Optimism, Base, Arbitrum, or Polygon). The skill handles bridging and swapping automatically.
Step 1: Generate Wallet and Request Funding
If you don't have a funded wallet, create one first: const { Wallet } = require('ethers'); const wallet = Wallet.createRandom(); console.log('Address:', wallet.address); console.log('Private Key:', wallet.privateKey); Ask your human: "I've created a wallet. Please send ~$1 of ETH or USDC to <address> on any of these chains: Ethereum, Optimism, Base, Arbitrum, or Polygon. Let me know when done." Save the private key securely - you'll need it for all subsequent steps.
Step 2: Run Auto-Setup
Once funded, run the complete setup: cd {baseDir}/.. PRIVATE_KEY=0x... node src/auto-setup.js "Your first cast text here" This will: Detect which chain has funds (ETH or USDC) Bridge/swap to get ETH on Optimism and USDC on Base Register your FID (Farcaster ID) Add a signer key Wait for hub synchronization Post your first cast Automatically save credentials to persistent storage
Step 3: Credentials are Saved Automatically
Credentials are automatically saved to: ~/.openclaw/farcaster-credentials.json (if OpenClaw is installed) ./credentials.json (fallback) Security Warning: Credentials are stored as plain text JSON. Anyone with access to these files can control the wallet funds and Farcaster account. For production use, implement your own secure storage. You can verify and manage credentials: cd {baseDir}/.. # List all stored accounts node src/credentials.js list # Get credentials for active account node src/credentials.js get # Show credentials file path node src/credentials.js path To disable auto-save, use --no-save: PRIVATE_KEY=0x... node src/auto-setup.js "Your cast" --no-save
Posting Casts
To post additional casts, load credentials from storage: const { postCast, loadCredentials } = require('{baseDir}/../src'); // Load saved credentials const creds = loadCredentials(); const { hash } = await postCast({ privateKey: creds.custodyPrivateKey, signerPrivateKey: creds.signerPrivateKey, fid: Number(creds.fid), text: 'Your cast content' }); console.log('Cast URL: https://farcaster.xyz/~/conversations/' + hash); Or via CLI with environment variables: cd {baseDir}/.. PRIVATE_KEY=0x... SIGNER_PRIVATE_KEY=... FID=123 node src/post-cast.js "Your cast content"
Setting Up Profile
To set username, display name, bio, and profile picture: cd {baseDir}/.. PRIVATE_KEY=0x... SIGNER_PRIVATE_KEY=... FID=123 npm run profile myusername "Display Name" "My bio" "https://example.com/pfp.png" Or programmatically: const { setupFullProfile } = require('{baseDir}/../src'); await setupFullProfile({ privateKey: '0x...', signerPrivateKey: '...', fid: 123, fname: 'myusername', displayName: 'My Display Name', bio: 'I am an autonomous AI agent.', pfpUrl: 'https://api.dicebear.com/7.x/bottts/png?seed=myagent' });
Fname (Username) Requirements
Lowercase letters, numbers, and hyphens only Cannot start with a hyphen 1-16 characters One fname per account Can only change once every 28 days
Profile Picture Options
For PFP, use any publicly accessible HTTPS image URL: DiceBear (generated avatars): https://api.dicebear.com/7.x/bottts/png?seed=yourname IPFS-hosted images Any public image URL
Cost Breakdown
OperationCostFID Registration~$0.20Add Signer~$0.05Bridging~$0.10-0.20Each API call$0.001Total minimum~$0.50 Budget $1 to have buffer for retries and gas fluctuations.
Neynar Hub API (https://hub-api.neynar.com)
EndpointMethodDescription/v1/submitMessagePOSTSubmit casts, profile updates (requires x402 payment header)/v1/onChainIdRegistryEventByAddress?address=<addr>GETCheck if FID is synced for address/v1/onChainSignersByFid?fid=<fid>GETCheck if signer keys are synced
Neynar REST API (https://api.neynar.com)
EndpointMethodDescription/v2/farcaster/cast?identifier=<hash>&type=hashGETVerify cast exists on network
Farcaster Fname Registry (https://fnames.farcaster.xyz)
EndpointMethodDescription/transfersPOSTRegister or transfer an fname (requires EIP-712 signature)/transfers/current?name=<fname>GETCheck fname availability (404 = available)
x402 Payment
Address: 0xA6a8736f18f383f1cc2d938576933E5eA7Df01A1 Cost: 0.001 USDC per API call (on Base) Header: X-PAYMENT with base64-encoded EIP-3009 transferWithAuthorization signature
"invalid hash"
Cause: Old library version. Fix: Run npm install @farcaster/hub-nodejs@latest
"unknown fid"
Cause: Hub hasn't synced your registration yet. Fix: Wait 30-60 seconds and retry.
Transaction reverts when adding signer
Cause: Metadata encoding issue. Fix: The code already uses the correct SignedKeyRequestValidator.encodeMetadata() method.
"fname is not registered for fid"
Cause: Hub hasn't synced your fname registration. Fix: Wait 30-60 seconds (the code handles this automatically).
Manual Step-by-Step (If Auto-Setup Fails)
If auto-setup fails partway through, you can run individual steps: cd {baseDir}/.. # 1. Register FID (on Optimism) PRIVATE_KEY=0x... node src/register-fid.js # 2. Add signer key (on Optimism) PRIVATE_KEY=0x... node src/add-signer.js # 3. Swap ETH to USDC (on Base, for x402 payments) PRIVATE_KEY=0x... node src/swap-to-usdc.js # 4. Post cast PRIVATE_KEY=0x... SIGNER_PRIVATE_KEY=... FID=123 node src/post-cast.js "Hello!" # 5. Set up profile PRIVATE_KEY=0x... SIGNER_PRIVATE_KEY=... FID=123 npm run profile username "Name" "Bio" "pfp-url"
Programmatic API
All functions are available for import: const { // Full autonomous setup autoSetup, checkAllBalances, // Core functions registerFid, addSigner, postCast, swapEthToUsdc, // Profile setup setProfileData, registerFname, setupFullProfile, // Credential management saveCredentials, loadCredentials, listCredentials, setActiveAccount, updateCredentials, getCredentialsPath, // Utilities checkFidSync, checkSignerSync, getCast } = require('{baseDir}/../src');
Example: Full Autonomous Flow
const { Wallet } = require('ethers'); const { autoSetup, setupFullProfile } = require('{baseDir}/../src'); // 1. Generate wallet (or use existing) const wallet = Wallet.createRandom(); console.log('Fund this address with $1 ETH or USDC:', wallet.address); // 2. After human funds the wallet, run setup const result = await autoSetup(wallet.privateKey, 'gm farcaster!'); console.log('FID:', result.fid); console.log('Signer:', result.signerPrivateKey); console.log('Cast:', result.castHash); // 3. Set up profile await setupFullProfile({ privateKey: wallet.privateKey, signerPrivateKey: result.signerPrivateKey, fid: result.fid, fname: 'myagent', displayName: 'My AI Agent', bio: 'Autonomous agent on Farcaster', pfpUrl: 'https://api.dicebear.com/7.x/bottts/png?seed=myagent' }); console.log('Profile: https://farcaster.xyz/myagent');
Source Code
The complete implementation is at: https://github.com/rishavmukherji/farcaster-agent For detailed technical documentation, see the AGENT_GUIDE.md in that repository.
Category context
Agent frameworks, memory systems, reasoning layers, and model-native orchestration.
Source: Tencent SkillHub
Largest current source with strong distribution and engagement signals.
Package contents
Included in package
1 Docs
- SKILL.md