openclaw-new-agent

Creates OpenClaw agents with directive files, workspace scaffolding, and openclaw.json registration via CLI.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/diazMelgarejo/orama-system --skill openclaw-new-agent-diazmelgarejo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openclaw-new-agent
Source: https://github.com/diazMelgarejo/orama-system/tree/main/bin/orama-system/skills/openclaw-skills/skills/openclaw-new-agent
Command: npx skills add https://github.com/diazMelgarejo/orama-system --skill openclaw-new-agent-diazmelgarejo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually creating OpenClaw agents often results in missing directive files, invalid openclaw.json edits, and broken sub-agent wiring. This Skill standardizes agent creation through the verified openclaw agents add CLI so every agent is registered correctly in one pass. ## Core Features & Use Cases - CLI-Based Agent Scaffolding: Runs openclaw agents add to register the agent in openclaw.json and auto-generate SOUL.md, USER.md, AGENTS.md, TOOLS.md, and an IDENTITY.md template. - Sub-Agent Wiring: Binds sub-agents to parent agents via openclaw agents bind so parent-child execution is explicit and callable. - Auth and Naming Enforcement: Validates lowercase-hyphenated agent IDs and checks per-agent auth stores before assuming provider access. - Use Case: A developer splitting responsibilities into specialized sub-agents runs this Skill to create each agent, fill in IDENTITY.md and SECURITY.md, and bind them to the parent without hand-editing JSON. ## Quick Start Create a new OpenClaw agent named research-bot as a sub-agent of my main agent and wire the parent binding.

Frequently Asked Questions about openclaw-new-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a new OpenClaw agent?

Run `openclaw agents add <agent_id>` with a model and workspace path. The CLI registers the agent in openclaw.json, scaffolds the workspace directory, and auto-generates SOUL.md, USER.md, AGENTS.md, TOOLS.md, and an IDENTITY.md template.

How do I create a sub-agent in OpenClaw?

Create the sub-agent with `openclaw agents add`, then bind it to the parent using `openclaw agents bind <parent_id> --allow <agent_id>`. Sub-agents without parent allow-list wiring will not be callable.

Can I edit openclaw.json manually with jq to add an agent?

No. Hand-editing openclaw.json is deprecated because an invalid shape can pass jq but fail `openclaw config validate` and break the live gateway. Always use the `openclaw agents add` and `agents bind` CLI commands instead.

Why can't my new OpenClaw agent call a configured provider?

Auth is per-agent, not per-provider. Each agent has an isolated auth store, so a provider showing as configured in the model catalog does not mean the new agent has credentials. Run `openclaw models auth login --provider <id>` for that agent.

What files does an OpenClaw agent need?

An agent needs six directive files: SOUL.md, IDENTITY.md, USER.md, AGENTS.md, TOOLS.md, and SECURITY.md. The CLI auto-creates most of them, but SECURITY.md and a filled-in IDENTITY.md typically must be written by hand.