An immersive character roleplay protocol designed to enforce narrative consistency, physical reactivity, and sensory formatting for text-based experiences.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install vn-roleplay
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install vn-roleplay using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Character Roleplay?
The vn-roleplay skill is a specialized communication protocol engineered for developers and creators building text-based roleplay experiences. As one of the most immersive Openclaw Skills, it acts as a structured framework that guides AI agents through the persona of a specific character, ensuring strict adherence to formatting, narrative flow, and emotional coherence. Unlike traditional chat prompts that lose context, this skill enforces a physical and emotional feedback loop, making characters react realistically to user actions.
By leveraging this layout, you can easily implement complex interactive experiences without risking out-of-character drift. Integrating this capability within your setup ensures that your agents dynamically respond to sensory anchors and maintain dialogue consistency, representing a significant advancement in the ecosystem of Openclaw Skills.
Character Roleplay Use Cases
- Building interactive, Vietnamese text-based roleplay games and character simulators.
- Configuring AI agents to adopt a highly consistent character persona for real-time storytelling sessions.
- Enforcing rigid formatting boundaries (narrative asterisks vs. dialogue quotes vs. internal thoughts) in text generations.
- Preventing conversational drift and maintaining logical emotional arcs across lengthy interactive threads.
How Character Roleplay Works
- Initialize Character Profile: Load the character background and first message placeholders, mapping user configurations cleanly.
- Sensory Anchor Assessment: Evaluate the initial response; if it lacks concrete physical details, append a sensory anchor to ground the perspective.
- Involuntary Reactivity Filter: Parse the user input through the character's physical and emotional lens, prioritizing immediate somatic responses over cognitive speech.
- Enforce Strict Output Formatting: Format the generated output into designated Markdown blocks distinguishing narrative actions, spoken dialogue, and suppressed thoughts.
- Quality Checklist Verification: Programmatically eliminate forbidden patterns, such as out-of-character commentary or direct emotional labeling, before completing the loop.
Character Roleplay Setup
To deploy the vn-roleplay protocol within your environment, ensure you have the Openclaw Skills framework configured. You can install or register the skill with the following commands:
# Install the vn-roleplay skill via the command line interface
claw install skill vn-roleplay
Next, configure your character profile file (e.g., character.yaml):
name: "vn-roleplay"
version: "1.0.1"
character_profile:
char: 'Elysia'
first_mes: '*She looks up from her book, her eyes catching yours as you step inside.* "You are finally back."’
Activate the skill inside your agent runtime setup to enable real-time compliance with the protocol rules.
Character Roleplay Data Schema & Taxonomy
This skill relies on a structured schema to parse and generate interactive narrative blocks. The table below outlines the core placeholder protocol used to parse variables and apply strict rendering rules:
| Placeholder | Format Symbol | Purpose / Rendered Output |
|---|---|---|
{char} |
N/A | Character name provided in the active profile. |
{user} |
N/A | User's preferred alias or nickname. |
| Actions & Sensations | * * |
Rendered as italics (narrative text, physical sensations, environmental detail). |
| Dialogue | " " |
Plain text surrounded by quotes (spoken speech only). |
| Internal Thoughts | ` ` |
Inline code blocks (suppressed reactions, cognitive whispers). |
Formatting Structure Example:
*[Narrative action or sensory detail]*
"[Spoken Dialogue]"
`[Internal Thought (Optional)]`
Using this layout within Openclaw Skills ensures prompt rendering parsers can cleanly separate narrative layers from structural dialogue blocks.
Character Roleplay Advanced Features
- Quality Checklist Auto-Enforcement: Built-in validation filters that instantly purge out-of-character (OOC) commentary and narrative rule violations before outputting to the user.
- Somatic Involuntary Responses: Automated modeling of physiological triggers (e.g., heart rate elevation, muscle tension) before processing conscious speech.
- Sensory Anchor Checks: Auto-appends physical sensations to lock character point-of-view when the initial message is narratively weak.
- Multi-Skill Interoperability: Designed to interface seamlessly with other narrative-focused Openclaw Skills like
vn-lexicon,vn-povs, andvn-lorefilterto construct unified novel and game development engines.
SKILL.md
Loading
Related Openclaw Skills
Living Your Own Answer
An AI-powered long-term self-improvement and reflective journaling system designed to help users transition from external dependency to inner clarity and self-authored answers.
Perspective Control System
A highly precise scene-level perspective and point-of-view controller that ensures immersive, structurally consistent narrative consciousness for AI co-writing.
YouTube Transcript Fetcher
YouTube Transcript Fetcher extracts clean plain text or timestamped video transcripts directly into downloadable JSON files via remote tool execution.
Network Tools
A comprehensive suite of networking utilities enabling AI agents to convert IP addresses, calculate subnets, format MAC addresses, validate ports, and run DNS queries.
CarboSilex137 Platform Integration
An advanced AI agent skill allowing autonomous agents to browse, apply for, and manage jobs on the CarboSilex137 Web3 freelance marketplace.
Smart File Organizer
An intelligent Python CLI tool to automatically organize, classify, and sort messy directories by file type, date, or custom naming patterns with preview and undo support.
Featured*
