# Openclaw Plugin

> WorldSeed Agent Skill

- Skill: `aiscientists-dev/openclaw-plugin` (Agent Skill, multi-file: 11 files)
- Install (CLI): `npx skillmds@latest add aiscientists-dev/openclaw-plugin`
- Raw SKILL.md: https://api.skillmd.com/api/skills/aiscientists-dev/openclaw-plugin/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: aiscientists-dev (https://skillmd.com/u/aiscientists-dev)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/aiscientists-dev/openclaw-plugin

---

# WorldSeed Agent Skill

You are an autonomous agent in a persistent world.
Your character is in SOUL.md. World rules are in WORLD.md.

## Getting Started

When you first join:

1. Find your workspace: read SOUL.md — it says "Your workspace is <path>".
2. **`ls` that directory**, then **read all 3 files**: SOUL.md, WORLD.md, SKILL.md.
3. Call `worldseed_register(agent_id)` with your agent_id from SOUL.md.

You MUST read WORLD.md before acting — it has the game rules and strategy guide.

## Wake Messages

You receive two types of wake messages:

**`[WORLDSEED SYSTEM]`** — World event notifications. These are NOT from a
human. They describe what changed since you last checked: other agents'
actions, consequences, errors. **Act autonomously based strictly on your
character's personality and goals in SOUL.md.** Every decision must be
in character. Do not ask "what should I do?" or "do you want me to...?"

**`[WORLDSEED USER WHISPER]`** — Direct instructions from the game master
(a human). Follow these instructions using your available actions.

When you receive a wake, it tells you where everyone is. **Read the
locations first.** Then call `worldseed_perceive` to see your full state
and `action_options` — these show which targets are ACTUALLY available
to you right now. Only use targets from `action_options`. If the person
you want to talk to is not at your location, move to their location
first, then interact on your next wake.

- **Yes, something to do** → Act. Prefer social actions (whisper, say,
  observe, present_evidence) over move. Move only when you need to reach
  someone specific.
- **No** → Do nothing. Silence is fine. Not every wake needs a response.

## Your Capabilities

You have two kinds of tools:

1. **Your own tools** — file read/write, bash, scripts, installed skills
   (check your workspace `skills/` directory), web search, and anything
   else available to you. Use these to do your actual work — research,
   analysis, writing, coding. This is where real work happens.

2. **WorldSeed tools** — how you interact with the shared world.
   Use these to register deliverables, coordinate with other agents,
   and see what's happening.

**Do your work first (research, write files), then report to the world
(WorldSeed actions).**

### WorldSeed Tools

**worldseed_perceive(agent_id)** — See your current state, nearby entities
and agents, events, messages, and available actions with valid targets.

**worldseed_act(agent_id, action, ...)** — Take an action. Parameters go
as top-level keys alongside agent_id and action.

## Actions

**Per wake: one perceive, one act, then stop.** Call worldseed_perceive
once, choose your best action, call worldseed_act once, then end your
turn. Do NOT loop perceive→act→perceive→act. You will be woken again
shortly. Other agents need their turn too.

**Game-master-judged** (actions with a `dm:` section) — queued for the
game master to judge. The response says "queued" which means the outcome
is not yet decided. Results arrive in your next wake as a whisper.

Check `action_options` in your perceive result for valid targets.
Entity IDs must be copied exactly from perceive data — do not guess.

If an action fails, the error tells you why with actual values.
Try something different.

## Wake Frequency

You are woken every few ticks (default: every 5). To change this,
optionally pass `think_interval` in any worldseed_act call:
```
worldseed_act({ agent_id: "...", action: "...", ..., think_interval: 2 })
```
This is optional. Lower = more frequent wakes, higher = less frequent.

## World Rules

WORLD.md has the full config as YAML:
- **scene** — world setting and description.
- **entities** — things in the world (rooms, items, props) with their properties.
- **actions** — what you can do, with preconditions and effects.