openclaw_minion (mxn2020/minions-openclaw) | MoltPulse

openclaw_minion (mxn2020/minions-openclaw) | MoltPulse

npm install -g @minions-openclaw/cli

npm install @minions-openclaw/sdk

pip install minions-openclaw

openclaw-manager register my-gateway --url ws://192.168.1.100:8080 --token mytoken

openclaw-manager list

openclaw-manager ping <instanceId>

openclaw-manager snapshot <instanceId>

openclaw-manager history <instanceId>

openclaw-manager [command] [options]

Commands:
  register <name>         Register a new OpenClaw Gateway instance
    --url <url>           Gateway WebSocket URL (required)
    --token <token>       Auth token (optional)

  ping <instanceId>       Ping an instance and record latency

  snapshot <instanceId>   Capture a live snapshot of gateway state

  list                    List all registered instances

  history <instanceId>    Show snapshot history for an instance

  agents <instanceId>     List agents on a gateway
  channels <instanceId>   List channels on a gateway
  models <instanceId>     List model providers on a gateway

  config show <instanceId>              Show latest config
  config diff <id1> <id2>               Diff two snapshots
  config export <instanceId>            Export config as JSON
  config import <instanceId> --file <path>  Import config from file

import { MinionsOpenClaw } from '@minions-openclaw/sdk';

const minions = new MinionsOpenClaw();

// Register an instance
const instance = await minions.openclaw.instances.register('my-gateway', 'ws://localhost:8080', 'token');

// Connect and fetch live state
const client = minions.openclaw.createGatewayClient(instance.fields['url'] as string, 'token');
await client.openConnection();
const presence = await client.fetchPresence();
await client.close();

// Capture a snapshot
const snapshot = await minions.openclaw.snapshots.captureSnapshot(instance.id, presence);

// Decompose a config file
const config = await minions.openclaw.config.loadFromFile('./openclaw.json');
const { minions: newMinions, relations } = minions.openclaw.config.decompose(config, instance.id);

from minions_openclaw import MinionsOpenClaw
import asyncio

minions = MinionsOpenClaw()

# Register an instance
instance = minions.openclaw.instances.register('my-gateway', 'ws://localhost:8080', 'token')

# Async: connect and fetch state
async def capture():
    client = minions.openclaw.create_gateway_client(instance.fields['url'], token='token')
    await client.open_connection()
    presence = await client.fetch_presence()
    await client.close()

    snapshot = minions.openclaw.snapshots.capture_snapshot(instance.id, presence)
    print(f'Snapshot: {snapshot.id}')

asyncio.run(capture())

minions-openclaw/
├── packages/
│   ├── core/          # TypeScript library (@minions-openclaw/sdk)
│   │   ├── src/
│   │   │   ├── types.ts           # MinionType definitions for all OpenClaw entities
│   │   │   ├── InstanceManager.ts # CRUD for gateway instances
│   │   │   ├── GatewayClient.ts   # WebSocket client (challenge/response auth)
│   │   │   ├── SnapshotManager.ts # Snapshot capture & diff
│   │   │   ├── ConfigDecomposer.ts# openclaw.json → minion tree
│   │   │   └── index.ts           # Public exports
│   │   └── test/                  # Jest tests
│   ├── cli/           # CLI tool (@minions-openclaw/cli)
│   │   └── src/commands/          # Commander.js commands
│   └── python/        # Python SDK (minions-openclaw)
│       ├── minions_openclaw/
│       └── tests/
├── apps/
│   └── docs/          # Astro Starlight documentation
├── examples/
│   ├── typescript/    # TypeScript usage examples
│   └── python/        # Python usage examples
└── spec/
    └── v0.1.md        # Technical specification

# Clone the repo
git clone https://github.com/minions-openclaw/minions-openclaw.git
cd minions-openclaw

# Install all JS dependencies (workspaces)
npm install

# Build TypeScript packages
npm run build

# Run TypeScript tests
npm run test -w packages/core

# Python setup
cd packages/python
pip install -e ".[dev]"
pytest tests/ -v