npm package: @imogenlabs/operator-kit
Description: AI operator scaffold for OpenClaw — identity, memory, instincts, cron, and agent architecture in one install
Author: ImogenLabs
Latest version: 0.2.0

# @imogenlabs/operator-kit

AI operator scaffold for OpenClaw. One install gives you a complete AI operator setup — identity, memory system, instincts engine, cron jobs, and multi-agent architecture.

## Install

```bash
openclaw plugins install @imogenlabs/operator-kit
```

## What You Get

| Component | Files | Description |
|-----------|-------|-------------|
| **Identity** | SOUL.md, IDENTITY.md, USER.md | Core values, personality, owner profile |
| **Workspace** | AGENTS.md, TOOLS.md, HEARTBEAT.md | Rules, tools config, proactive checks |
| **Memory** | memory/MEMORY.md, memory/YYYY-MM-DD.md | Daily logs + evergreen references |
| **Instincts** | instincts/global/*.yaml | Confidence-weighted learned behaviors |
| **Agent Roles** | agents/{orchestrator,coder,security,researcher}/ | Multi-agent dispatch architecture |
| **Cron Jobs** | cron/jobs.json | Morning briefing + nightly rundown |

## Configuration

```json
{
  "operator-kit": {
    "enabled": true,
    "config": {
      "operatorName": "Friday",
      "ownerName": "Tony",
      "timezone": "America/New_York",
      "enableMemorySystem": true,
      "enableInstincts": true,
      "enableCronJobs": false,
      "enableAgentRoles": false
    }
  }
}
```

## Tools

The plugin registers three tools:

- **operator_scaffold_status** — Check which operator files exist
- **operator_create_instinct** — Create a new learned behavior pattern
- **operator_memory_ref** — Create/update an evergreen reference memory

## How It Works

On first load, operator-kit checks your workspace for missing files and creates them from templates. Existing files are never overwritten — you own your operator's identity once it's scaffolded.

The memory system creates daily log files and an index. The instincts engine seeds one starter instinct (ask before external actions) and provides a tool to create more as your operator learns.

## Companion: Lossless Context Management

For cross-session memory that survives context window limits, install [lossless-claw](https://github.com/Martian-Engineering/lossless-claw):

```bash
openclaw plugins install @martian-engineering/lossless-claw
```

Operator-kit handles the *identity and workspace structure*. Lossless-claw handles the *conversation memory* — DAG-based summarization with incremental compaction so your operator remembers what happened across sessions.

## Ready-Made Agent Templates

Got operator-kit running? Add a pre-built agent in minutes:

| Template | What It Does | Price |
|----------|-------------|-------|
| [Homelab Monitor](https://agents.imogenlabs.ai/templates/homelab-monitor) | Docker health checks, crash loop detection, auto-restart | $29 |
| [Morning Briefing](https://agents.imogenlabs.ai/templates/morning-briefing) | Calendar, email, weather, news, tasks — one morning message | $19 |
| [Content Pipeline](https://agents.imogenlabs.ai/templates/content-pipeline) | Blog drafts, social posts, built-in humanizer, approval gates | $29 |
| [Security Audit](https://agents.imogenlabs.ai/templates/security-audit) | Nightly scans: ports, Docker, SSH, SSL, file permissions | $39 |
| [Project Manager](https://agents.imogenlabs.ai/templates/project-manager) | Standups, sprint tracking, velocity reports | $39 |
| [Crypto Market](https://agents.imogenlabs.ai/templates/crypto-market) | CoinGecko + Binance + Etherscan. Price alerts, whale watching | $39 |
| [Stock & Finance](https://agents.imogenlabs.ai/templates/stock-finance) | Alpha Vantage + FRED. Market briefings, economic indicators | $39 |
| [News & Sentiment](https://agents.imogenlabs.ai/templates/news-sentiment) | NewsAPI + Reddit + HN. Keyword monitoring, sentiment scoring | $29 |
| [API Discovery](https://agents.imogenlabs.ai/templates/api-discovery) | Search 1,400+ free APIs from the public-apis repo | $49 |

All templates use free public APIs. [Bundle all 9 for $149](https://agents.imogenlabs.ai/#templates) (save $162).

Want the full guide? [The Imogen Playbook](https://agents.imogenlabs.ai/#templates) ($149) — 11 chapters on building an AI operator from scratch.

Don't want to self-host? [Managed hosting](https://agents.imogenlabs.ai/#pricing) starts at $29/mo.

## Inspired By

Built from the patterns behind Imogen, the AI operator at [Imogen Labs](https://agents.imogenlabs.ai).

## License

MIT