Clawtopia Werewolf Evolution

Deterministic validation and workspace persistence for werewolf-play postgame proposals.

The plugin is not a channel. It does not send messages, call the network, execute shell commands, or decide game actions. It accepts only trusted WEREWOLF_DEBRIEF v2 bodies delivered by the Clawtopia channel and writes a fixed set of files inside the active Agent workspace.

The model may submit one postgame proposal, but it cannot write evidence directly. This plugin binds a trusted Clawtopia debrief to one Agent run, validates facts and state transitions, and commits the fixed workspace files as one recoverable transaction. Core strategy suggestions use a separate one-shot tool and can only be accepted or rejected by the Agent owner in an ordinary direct message.

Install skill and evolution together

OpenClaw already provides the Node.js runtime used by this setup command. In the usual case, run:

npx -y @clawtopia/werewolf-evolution-setup@latest setup

The setup command discovers workspaces and Owners from OpenClaw configuration. A single valid pair is installed without a prompt; multiple candidates are presented only in an interactive terminal. Use setup --all to install all configured workspaces. In CI or another non-interactive environment, ambiguous targets must be supplied explicitly with --workspace and --owner.

The command installs an exact matching version of @clawtopia/werewolf-play, installs and pins this plugin through the official OpenClaw CLI, archives legacy-v2 data without inheriting support counts, backs up the active openclaw.json, and enables the two required hook permissions. It refuses wildcard or malformed commands.ownerAllowFrom ownership, creates the allowlist when absent, and binds that exact Owner to the target workspace. A different globally allowed Owner cannot decide suggestions for this workspace.

Changing the workspace Owner is explicit and preserves other workspaces' global allowlist entries:

npx -y @clawtopia/werewolf-evolution-setup@latest setup \
  --workspace ~/.openclaw/workspace/my-agent \
  --owner clawtopia:human:<new-user-id> \
  --transfer-from clawtopia:human:<current-user-id>

The setup CLI is published separately so this runtime plugin contains no shell-command execution code and can pass OpenClaw's plugin safety scan. Before changing the workspace, config, or plugin, setup reads OpenClaw's complete plugin inventory. An existing npm-installed werewolf-evolution must have an exact recoverable install record. A local path/link, git, archive, marketplace, missing-record, or inconsistent prior installation is rejected without target mutation so setup cannot destroy an environment it cannot restore.

Restart the OpenClaw gateway after setup. Normal games keep working when this plugin is unavailable. Without the plugin, proposal-only is a Markdown instruction rather than a mechanical tool sandbox; the deterministic guarantee against direct evidence writes starts with the paired setup above.

Owner decisions are accepted only as an exact ordinary direct message to the Agent:

采纳 S-001
忽略 S-001

They are never prompted or processed in a game room, group, system debrief, or non-owner conversation.

Development

npm install
npm run lint
npm run test
npm run build
npm pack --dry-run