Miniclaw Os

README

# miniclaw-os

MiniClaw OS — the MiniClaw plugin ecosystem for OpenClaw.

A collection of CLI tools and plugins that extend [OpenClaw](https://openclaw.ai) into a full personal AI operating system.

---

## What's included

| Component | Type | Description |
|-----------|------|-------------|
| `miniclaw-brain` | Plugin | Kanban board — the agent's prefrontal cortex. Tracks work from backlog through shipped with enforced gates. |
| `smart-context` | Plugin | Injects relevant context (memory, board state) into the agent's prompt window automatically. |
| `miniclaw-vault` | CLI tool | Age-encrypted secret store. Store API keys, tokens, and private notes on disk. |
| `miniclaw` | CLI | Thin wrapper around the openclaw binary. All miniclaw commands live here. |
| `miniclaw-smoke-test` | CLI | Verifies the full MiniClaw stack is installed and functional. |

---

## Requirements

- **OpenClaw** installed at `~/.openclaw`  
  → Install via `install-openclaw.sh` on the mini root, or see [docs.openclaw.ai](https://docs.openclaw.ai)
- macOS (arm64) — tested on Apple Silicon
- `~/.local/bin` in your `$PATH`

---

## Install

```bash
git clone https://github.com/augmentedmike/miniclaw-os.git
cd miniclaw-os
./install.sh
```

Then restart OpenClaw to load the plugins:

```bash
openclaw gateway restart
```

Verify everything is working:

```bash
miniclaw-smoke-test
```

---

## What the installer does

1. Verifies OpenClaw is installed at `~/.openclaw`
2. Copies plugins into `~/.openclaw/miniclaw/plugins/`
3. Patches `~/.openclaw/openclaw.json` to register the plugins (load paths, allow list, default config)
4. Installs CLI tools into `~/.local/bin/`

Re-running `install.sh` is safe — it merges, not replaces. Existing plugin config in `openclaw.json` is not overwritten.

---

## Usage

### Brain board

```bash
miniclaw brain create --title "Fix login bug" --priority high
miniclaw brain list
miniclaw brain board
miniclaw brain move <id> in-progress
miniclaw brain move <id> in-review
miniclaw brain move <id> shipped
miniclaw brain archive <id>
miniclaw brain --help
```

Column flow: `backlog → in-progress → in-review → shipped`  
Each transition has enforced gates. Run `miniclaw brain move --help` for details.

### Vault

```bash
miniclaw-vault set gh-token ghp_xxxxx
miniclaw-vault get gh-token
miniclaw-vault export gh-token       # raw output for eval/piping
miniclaw-vault list
miniclaw-vault memo set private-note "eyes only"
```

### Smoke test

```bash
miniclaw-smoke-test
```

---

## Structure

```
miniclaw-os/
├── install.sh              # Installer
├── plugins/
│   ├── miniclaw-brain/     # Kanban board plugin
│   └── smart-context/      # Context injection plugin
└── bin/
    ├── miniclaw            # CLI wrapper
    ├── miniclaw-vault      # Vault CLI
    └── miniclaw-smoke-test # Smoke test
```

---

## Check-only mode

```bash
./install.sh --check
```

Verifies OpenClaw is installed and reachable. Makes no changes.

---

## License

Private. Part of the AugmentedMike / MiniClaw ecosystem.