Skip to content

ReMe memory for OpenClaw

中文说明

ReMe gives OpenClaw file-native long-term memory while keeping durable memory in a workspace you own. The plugin uses OpenClaw's native lifecycle, hooks, tools, and memory slot.

What the plugin does

  • Registers reme_search for explicit memory lookup.
  • Recalls relevant memory before conversational root-agent runs.
  • Captures completed user/assistant turns in background batches.
  • Runs optional daily auto_dream memory consolidation in the workspace timezone.
  • Excludes subagent, cron, heartbeat, memory, and overflow runs by default.
  • Wraps recalled content in <reme-context> and marks it as untrusted historical data.

Requirements

  • OpenClaw 2026.7.1 or later.
  • Node.js 22.22.3+, 24.15.0+, or 25.9.0+ on the corresponding supported major-version line.
  • A running ReMe HTTP service with the search, auto_memory, and auto_dream jobs.

Start ReMe

Install ReMe and start its local HTTP service:

bash
pip install "reme-ai[core]"
reme start workspace_dir=/absolute/path/to/workspace

The default endpoint is http://127.0.0.1:2333. ReMe's HTTP service does not use API-key authentication, so keep it on loopback or another trusted network unless you provide a protected proxy boundary.

Install the OpenClaw plugin

Install explicitly from ClawHub:

bash
openclaw plugins install clawhub:@agentscope-ai/reme

When another memory plugin is enabled, select reme for plugins.slots.memory. OpenClaw remains authoritative for conversation access and prompt-injection permissions; grant them to ReMe when your policy requires explicit consent. The plugin does not rewrite Gateway configuration.

Configuration

OptionDefaultMeaning
endpointhttp://127.0.0.1:2333ReMe HTTP service URL
languageenMemory guidance language: en or zh
autoRecalltrueRecall before conversational root-agent runs
searchLimit5Maximum search results
recallMinScore0Minimum automatic-recall score
autoMemoryEnabledtrueCapture completed conversational turns
autoMemoryInterval5Submit after this many completed turns
autoDreamEnabledtrueEnable daily memory consolidation
dreamCron0 23 * * *Daily schedule in the workspace timezone
dreamHintemptyOptional guidance sent to auto_dream
rootAgentsOnlytrueExclude subagents from guidance and capture
timezoneAsia/ShanghaiIANA timezone used for batches and scheduling
requestTimeoutMs10000Recall and explicit-search timeout
backgroundTimeoutMs3600000Automatic-memory and dream timeout
shutdownTimeoutMs5000Best-effort Gateway shutdown drain budget

Configuration changes apply to subsequent runs. Failed automatic-memory batches are retained for retry, and the Gateway shutdown hook attempts to flush pending work within shutdownTimeoutMs.

Source and license

ReMe is developed at agentscope-ai/ReMe and released under Apache-2.0.

Released under the Apache-2.0 License.