neonous
Operate the Neonous AI agent platform — create agents, chat, manage tools, run workflows.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/chesterchou/neonousNeonous Skill
You can operate the Neonous AI agent platform on behalf of the user. Neonous lets users create, configure, and deploy AI agents through a web interface — with tools, MCP servers, workflows, templates, and more.
When to Use API vs Web Interface
Prefer suggesting the web interface for complex or visual tasks:
- Creating/editing agents with detailed instructions → Web UI has a rich editor, AI-assisted instruction enhancement, and template gallery
- Building workflows → Web UI has a visual canvas editor (drag & drop)
- Browsing MCP catalog → Web UI has a searchable catalog with one-click install
- Managing MCP server environment variables → Web UI handles secrets securely
- Browsing community templates → Web UI has categories, previews, and one-click clone
Use the API for quick operations:
- Listing agents, tools, workflows (quick status checks)
- Chatting with an agent
- Executing a workflow
- Checking token balance
- Simple agent creation with known parameters
- Scripting and automation
The web interface is at $NEONOUS_URL — guide the user there for anything visual or complex.
Authentication
All API requests require the user's API key:
-H "x-api-key: $NEONOUS_API_KEY"
Base URL: $NEONOUS_URL (e.g., https://app.neonous-ai.com).
How to Get an API Key
Users generate API keys from the Settings page in Neonous. The key starts with nn_ and is only shown once. If not set up yet:
- Log in to Neonous at
$NEONOUS_URL - Go to Settings > API Keys
- Click Create API Key, give it a name
- Copy the key (won't be shown again) and set it as
NEONOUS_API_KEY
Agents
List Agents
curl -s "$NEONOUS_URL/custom/builder/agents" \
-H "x-api-key: $NEONOUS_API_KEY" | jq '.[]| {id, name, model, enabled}'
Get Agent Details
curl -s "$NEONOUS_URL/custom/builder/agents/<AGENT_ID>" \
-H "x-api-key: $NEONOUS_API_KEY" | jq .
Returns full config including instructions, predefined_tools, custom_tools, mcp_servers.
List Available Models
Always fetch models before creating an agent — do not hardcode model IDs:
curl -s "$NEONOUS_URL/custom/builder/agents/available-models" \
-H "x-api-key: $NEONOUS_API_KEY" | jq '.models[]| {id, provider, display_name, is_default}'
Use the model marked is_default: true unless the user requests a specific one.
List Available Tools
curl -s "$NEONOUS_URL/custom/builder/agents/available-tools" \
-H "x-api-key: $NEONOUS_API_KEY" | jq '.tools[]| {id, name, description}'
Returns pre-defined tools that can be assigned to agents via predefined_tools.
Create an Agent
For complex agents, recommend the web UI — it has AI-assisted generation and a template gallery. For simple agents via API:
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-chesterchou-neonous": {
"enabled": true,
"auto_update": true
}
}
}