TRPG Session Framework for Openclaw

A multi-agent framework designed to run immersive tabletop RPG campaigns with AI-driven Dungeon Masters and Player Characters.

gejiliang
v1.0.0
Apr 2, 2026
0
653
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install trpg-session

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install trpg-session 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 TRPG Session Framework?

The TRPG Session framework enables users to orchestrate complex tabletop roleplaying games through the power of Openclaw Skills. It utilizes a multi-agent architecture where a dedicated Dungeon Master (DM) agent handles narration, NPC dialogue, and rule adjudication, while additional AI agents can take on roles as Player Characters (PCs). Each agent possesses a unique personality defined by SOUL.md files, ensuring a deep and engaging roleplay experience that bridges the gap between AI and human participants.

By leveraging the workspace management of Openclaw Skills, the framework maintains a consistent world state across multiple sessions. It integrates seamlessly with platforms like Discord or Feishu, allowing human players to interact with AI agents in a shared channel. This setup is ideal for long-running campaigns, one-shots, or testing new game mechanics with highly responsive AI companions.

TRPG Session Framework Use Cases

  • Launching full-scale D&D, Call of Cthulhu, or homebrew campaigns with an automated AI DM.
  • Populating a Discord channel with AI-driven party members that possess private memories and distinct traits.
  • Indexing and querying massive rulebooks or campaign lore during active gameplay.
  • Automating the logging of session events and the tracking of character resources like HP and inventory.
  • Running persistent, text-based roleplaying adventures where AI and humans coexist.

How TRPG Session Framework Works

  1. The user establishes a structured campaign workspace containing rules, lore, and character directories.
  2. Agents are configured with specialized system prompts and SOUL.md personality definitions within the framework.
  3. Rulebooks are indexed as Markdown files or vector database entries, providing a knowledge base for the DM agent.
  4. Agents are linked to communication channels (Discord/Feishu) with mention-based triggers to ensure they only speak when prompted.
  5. During a session, the DM agent narrates scenes, interprets player actions, and rolls virtual dice based on the campaign's mechanics.
  6. The agents use shared and private memory scopes to maintain continuity while keeping character secrets hidden.
  7. At the end of a session, Openclaw Skills generate a summary and update all character files for future play.

TRPG Session Framework Setup

To get started, create the necessary directory structure for your campaign files:

mkdir -p ~/.openclaw/trpg/<campaign-slug>/{rules,lore,characters,sessions}

Next, define your DM and PC agents in your configuration file, ensuring the workspace and soul paths point to your newly created directories. Install any necessary plugins for platform integration (e.g., Discord) and ensure your rulebooks are converted to Markdown format in the rules/ folder to take full advantage of Openclaw Skills.

TRPG Session Framework Data Schema & Taxonomy

The skill organizes campaign data into a clear taxonomy within the workspace folder:

Directory File Type Description
/rules Markdown Segmented rulebooks for combat, magic, and general mechanics.
/lore Markdown World-building data including maps, factions, and NPC details.
/characters Markdown Individual character sheets containing stats, bonds, and inventory.
/sessions Markdown Sequential logs of every played session for history and continuity.

TRPG Session Framework Advanced Features

  • Semantic retrieval of complex rules using vector database plugins like lancedb-pro within the environment.
  • Private memory scopes for agents to facilitate hidden character motives and secret DM planning.
  • Automated session log generation that preserves campaign momentum between live games.
  • Custom script support for verifiable dice rolling and complex stat tracking integrated with Openclaw Skills.
  • Support for multi-platform triggers allowing campaigns to span across different communication tools effortlessly.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*