openclaw

Files (69)

• .gitignore
• .npmignore
• Dockerfile.e2e
• SKILL.md
• TESTING.md
• e2e-verify.sh
• install.sh
• openclaw.plugin.json
• package.json
• .gitignore · skills/agent-cost-report/
• CHECKSUMS.txt · skills/agent-cost-report/
• SKILL.md · skills/agent-cost-report/
• acr.py · skills/agent-cost-report/scripts/
• __init__.py · skills/agent-cost-report/scripts/acr/
• behavior.py · skills/agent-cost-report/scripts/acr/
• classify.py · skills/agent-cost-report/scripts/acr/
• costs.py · skills/agent-cost-report/scripts/acr/
• devices.py · skills/agent-cost-report/scripts/acr/
• evidence.py · skills/agent-cost-report/scripts/acr/
• labels.py · skills/agent-cost-report/scripts/acr/
• measure.py · skills/agent-cost-report/scripts/acr/
• mistakes.py · skills/agent-cost-report/scripts/acr/
• patterns.py · skills/agent-cost-report/scripts/acr/
• period.py · skills/agent-cost-report/scripts/acr/
• prices.py · skills/agent-cost-report/scripts/acr/
• render.py · skills/agent-cost-report/scripts/acr/
• rollup.py · skills/agent-cost-report/scripts/acr/
• rules.json · skills/agent-cost-report/scripts/acr/
• rules.py · skills/agent-cost-report/scripts/acr/
• sample.py · skills/agent-cost-report/scripts/acr/
• snapshot.py · skills/agent-cost-report/scripts/acr/
• sync.py · skills/agent-cost-report/scripts/acr/
• transcripts.py · skills/agent-cost-report/scripts/acr/
• wins.py · skills/agent-cost-report/scripts/acr/
• _db.py · skills/agent-cost-report/scripts/tests/
• _paths.py · skills/agent-cost-report/scripts/tests/
• rollout-codex-1.jsonl · skills/agent-cost-report/scripts/tests/fixtures/codex/sessions/2026/09/18/
• make_report_fixtures.py · skills/agent-cost-report/scripts/tests/fixtures/
• prices_sample.json · skills/agent-cost-report/scripts/tests/fixtures/
• sess-aaaa.jsonl · skills/agent-cost-report/scripts/tests/fixtures/projects/-workspace-proj-a/
• sess-bbbb.jsonl · skills/agent-cost-report/scripts/tests/fixtures/projects/-workspace-proj-b/
• report-1day.json · skills/agent-cost-report/scripts/tests/fixtures/
• report-30day.json · skills/agent-cost-report/scripts/tests/fixtures/
• report-7day.json · skills/agent-cost-report/scripts/tests/fixtures/
• report-empty.json · skills/agent-cost-report/scripts/tests/fixtures/
• report-session.json · skills/agent-cost-report/scripts/tests/fixtures/
• test_behavior.py · skills/agent-cost-report/scripts/tests/
• test_devices.py · skills/agent-cost-report/scripts/tests/
• test_labels.py · skills/agent-cost-report/scripts/tests/
• test_measure.py · skills/agent-cost-report/scripts/tests/
• test_pdf_windows.py · skills/agent-cost-report/scripts/tests/
• test_period.py · skills/agent-cost-report/scripts/tests/
• test_prices.py · skills/agent-cost-report/scripts/tests/
• test_render.py · skills/agent-cost-report/scripts/tests/
• test_render_encoding.py · skills/agent-cost-report/scripts/tests/
• test_rollup.py · skills/agent-cost-report/scripts/tests/
• test_snapshot.py · skills/agent-cost-report/scripts/tests/
• test_sync.py · skills/agent-cost-report/scripts/tests/
• test_transcript_encoding.py · skills/agent-cost-report/scripts/tests/
• test_transcripts.py · skills/agent-cost-report/scripts/tests/
• …and 9 more

SKILL.md (first lines)

# Claude-Mem OpenClaw Plugin — Setup Guide

This guide walks through setting up the claude-mem plugin on an OpenClaw gateway. By the end, your agents will have persistent memory across sessions via system prompt context injection, and optionally a real-time observation feed streaming to a messaging channel.

## Quick Install (Recommended)

Run this one-liner to install everything automatically:

```bash
curl -fsSL https://install.cmem.ai/openclaw.sh | bash
```

The installer handles dependency checks (Bun, uv), plugin installation, memory slot configuration, AI provider setup, worker startup, and optional observation feed configuration — all interactively.

### Install with options

Pre-select your AI provider and API key to skip interactive prompts:

```bash
curl -fsSL https://install.cmem.ai/openclaw.sh | bash -s -- --provider=gemini --api-key=YOUR_KEY
```

For fully unattended installation (defaults to Claude Max Plan, skips observation feed):

```bash
curl -fsSL https://install.cmem.ai/openclaw.sh | bash -s -- --non-interactive
```

To upgrade an existing installation (preserves settings, updates plugin):

```bash
curl -fsSL https://install.cmem.ai/openclaw.sh | bash -s -- --upgrade
```

After installation, skip to [Step 4: Restart the Gateway and Verify](#step-4-restart-the-gateway-and-verify) to confirm everything is working.

---

## Manual Setup

The steps below are for manual installation if you prefer not to use the automated installer, or need to troubleshoot individual steps.

### Step 1: Clone the Claude-Mem Repo

First, clone the claude-mem repository to a location accessible by your OpenClaw gateway. This gives you the worker service source and the plugin code.

```bash
cd /opt  # or wherever you want to keep it
git clone https://github.com/thedotmack/claude-mem.git
cd claude-mem
npm install
npm run build
```

You'll need **bun** installed for the worker service. If you don't have it:

```bash
curl -fsSL https://bun.sh/install | bash
```

### Step 2: Get the Worker Running

The claude-mem worker is an HTTP service on port 37777. It stores observations, generates summaries, and serves the context timeline. The plugin talks to it over HTTP — it doesn't matter where the worker is running, just that it's reachable on localhost:37777.

#### Check if it's already running

If this machine also runs Claude Code with claude-mem installed, the worker may already be running:

```bash
curl http://localhost:37777/api/health
```

**Got `{"status":"ok"}`?** The worker is already running. Skip to Step 3.

**Got connection refused or no response?** The worker isn't running. Continue below.

#### If Claude Code has claude-mem installed

If claude-mem is installed as a Claude Code plugin (at `~/.claude/plugins/marketplaces/thedotmack/`), start the worker from that installation:

```bash
cd ~/.claude/plugins/marketplaces/thedotmack
npm run worker:restart
```

Verify:
```bash
curl http://localhost:37777/api/health
```

**Got `{"status":"ok"}`?** You're set. Skip to Step 3.

**Still not working?** Check `npm run worker:status` for error details, or check that bun is installed and on your PATH.

#### If there's no Claude Code installation

Run the worker from the cloned repo:

```bash
cd /opt/claude-mem  # wherever you cloned it
npm run worker:start
```

Verify:
```bash
curl http://localhost:37777/api/health
```

**Got `{"status":"ok"}`?** You're set. Move to Step 3.

**Still not working?** Debug steps:
- Check that bun is installed: `bun --version`
- Check the worker status: `npm run worker:status`
- Check if something else is using port 37777: `lsof -i :37777`
- Check logs: `npm run worker:logs` (if available)
- Try running it directly to see errors: `bun plugin/scripts/worker-service.cjs start`

### Step 3: Add the Plugin to Your Gateway

Add the `claude-mem` plugin to your OpenClaw gateway configuration:

From thedotmack/claude-mem, Apache-2.0.

More from thedotmack/claude-mem