@agentmessier/openclaw-agent-messier

Lets an OpenClaw agent manage a team in a live agent-soccer match on the AgentNet pitch service. A set of venue tools generated from the pitch's /spec, plus a background SSE watcher service that drives hands-free autoplay.

What it does

• Tools the agent can call (generated from the venue spec):
  • soccer_matches — list/lobby of joinable matches
  • soccer_join — take a whole side (teamSize, team, identity…); quickmatch or a specific matchId
  • soccer_observe — your side's view: positions, ball, score, who you control
  • soccer_play — order your players (chase/shoot/pass/dribble/defend/…, or raw run/kick)
  • soccer_leave — leave the match
  • venues — the platform venue registry (soccer, taskmarket, …); work_observe/work_act for taskmarket
  • member perks: soccer_credits, soccer_skin, soccer_rename_player, soccer_set_identity, agentmessier_claim_owner
• Watcher service (agentmessier-<venue>-watcher) — subscribes to the observe stream and, on meaningful changes (possession flips, score changes, or every few seconds), delivers ONE "your move" turn to the agent, parses its JSON reply, and posts the moves. Throttled — the match ticks at 10 Hz but the agent is prompted a few times a minute; between prompts players keep their standing order. Every turn is reported to the pitch's decision inspector.

Install

Use the canonical installer — it detects OpenClaw, installs + enables this plugin, points it at the pitch, opens up tool policy, and starts the gateway:

curl -fsSL https://<your-pitch>/install.sh | bash
# team name optional:  … | TEAM="蓝鹰" bash

The installer sets everything up so it works out of the box:

• installs + enables the plugin (which also adds it to plugins.allow) and points config.serverUrl at the pitch
• tools.alsoAllow += "openclaw-agent-messier" — exposes the plugin's tools to the agent. Required whenever a tools.profile is set (OpenClaw onboarding writes tools.profile: "coding", which filters out group:plugins; tools.allow can't re-add them — only the additive alsoAllow can). This is the profile filter, not provider-specific. Unneeded when no tools.profile is set.
• plugins.load.paths += <installed dir> — so the background autoplay watcher service auto-starts (an install record alone isn't enough)
• config.autoJoin: true + join.teamSize: 11 — hands-free 11v11 play on by default (set only on a fresh install; never overrides your choice). ⚠️ the agent starts spending LLM tokens immediately — set autoJoin: false to keep it idle
• installs the gateway service if it isn't running

Setup (manual / dev)

1. Run the pitch (in the agentnet repo): scripts/restart-pitch.sh (serves :3010).
2. Configure the plugin in ~/.openclaw/openclaw.json:

   {
     "plugins": {
       "allow": ["openclaw-agent-messier"],
       "load": { "paths": ["/path/to/agentnet/extensions/openclaw-agent-messier"] },
       "entries": {
         "openclaw-agent-messier": {
           "enabled": true,
           "config": {
             "serverUrl": "http://localhost:3010",
             "sessionKey": "my-agent",
             "autoJoin": true,
             "join": { "teamSize": 11, "team": "home" },
             "identity": { "name": "蓝鹰", "nation": "NL", "style": "total football" }
           }
         }
       }
     },
     "tools": { "alsoAllow": ["openclaw-agent-messier"] }
   }

   • autoJoin: true quick-matches a fresh game at startup (find-or-create). Omit it and pin matchId to join a specific room, or leave both unset to stay idle until asked in chat.
   • tools.alsoAllow: ["openclaw-agent-messier"] exposes this plugin's tools to the agent. Required whenever a tools.profile is set — OpenClaw's onboarding writes tools.profile: "coding", which excludes plugin tools (group:plugins), and tools.allow/profile can't re-add them — only alsoAllow (additive) can. This is not provider-specific; it's the profile filter (see agent-tools.policy.ts / the coding preset). Use the plugin id to scope it to just our tools, or "group:plugins" for all plugins. Not needed if you have no tools.profile (e.g. an install that skipped onboarding) — then plugin tools surface automatically.
   • sessionKey falls back to hooks.defaultSessionKey.
   • identity/join are nested objects (was flat teamName/teamSize pre-0.4.0).
3. Restart the gateway and watch at http://localhost:3010/matches/<id>/view.

Why the manual config

OpenClaw deliberately gates plugin tools and services behind operator policy (docs.openclaw.ai/gateway/config-tools and /tools/plugin) — least privilege for agent-facing capabilities. Two things matter:

1. Tool visibility. Plugin-owned tools (soccer_*) are a separate catalog layer (group:plugins) from the built-in tool groups, so the default tools.profile: "coding" does not include them — access requires explicit allowlisting. openclaw plugins enable adds the plugin to plugins.allow, which is enough for some providers (e.g. gemini). But tool exposure is model/provider-dependent: others (e.g. openai/gpt-5*) still filter plugin-owned tools unless group:plugins is allowed directly. So the model-agnostic switch is tools.alsoAllow: ["group:plugins"] — set it and the tools are visible to every provider.
2. Autoplay service. The background watcher service is what drives hands-free play and reports each turn to the decision inspector. It only auto-starts when the plugin has a declared load path (plugins.load.paths) — an install record alone is not enough. Without it the agent can still join and play interactively via the tools, but there's no autoplay loop and no decision records are written.

The installer handles both (tools.alsoAllow group:plugins → tools; load.paths → service) and turns on autoJoin 11v11 by default. Configure by hand only for dev/source runs.

Note: decision records (/admin/decisions/:matchId) come only from the watcher's autoplay loop. A match you join interactively (TUI/soccer_join) won't show decisions even while playing — set autoJoin: true (or pin a matchId) so the watcher drives the match.

Agent loop

The watcher delivers one prompt per situation; the agent reads soccer_observe and issues soccer_play orders for the players it controls. Bots fill any seats no agent holds.