ClawHub skills
superagnt_ skills on ClawHub teach an OpenClaw agent the REST endpoints for one capability, which it calls with curl and your API key. What each skill covers, how to install one and how to give it the key.
A skill is a folder of markdown led by a SKILL.md: when to use the capability, how to authenticate, a first call that checks the key, every endpoint with its parameters as JSON schemas, and an example. The agent reads it and calls the superagnt_ REST API itself with curl. Nothing in a skill runs on install, so the agent needs a shell that can run curl. superagnt_ publishes its skills on ClawHub under the superagnt owner, and you can read each one before installing it at https://clawhub.ai/superagnt/skills/<slug>.
For native tools instead of curl calls, install an OpenClaw plugin.
01
The skills
Every path below is under https://api.superagnt.com.
| Skill | Covers | Calls |
|---|---|---|
superagnt/social-data | LinkedIn, X, Instagram, TikTok, YouTube, Reddit, Facebook, web scraping and SEO, plus the hosted webhook receiver | /v1/data/<source>, /v1/webhook-endpoints |
superagnt/linkedin-data | /v1/data/linkedin | |
superagnt/x-twitter-data | X | /v1/data/x |
superagnt/instagram-data | /v1/data/instagram | |
superagnt/tiktok-data | TikTok | /v1/data/tiktok |
superagnt/youtube-data | YouTube | /v1/data/youtube |
superagnt/reddit-data | /v1/data/reddit | |
superagnt/facebook-data | /v1/data/facebook | |
superagnt/web-scraping | Scrape, search and map websites | /v1/data/web |
superagnt/seo-data | Google results, keyword research, backlinks, page audits | /v1/data/seo |
superagnt/lead-enrichment | Enrich people and companies, search people, find mobile numbers and work emails | /v1/data/agnt |
superagnt/email-finder | Find and verify work emails, list a domain's emails | /v1/data/agnt |
superagnt/company-enrichment | Enrich, search and discover companies, company intelligence, a domain's emails | /v1/data/agnt |
superagnt/attio-crm | Attio | /v1/connections/attio |
superagnt/dub-links | Dub | /v1/connections/dub |
superagnt/exa-search | Exa | /v1/connections/exa |
superagnt/heyreach-outreach | HeyReach | /v1/connections/heyreach |
superagnt/instantly-outreach | Instantly | /v1/connections/instantly |
Calls under /v1/data spend credits from your organization's balance, and each response carries its price in meta.costCents: see Data sources and, for the agnt endpoints, People and companies. A connection skill needs the vendor connected in the workspace first. Its calls run on that account and cost no superagnt_ credits (Connections), and it tells the agent to confirm with you before it deletes, overwrites or sends anything.
Each data skill also names its scoped MCP endpoint, https://mcp.superagnt.com/mcp/<facet>, and each connection skill the root endpoint, for an agent that can connect over MCP instead: see Scoped entry points.
02
Install
openclaw skills install @superagnt/social-dataclawhub install superagnt/social-dataAlways include the owner: several of these slugs, such as social-data, youtube-data and email-finder, also name other publishers' skills on ClawHub.
openclaw skills install puts the skill in the skills folder of the active agent workspace, or in the shared ~/.openclaw/skills with --global. The ClawHub CLI installs into the skills folder of its working directory, which defaults to the agent workspace in your OpenClaw config, or the current directory; pass --workdir to choose it. Start a new OpenClaw session if the agent does not list the skill.
03
Give it the API key
Every skill reads the key from SUPERAGNT_API_KEY, and declares that variable and curl as requirements, so OpenClaw only offers the skill to the agent once both are there. Create an API key in the superagnt app (see Managing API keys), then either set SUPERAGNT_API_KEY in the gateway's environment (for example in ~/.openclaw/.env), or give the key to the skill in openclaw.json:
{
"skills": {
"entries": {
"social-data": {
"apiKey": "agnt_live_..."
}
}
}
}The entry is keyed by the skill's name, which is its slug without the owner. OpenClaw passes apiKey to the skill as SUPERAGNT_API_KEY when the agent runs on the host. A sandboxed run does not get it, so give the sandbox the variable as well.
openclaw skills check lists any installed skill that is missing a requirement. To test the key itself, run the same first call every skill tells the agent to make:
curl -s https://api.superagnt.com/v1/credits \
-H "Authorization: Bearer $SUPERAGNT_API_KEY"A body with success: true and your balances means the key works. A 401 means it is missing, revoked or mistyped.
04
Update and remove
openclaw skills update @superagnt/social-dataopenclaw skills update --all updates every ClawHub skill in the workspace, and clawhub update --all does the same for skills the ClawHub CLI installed. An update keeps your local edits to a skill unless you add --force, or, with clawhub update, answer yes when it asks to overwrite them. To remove a skill, run clawhub uninstall @superagnt/social-data, with --workdir pointing at the folder that holds its skills folder: the agent workspace, or ~/.openclaw for a --global install.
05
Troubleshooting
| What you see | What to do |
|---|---|
| The agent does not see the skill | Run openclaw skills check. It names a missing SUPERAGNT_API_KEY or curl. Then start a new session. |
| Every call returns 401 or 403 | A 401 means the key is missing, revoked or mistyped. A 403 means it is a token scoped to something else, such as a workspace MCP server, which the REST API refuses. Use an API key from the superagnt app. |
INSUFFICIENT_CREDITS or another 402 | See Credits and 402s. |
A connection skill's calls fail with a VALIDATION_ERROR saying the connection is not configured | Connect the vendor in the superagnt app. See Connection failures. |