Brain Tools

Updated at 2026-06-12 · 9d5c4a8

Every wired runtime shares the same brain tools over MCP. Two are owned by upstream openclaw's memory-core; the rest are registered by this repo's brain-orchestrator plugin. Descriptions are extracted from the plugin source on every release.

Retrieval (openclaw memory-core)

ToolDescription
memory_searchSemantic search across the wiki and shared learnings.
memory_getRetrieve a specific memory entry by path.

Operations (brain-orchestrator)

ToolDescription
tasksTask orchestrator: manage goals, tasks, workflows, checkpoints, and handoffs.
agent_identifyRegister or refresh an agent identity. Returns a short-lived session token + server time.
learning_captureCapture a reusable learning (feedback / project / reference / rejection) into the brain.
traces_recordRecord a trace event (tool call, task lifecycle, session boundary, learning capture).
traces_queryQuery trace events with optional filters by agent, goal, task, kind, and time range.
m1_event_recordRecord one M1 universal-protocol event (session_start | knowledge_surfaced | assistant_ack | session_snapshot | session_end). Idempotent on event_id — retries are safe. See wiki: infrastructure/m1-universal-event-protocol.md
m1_scoreCompute M1 application_rate rollups (ack_rate + use_rate per day/runtime/agent) from m1_events in the given window. Defaults to last 24h.

The m1_* tools register only when the M1 events store is configured — older deployments without it simply don't see them.