oc-memory

/oc-memory Command

Manage agent memory: initialize workspaces, audit health, flush important facts, search across memory, and manage shared memory.

Arguments

The user provides: $ARGUMENTS

Parse the subcommand and optional flags:

• Subcommand (required): init, audit, flush, search, shared
• --agent <id> — target a specific agent (default: scan all agents)
• --query <text> — search query (required for search subcommand)
• --namespace <name> — namespace for shared memory operations

If no subcommand is given, show usage:

Usage: /oc-memory <init|audit|flush|search|shared> [options]

  init    [--agent <id>]              Initialize memory structure
  audit   [--agent <id>]              Check memory health
  flush   [--agent <id>]              Persist important facts
  search  --query <text> [--agent <id>]  Search across memory
  shared  [list|create|update] [--namespace <name>]  Manage team memory

Subcommand: init

Initialize memory structure for an agent workspace.

# Find agent workspaces
WORKSPACE_ROOT="${HOME}/.openclaw/workspace/agents-workspaces"

If --agent <id> is given, target that agent. Otherwise, ask the user which agent to initialize.

Steps

1. Create memory/ directory if missing:

mkdir -p "$WORKSPACE_ROOT/$AGENT_ID/memory"
mkdir -p "$WORKSPACE_ROOT/$AGENT_ID/memory/archive"

1. Create empty MEMORY.md with header template if missing:

# MEMORY.md

> 200-line budget. Updated weekly by SCRIBE compression.
> Only durable facts, decisions, and preferences belong here.

## Preferences

## Architecture Decisions

## Known Issues

## Key Facts

1. Seed today's daily log if missing:

# YYYY-MM-DD

## Decisions

## Facts Learned

## Actions Taken

## Open Questions

1. If multiple agents detected, create team-memory/ at workspace root:

AGENT_COUNT=$(ls "$WORKSPACE_ROOT" 2>/dev/null | wc -l)
if [ "$AGENT_COUNT" -gt 1 ]; then
  mkdir -p "$WORKSPACE_ROOT/../team-memory"
fi