specs/001-openclaw-integration/quickstart.md

# Quick Start: OpenClaw Integration

**Feature**: 001-openclaw-integration | **Date**: 2026-02-27

## Prerequisites

- Python 3.12+
- An OpenClaw agent that has completed at least one session
- An Anthropic API key (or any LiteLLM-supported provider)

## Setup (3 steps)

### 1. Install

```bash

git clone https://github.com/kayba-ai/agentic-context-engine.git

cd agentic-context-engine

uv sync

```

### 2. Configure

```bash

export ANTHROPIC_API_KEY="your-api-key"

```

Optional overrides:

```bash

export OPENCLAW_AGENT_ID="main"           # which agent to learn from

export OPENCLAW_HOME="~/.openclaw"        # OpenClaw home directory

export ACE_MODEL="anthropic/claude-sonnet-4-20250514"  # LLM model

```

### 3. Run

```bash

# Learn from all past sessions

uv run python examples/openclaw/kayba-ace/learn_from_traces.py



# Preview what would be processed (no LLM calls, no file changes)

uv run python examples/openclaw/kayba-ace/learn_from_traces.py --dry-run



# Reprocess everything (ignore what's already been learned)

uv run python examples/openclaw/kayba-ace/learn_from_traces.py --reprocess

```

## What Happens

1. **Discovers** session transcripts from `~/.openclaw/agents/<id>/sessions/`
2. **Parses** JSONL files into structured traces (user messages, reasoning, tool calls)
3. **Learns** by running ACE's Reflect → Tag → Update → Apply pipeline
4. **Saves** strategies to `~/.openclaw/ace_skillbook.json`
5. **Syncs** strategies into `~/.openclaw/workspace/AGENTS.md`
6. Your OpenClaw agent reads the updated AGENTS.md on its next session

## Automate (optional)

Run every 30 minutes via cron:

```bash

crontab -e

# Add:

*/30 * * * * cd /path/to/agentic-context-engine && uv run python examples/openclaw/kayba-ace/learn_from_traces.py >> /tmp/ace-openclaw.log 2>&1

```

## Verify

After running, check the output:

```bash

# View learned strategies

cat ~/.openclaw/ace_skillbook.json | python -m json.tool | head -50



# View what was injected into your agent

grep -A 20 "ACE:SKILLBOOK:START" ~/.openclaw/workspace/AGENTS.md

```