npm package: @lock-in-lab/walnut-openclaw
Description: ALIVE structured context management for OpenClaw
Latest version: 0.1.0

# @alivecomputer/openclaw

> **Alpha** — skills and hooks load, tool schemas need work. [Tracking issue →](https://github.com/alivecomputer/alive-openclaw/issues)

**Structured context management for OpenClaw.** One plugin, three tiers — from manual context to full engine ownership.

Your AI agent forgets what matters. Lossless-claw preserves tokens. ALIVE preserves meaning.

## What it does

ALIVE organizes your projects, ventures, and life areas into **walnuts** — self-contained units of context with their own state, history, tasks, and captured content. Everything lives in markdown files on your machine. Any agent that can read files can read a walnut.

The plugin gives your OpenClaw agent structured tools for reading, writing, and routing context — plus an overnight consolidator that mines your conversations and files the meaningful bits automatically.

## Install

```bash
openclaw plugins install @alivecomputer/openclaw
```

Then run `/alive:init` in any channel to set up your world.

## Three Tiers

### Tier 1: Skills (default)

Manual mode. Zero LLM cost. You drive.

- `/alive:init` — set up your world
- `/alive:world` — dashboard with health signals
- `/alive:load` — load project context into session
- `/alive:capture` — route content to the right place
- `/alive:find` — search across all projects

8 tools available to your agent: `alive_read_walnut`, `alive_list_walnuts`, `alive_capture`, `alive_write_draft`, `alive_write_log`, `alive_update_state`, `alive_create_capsule`, `alive_search_archive`.

### Tier 2: Companion

The overnight consolidator. Works alongside lossless-claw.

Your agent chats all day. At 2am, the consolidator mines the conversation history and files decisions, tasks, people updates, and captures to the right walnuts. Morning briefing includes walnut health signals.

~5-10 API calls per night. Enable with `/alive:upgrade`.

### Tier 3: Full Engine

ALIVE owns your context lifecycle. Replaces default compaction.

Instead of compressing old messages into summaries, ALIVE extracts what matters and files it to walnuts. The walnut brief pack becomes your historical context. Optional SQLite archive keeps raw messages searchable.

1 API call per compaction. Enable with `/alive:upgrade`.

## The ALIVE Framework

Five domains. Every piece of context fits into exactly one.

```
01_Archive      Everything that was. Still searchable.
02_Life         Personal. Goals, people, health. The foundation.
03_Inputs       Buffer. Route out within 48 hours.
04_Ventures     Revenue intent. Your job, clients, business.
05_Experiments  Testing grounds. Might become a venture.
```

Based on Tiago Forte's PARA, rebuilt for AI context management.

## Cross-Platform

If you also use Claude Code with the ALIVE plugin, both runtimes read and write to the same walnut files. OpenClaw captures throughout the day. Claude Code does focused work. Same files, zero sync.

## Config

```json5
{
  "plugins": {
    "entries": {
      "alive": {
        "enabled": true,
        "config": {
          "worldPath": "~/.openclaw/workspace/world",
          "mode": "skills",
          "topicDetection": true,
          "consolidation": {
            "schedule": "0 2 * * *"
          }
        }
      }
    }
  }
}
```

## Requirements

- OpenClaw 2026.3.7+
- Node.js 22+
- lossless-claw (optional, for Tier 2 companion mode)

## License

MIT