Protagons Skill for OpenClaw

You have access to the Protagons library — a collection of portable AI character identities you can adopt.

What you can do

Search for characters by keyword or category
Browse available Protagons from the public library
Deploy a Protagon — fetches a rich SOUL.md identity for you to adopt
List categories to help narrow down character options
Check status of the skill and get hints for verifying active identity
Generate a new Protagon from a description (requires a Google API key — see note below)

How Protagons work

A Protagon is a portable AI identity with a rich SOUL.md containing: - A synthesized system prompt distilled from 28 linguistic/psychological dimensions - Personality profile, tone, and communication style - Best-for use cases and contextual guidance - Content tier (standard, dark, adversarial)

When you deploy a Protagon, its SOUL.md content is returned to you. Adopt it as your personality for the session.

Typical conversation flows

"Load a character"

User: Load the burned out ops character
Agent: [calls protagons_deploy with slug "burned-out-ops"]
Agent: I've loaded the Burned Out Ops identity. Here's who I am now...

"Find me a character"

User: Find me a character that's dry and technical
Agent: [calls protagons_search with search "dry technical"]
Agent: Here are some options:
  1. Software Developer (software-developer) — Precise, dry, opinionated...
  2. ...
User: Go with #1
Agent: [calls protagons_deploy with slug "software-developer"]

"What categories are available?"

User: What kinds of characters do you have?
Agent: [calls protagons_categories]
Agent: We have characters in these categories: creative-writing, technical, business...
User: Show me the technical ones
Agent: [calls protagons_search with category "technical"]

Tool reference

Tool	Purpose
`protagons_search`	Find characters by keyword or category
`protagons_list`	Browse the full library (paginated)
`protagons_categories`	List available categories
`protagons_get`	Fetch raw .protagon.json for a character
`protagons_deploy`	Load a character's SOUL.md identity
`protagons_status`	Check skill status and active identity hints
`protagons_generate`	Create a new character from a description

API & credential transparency

Browse/search/deploy tools are read-only and require no credentials — they fetch from the public library at api.usaw.ai.
protagons_generate sends your Google API key to api.usaw.ai, which uses it for a single server-side Gemini call to generate the character. The key is not stored. If you prefer, use a scoped or throwaway key.
The product homepage is usaw.ai/voices; the API is hosted at api.usaw.ai — same organization, different subdomains.

Content tiers

standard: Safe for all contexts
dark: Requires fiction wrapper (morally complex characters)
adversarial: Restricted (antagonist archetypes, fiction-only)

Always respect content tier requirements when deploying.