Skip to content

Characters & Skills

wy1024 edited this page Mar 17, 2026 · 2 revisions

Characters & Skills

ClawFleet lets you give each instance a unique personality and skill set — turning generic AI assistants into specialized team members.

Characters

A Character is a reusable persona definition. Think of it as a "job description" that shapes how an instance communicates and behaves.

How it works

When you assign a character to an instance, ClawFleet renders the character fields into OpenClaw's SOUL.md file — the core personality definition that the agent reads on every conversation turn. The character persists across all channels and sessions.

Character fields

Field Purpose Example
Name Character identity (required) Tony Stark
Bio Core role and identity Genius billionaire inventor, former CEO of Stark Industries
Background Backstory and experience Built the first Iron Man suit in a cave...
Communication Style How they speak and write Sharp, witty, dripping with sarcasm. Drops technical jargon mid-conversation.
Topics of Interest Subjects they care about Arc reactor technology, AI & robotics, nanotechnology
Personality Traits Key adjectives Brilliant, narcissistic, charismatic, impulsive

Creating a character

  1. Navigate to Assets → Character Config
  2. Click + Add Character
  3. Fill in the name and any persona fields (all fields except name are optional)
  4. Click Configure to save

Assigning a character to an instance

  1. Click Configure on an instance card
  2. In the Character Config section, select a character (or "None" to skip)
  3. Select a model and optionally a channel
  4. Click Configure

The character is injected before the gateway starts, so the instance uses the persona from its very first conversation.

Tips

  • Characters are shared — you can assign the same character to multiple instances
  • Keep it concise — OpenClaw injects SOUL.md into every conversation turn's context window, so shorter descriptions save tokens
  • Be specific — "Talks fast, uses pop culture references" is more effective than "friendly and helpful"

Skills

Each OpenClaw instance comes with 52 built-in skills and can install additional skills from the ClawHub marketplace (13,000+ community-contributed skills).

Skill types

Type Source Management
Bundled Ships with OpenClaw Read-only. Status depends on whether required binaries are available in the container.
Community Installed from ClawHub Install and uninstall per instance.

Skill status

  • Ready — all dependencies met, the agent can use this skill
  • Missing deps — the skill exists but required binaries or environment variables are not available

Managing skills

  1. Click Skills on a running instance card
  2. The dialog shows:
    • Search bar — search ClawHub's 13,000+ community skills
    • Community section — installed community skills with uninstall option
    • Bundled section — all 52 built-in skills with status badges

Installing a community skill

  1. Open the Skills dialog on a running instance
  2. Type a search query (e.g. "home assistant") and click Search
  3. Click Install next to the desired skill
  4. The skill appears in the Community section once installed

Uninstalling a community skill

  1. Open the Skills dialog
  2. In the Community section, click Uninstall next to the skill

Notes

  • Skills are per-instance — different instances can have different skill sets
  • ClawHub has rate limits; if you hit one, the system retries automatically
  • Installed community skills persist across gateway restarts and are included in soul snapshots

Clone this wiki locally