oc-structure

/oc-structure Command

Inspect the OpenClaw workspace directory layout at ~/.openclaw/.

Arguments

Parse from $ARGUMENTS:

• audit (default): Full workspace structure overview and health check
• agents: List agent workspaces and their contents
• comms: Show communication channels and recent messages
• memory: Inspect memory/lancedb and shared knowledge

Execution

audit (default)

# Show top-level structure
ls -la ~/.openclaw/ 2>/dev/null || echo "~/.openclaw/ not found — run /oc-setup first"

# Show workspace contents
ls -la ~/.openclaw/workspace/ 2>/dev/null

# Count agent workspaces
echo "Agent workspaces:"
ls ~/.openclaw/workspace/agents-workspaces/ 2>/dev/null || echo "  (none)"

# Check key files exist
echo ""
echo "Core files:"
for f in openclaw.json models.json workspace/CLAUDE.md workspace/TASKS.json workspace/SPRINT_CURRENT.json workspace/SHARED_KNOWLEDGE.json workspace/IMPROVEMENT_BACKLOG.json; do
  [ -f ~/.openclaw/$f ] && echo "  OK: $f" || echo "  MISSING: $f"
done

# Check auth file permissions
echo ""
echo "Auth file permissions:"
find ~/.openclaw/workspace/agents-workspaces/ -name "auth-profiles.json" -exec stat -c '%a %n' {} \; 2>/dev/null || echo "  (no auth files found)"

Present a summary of what exists, what's missing, and any permission issues.

agents

# List all agent workspaces
ls -la ~/.openclaw/workspace/agents-workspaces/ 2>/dev/null || echo "No agent workspaces found"

# For each agent, show key files
for dir in ~/.openclaw/workspace/agents-workspaces/*/; do
  agent=$(basename "$dir")
  echo ""
  echo "--- $agent ---"
  ls "$dir" 2>/dev/null
  # Show role from IDENTITY.md first line
  head -3 "$dir/IDENTITY.md" 2>/dev/null
done

Present a table of agents with their roles and available files.

comms

# Show communication structure
echo "Communication channels:"
find ~/.openclaw/workspace/comms/ -type f 2>/dev/null || echo "  (none)"

# Show broadcast messages
echo ""
echo "Broadcast:"
cat ~/.openclaw/workspace/comms/broadcast.md 2>/dev/null || echo "  (no broadcast messages)"

# Show recent inbox messages per agent
for dir in ~/.openclaw/workspace/comms/*/inbox/; do
  agent=$(basename "$(dirname "$dir")")
  count=$(ls "$dir" 2>/dev/null | wc -l)
  [ "$count" -gt 0 ] && echo "  $agent inbox: $count message(s)"
done