OpenClaw Pixel Agents Plugin (AgentWorld)

Production plugin that packages and manages AgentWorld runtime inside OpenClaw.

What this gives users

• one-command install via OpenClaw plugins
• automatic runtime start on gateway boot
• auto-follow active chat session (prevents wrong-session bug)
• built-in connection status + mismatch UX (in AgentWorld UI)
• dedupe protection for duplicate mirrored replies

Install (user flow)

openclaw plugins install @spicyclaws/openclaw-pixel-agents
openclaw plugins enable openclaw-pixel-agents
openclaw gateway restart

Install (local dev flow)

openclaw plugins install /absolute/path/to/openclaw-pixel-agents-plugin --link
openclaw plugins enable openclaw-pixel-agents
openclaw gateway restart

Runtime commands

openclaw agentworld status
openclaw agentworld start
openclaw agentworld stop
openclaw agentworld restart

Config

Set values under:

plugins.entries.openclaw-pixel-agents.config

Example:

{
  plugins: {
    entries: {
      "openclaw-pixel-agents": {
        enabled: true,
        config: {
          autoStart: true,
          autoRestart: true,
          host: "127.0.0.1",
          port: 8787,
          sessionMode: "auto",
          pollMs: 800,
          staleMs: 15000,
          dedupeMs: 12000
        }
      }
    }
  }
}

If you want to force a specific session:

{
  sessionMode: "pinned",
  pinnedSessionKey: "agent:main:telegram:direct:1327788336"
}

Verify

openclaw agentworld status
curl -sS http://127.0.0.1:8787/api/pixel-agents/connection

Publish

npm pack --dry-run
npm publish --access public