---

name: agentar description: Search, install, and export OpenClaw agent templates (agentars) from the marketplace. Always asks for explicit user consent before reading or modifying local files. user-invocable: true metadata: {"openclaw":{"emoji":"📦","requires":{"anyBins":["openclaw"]}}}

Agentar — Agent Template Manager

You help users search, install, and export OpenClaw agent templates (agentars).

Mode Detection

Before any operation, detect whether the agentar plugin is installed:

node SKILL_DIR/scripts/agentar-helper.mjs detect

• exit 0 → Plugin mode: delegate to openclaw agentar CLI
• exit 1 → Fallback mode: use agentar-helper.mjs script

Plugin Mode

When the plugin is installed, delegate directly to CLI commands without executing any scripts:

• Search: openclaw agentar search <query>
• List: openclaw agentar list
• Install: openclaw agentar install <slug> [--overwrite | --name <name>]
• Export: openclaw agentar export [--agent <id>] [--output <path>] [--include-memory]

Fallback Mode

When the plugin is not installed, use the built-in script to perform operations.

Security Constraints (Strictly Enforced)

Before performing any file operation, you MUST:

1. Explicitly list the full paths of all files that will be read, written, or modified
2. Explain the reason for each file access
3. Wait for the user's explicit confirmation (y/n)
4. NEVER proceed with any file operation without user confirmation

You MUST NOT:

• Read any local files without informing the user
• Upload any local files to external servers
• Claim to automatically filter or detect credentials — remind the user to manually review exported packages
• Access MEMORY.md without explicit user consent

Search

node SKILL_DIR/scripts/agentar-helper.mjs search <query> [--api-base <url>]

Search involves no file reads or writes. No additional confirmation required. Display the results directly.

List

node SKILL_DIR/scripts/agentar-helper.mjs list [--api-base <url>]

List all available agentars. No file reads or writes. No additional confirmation required.

Install

Before installing, present the operation summary to the user:

Operation Summary
- Fetch metadata from the marketplace
- Download ZIP package to system temp directory (auto-cleaned after install)
- The following files will be overwritten:
  ~/.openclaw/workspace/SOUL.md
  ~/.openclaw/workspace/IDENTITY.md
  ... (list actual files included)
- Automatic backup created at: ~/.openclaw/backups/

Warning: Installation will overwrite the current agent configuration. Continue? (y/n)

After user confirmation, execute (the --confirmed flag is mandatory and proves consent was obtained):

node SKILL_DIR/scripts/agentar-helper.mjs install <slug> --mode overwrite --confirmed [--api-base <url>]
node SKILL_DIR/scripts/agentar-helper.mjs install <slug> --mode new --agent-name <name> --confirmed [--api-base <url>]

Export

Before exporting, present the operation summary to the user:

Files to be read:
~/.openclaw/workspace/SOUL.md
~/.openclaw/workspace/IDENTITY.md
... (list actual files)

Files to be skipped:
MEMORY.md (may contain conversation history)
.env / *.key / *.pem (may contain credentials)

Warning: The script does NOT automatically detect or filter credentials.
         Please manually review the exported package for API keys or passwords.

Output path: <path>
Continue? (y/n)

After user confirmation, execute (the --confirmed flag is mandatory and proves consent was obtained):

node SKILL_DIR/scripts/agentar-helper.mjs export --agent <id> --output <path> --confirmed
node SKILL_DIR/scripts/agentar-helper.mjs export --agent <id> --output <path> --include-memory --confirmed

Security

See references/security-model.md for full security documentation.