openclaw-tavern-chat

An OpenClaw plugin for:

• character cards
• worldbooks
• regex post-processing rules
• Tavern-style MiniMax read-aloud TTS

Install

openclaw plugins install openclaw-tavern-chat

Update

openclaw plugins update openclaw-tavern-chat

After updating plugin code/config, restart the gateway.

Features

• Character cards
  • Import .png / .json cards
  • /character list|show|set|clear
  • Prompt mode: full / minimal via /character mode ...
  • Placeholder replacement ({{char}}, {{user}}, etc.)
• Worldbooks
  • /worldbook list|show|set|clear
  • Keyword matching + sticky entries
  • Supports embedded character_book inside character cards
• Regex rules
  • /regex list|add|remove|enable|disable|clear
• Attachment auto-import
  • PNG: auto-detect Tavern card payload
  • JSON: auto-detect worldbook/regex
  • Duplicate character-card imports are skipped by content hash
• MiniMax TTS read-aloud
  • /tavern-tts on|off|status
  • /minimax-tts <text> for direct test synthesis

Commands

Character

| Command | Description | |---|---| | /character list | List cards | | /character show [filename\|name] | Show current/specific card | | /character set <filename\|name> | Set active card | | /character clear | Clear active card | | /character mode <full\|minimal> | Set injection mode |

Natural phrases are also supported (examples):

• 角色卡列表
• 切换角色卡 <名称>
• 角色卡精简模式 / 只要人设 / 不要开场白

Worldbook

| Command | Description | |---|---| | /worldbook list | List worldbooks | | /worldbook show | Show active worldbook | | /worldbook set <filename> | Set active worldbook | | /worldbook clear | Clear active worldbook |

Regex

| Command | Description | |---|---| | /regex list | List rules | | /regex add <pattern> => <replacement> | Add rule | | /regex remove <index\|name> | Remove rule | | /regex enable <index\|name> | Enable rule | | /regex disable <index\|name> | Disable rule | | /regex clear | Clear all rules |

Tavern MiniMax TTS

| Command | Description | |---|---| | /tavern-tts on | Enable Tavern read-aloud for current session | | /tavern-tts off | Disable Tavern read-aloud for current session | | /tavern-tts status | Show current Tavern read-aloud status | | /minimax-tts <text> | Synthesize and send test audio |

Character Prompt Modes

/character mode <full|minimal>

• full (default): includes all major card fields (including scenario, first_message, example_dialogue)
• minimal: excludes opening/scenario-style fields and keeps core persona fields

MiniMax TTS Configuration

Add under plugins.entries.openclaw-tavern-chat.config in openclaw.json:

{
  "plugins": {
    "entries": {
      "openclaw-tavern-chat": {
        "enabled": true,
        "config": {
          "minimaxTts": {
            "enabled": true,
            "apiToken": "your-minimax-api-token",
            "voiceId": "female-shaonv-jingpin",
            "speed": 1,
            "volume": 1,
            "pitch": 0,
            "sendAsVoice": false
          }
        }
      }
    }
  }
}

You can also set:

• MINIMAX_API_TOKEN (preferred)
• MINIMAX_API_KEY

Options

| Option | Default | |---|---| | enabled | true | | apiToken | none | | baseUrl | https://api.minimaxi.com/v1/t2a_v2 | | model | speech-2.8-hd | | voiceId | female-shaonv-jingpin | | speed | 1 | | volume | 1 | | pitch | 0 | | sampleRate | 32000 | | format | mp3 | | sendAsVoice | true |

Tip: if Discord voice-bubble mode is unstable in your environment, set sendAsVoice: false to send normal audio files.

Storage

Managed files are stored under your OpenClaw state dir:

~/.openclaw/
├── characters/          # character cards (.png/.json)
├── worldbooks/          # worldbooks (.json)
└── regex-rules.json     # regex rules

中文说明（简版）

• 用于管理角色卡、世界书、正则规则，并支持 MiniMax 语音朗读。
• 角色卡支持 full/minimal 注入模式：
  • full：完整注入
  • minimal：不注入开场白/场景/示例对话类字段
• 常用命令：
  • /character ...
  • /worldbook ...
  • /regex ...
  • /tavern-tts on|off|status
  • /minimax-tts 文本
• 改完配置后请重启 gateway 生效。

License

MIT