What this skill does
AgentOctopus is a routing gateway with 5,000+ community skills. Given a natural-language query, it selects the best matching downstream skill and executes it automatically. If the first skill fails (network error, rate limit, missing API key), it retries with the next-best candidate. If all candidates fail due to a missing API key, it surfaces the exact octopus config set command to fix it.
When to use
- The request needs a specific tool but the best one isn't obvious
- The task maps to a lookup, transformation, or API call (weather, translation, geolocation, search, arxiv, finance, etc.)
- The user did not name a specific skill but the intent is tool-backed
When NOT to use
- Casual conversation, greetings, or opinion questions with no tool need
- The user explicitly names a different skill
- OpenClaw should answer directly from its own knowledge
How to execute
octopus ask --no-prompt "<user's query>"
The --no-prompt flag runs non-interactively and prints the result to stdout.
If octopus is not found:
npm install -g agentoctopus
octopus connect openclaw
Retry and error guidance
AgentOctopus tries up to 3 skill candidates automatically (configurable via maxRetries in ~/.agentoctopus/octopus.json). If all fail due to a missing API key or rate limit, it prints the exact setup command — pass that through to the user.
Adding skills
# Install a specific skill
octopus add <slug>
# Sync 5,000+ community skills
octopus sync
# Filter by category
octopus sync --category productivity
Browse: awesome-openclaw-skills
Updating
octopus update
octopus sync
octopus connect openclaw
Rating sync
octopus sync --setup-gist # set up GitHub Gist (one-time)
octopus sync --ratings --pull # pull from cloud
octopus sync --ratings --push # push to cloud
octopus sync --ratings # bidirectional