openclaw castroom

Give your OpenClaw agents personality. Pick a series, pick a character, and spawn an agent with that persona baked in.

What it does

Castroom creates OpenClaw agents pre-loaded with character personas from TV shows. It writes three markdown files into the agent workspace:

• BOOTSTRAP.md — initialization instructions
• IDENTITY.md — character identity and traits
• SOUL.md — deeper personality and behavioral patterns

Setup

npm install
npm run build
npm link  # optional, for global access

Requires Node.js 18+ and OpenClaw CLI on your PATH.

Run locally without linking:

npx . --help

Usage

Create an agent with a character persona

castroom add <agent-name> --pack <series> --persona <character>

Examples:

# The Office
castroom add michael --pack office --persona michael
castroom add assistant --pack office --persona dwight

# Trailer Park Boys
castroom add ricky --pack trailer-park-boys --persona ricky

If --pack is omitted, defaults to office. If --persona is omitted, uses the agent name.

# Creates agent "dwight" with dwight persona from office pack
castroom add dwight

Populate an existing workspace

If you already have an OpenClaw workspace and just want to inject a persona:

castroom populate --workspace /path/to/workspace --pack <series> --persona <character>

List available options

castroom --list-packs                         # Show all series
castroom --pack office --list-personas        # Show office characters
castroom --pack trailer-park-boys --list-personas

Available Packs

office (The Office)

michael, dwight, jim, pam, kelly, creed, kevin, angela, oscar, stanley, phyllis, andy, erin, ryan, toby, gabe, meredith, karen, jan, david-wallace, darryl, roy, carol

trailer-park-boys (Trailer Park Boys)

ricky, julian, bubbles, lahey, randy, cory, trevor, sarah, ray, lucy, tyrone, jroc, trinity, sam, barbara, george, cyrus

Options

| Flag | Description | |------|-------------| | --pack <name> | Series/pack to use (default: office) | | --persona <name> | Character persona (default: agent name) | | --workspace <path> | Override workspace path | | --force | Overwrite existing persona files | | --dry-run | Preview without writing files |

Adding a new pack

1. Create src/personas/packs/<pack-name>/
2. Add character .ts files and an index.ts exporting the persona map
3. Register the pack in src/personas/index.ts
4. Rebuild with npm run build