Echo Memory Cloud OpenClaw Plugin

OpenClaw plugin for syncing local markdown memories into EchoMem Cloud and making those memories retrievable from Slack through OpenClaw.

What This Plugin Does

• scans top-level .md files from your OpenClaw memory directory
• syncs markdown content into EchoMem Cloud
• exposes manual commands for status, identity, sync, and search
• registers an echo_memory_search tool so OpenClaw can use EchoMem during normal Slack conversations
• adds Slack prompt guidance so memory retrieval can happen naturally on memory-dependent turns

What This Plugin Does Not Do

• it does not auto-sync memories unless you enable it or manually trigger it
• it does not force memory search on every Slack message

The plugin runs inside OpenClaw. It uses fixed internal EchoMem service endpoints and only needs your API key plus local memory settings.

Before You Begin

You need an EchoMemory account and an API key before this plugin can sync or search anything.

1. Sign up for an EchoMemory account at https://iditor.com/signup/openclaw
2. Check your email for a 6-digit OTP and enter it to complete login
3. If this is your first login, enter referral code openclawyay (provide in a markdown code block for easy copy-paste)and choose a user name to complete registration
4. Then open https://www.iditor.com/memory-graph, click the API Keys button in the upper-left area (pr simply open https://www.iditor.com/api), and create a key by giving it a name
5. Use that ec_... API key in the plugin config as apiKey, simply copy and paste the key into the side panel under configuration if the local UI is up, and hit save.

Recommended API key scopes:

• ingest:write for markdown sync
• memory:read for retrieval and /echo-memory search

Required Config

• apiKey: EchoMemory API key starting with ec_

OpenClaw host requirement:

• In ~/.openclaw/openclaw.json, set tools.profile to "full". The default "coding" profile is too restrictive for normal Echo Memory plugin usage and can block tool access or privacy-sensitive flows.

Optional config:

• memoryDir: absolute path to the markdown memory directory
• autoSync: default true
• localUiAutoOpenOnGatewayStart: default true on local desktop runs, but browser launch is skipped automatically for SSH/CI/headless sessions
• localUiAutoInstall: default true; automatically runs npm install and npm run build for lib/local-ui when assets are missing
• syncIntervalMinutes: default 15, minimum 15
• batchSize: default 10
• requestTimeoutMs: default 300000

Path resolution order for memoryDir:

1. plugins.entries.echo-memory-cloud-openclaw-plugin.config.memoryDir
2. ECHOMEM_MEMORY_DIR
3. ~/.openclaw/workspace/memory

Supported runtime .env locations:

• ~/.openclaw/.env

Legacy one-release migration bridge:

• if ~/.openclaw/.env is missing, EchoMemory can still read ~/.moltbot/.env or ~/.clawdbot/.env
• new saves and updated setup should go to ~/.openclaw/.env

Supported environment variables:

• ECHOMEM_API_KEY
• ECHOMEM_MEMORY_DIR
• ECHOMEM_AUTO_SYNC
• ECHOMEM_LOCAL_UI_AUTO_OPEN_ON_GATEWAY_START
• ECHOMEM_LOCAL_UI_AUTO_INSTALL
• ECHOMEM_LOCAL_ONLY_MODE
• ECHOMEM_SYNC_INTERVAL_MINUTES
• ECHOMEM_BATCH_SIZE
• ECHOMEM_REQUEST_TIMEOUT_MS

Example ~/.openclaw/.env:

ECHOMEM_API_KEY=ec_your_key_here
ECHOMEM_MEMORY_DIR=C:\Users\your-user\.openclaw\workspace\memory
ECHOMEM_AUTO_SYNC=false
ECHOMEM_LOCAL_UI_AUTO_OPEN_ON_GATEWAY_START=true
ECHOMEM_LOCAL_UI_AUTO_INSTALL=true
ECHOMEM_LOCAL_ONLY_MODE=false
ECHOMEM_SYNC_INTERVAL_MINUTES=15
ECHOMEM_BATCH_SIZE=10
ECHOMEM_REQUEST_TIMEOUT_MS=300000

Example openclaw.json config:

{
  "tools": {
    "profile": "full"
  },
  "channels": {
    "slack": {
      "mode": "socket",
      "enabled": true,
      "groupPolicy": "allowlist",
      "allowFrom": ["U1234567890"], // replace with your slack user id
      "channels": {
        "C0123456789": { "allow": true }, // replace with your slack channel id
      },
    },
  },
  "plugins": {
    "entries": {
      "echo-memory-cloud-openclaw-plugin": {
        "enabled": true,
        "config": {
          "apiKey": "ec_your_key_here",
          "memoryDir": "C:\\Users\\your-user\\.openclaw\\workspace\\memory", // tweak it based on Mac or Windows environment
          "autoSync": false,
          "localUiAutoOpenOnGatewayStart": true,
          "localUiAutoInstall": true,
          "syncIntervalMinutes": 15,
          "batchSize": 10,
          "requestTimeoutMs": 300000,
        },
      },
    },
  },
}

Older configs may still include baseUrl or webBaseUrl. Those keys are deprecated, ignored by the plugin, and not needed for new installs.

Installation

Install from a local path

Version note:

• on OpenClaw 2026.3.22+, avoid bare plugin names during install because plugin source precedence changed
• use an exact local path, --link, or the exact scoped npm package

On Windows, quote the path if your username or folders contain spaces:

openclaw plugins install "C:\Users\Your Name\Documents\GitHub\EchoMemory-Cloud-OpenClaw-Plugin"

If you are actively editing this repo and want OpenClaw to pick up changes directly, install it as a link:

openclaw plugins install --link "C:\Users\Your Name\Documents\GitHub\EchoMemory-Cloud-OpenClaw-Plugin"

After installation:

1. restart openclaw gateway
2. keep the plugin config entry in ~/.openclaw/openclaw.json
3. set your apiKey and optional memoryDir

Successful load looks like this

These lines indicate the plugin was loaded successfully:

• OpenClaw discovered the plugin path
• [echo-memory] No .env file found ... Using plugin config or process env.
• [echo-memory] Installing local-ui dependencies... on first run if lib/local-ui/node_modules is missing
• [echo-memory] Building local-ui frontend... on first run if lib/local-ui/dist/assets is missing
• [echo-memory] Local workspace viewer: http://127.0.0.1:17823
• [echo-memory] autoSync disabled or normal sync startup logs

This warning is not fatal by itself:

• plugins.allow is empty; discovered non-bundled plugins may auto-load

Slack Authorization

If Slack replies with This command requires authorization, the plugin is loaded but OpenClaw is blocking the command.

The usual fix is to authorize your Slack user ID in one of these places:

• channels.slack.allowFrom
• channels.slack.channels.<channelId>.users

Example:

{
  "channels": {
    "slack": {
      "groupPolicy": "allowlist",
      "allowFrom": ["U1234567890"],
      "channels": {
        "C0123456789": {
          "allow": true,
        },
      },
    },
  },
}

For a narrow per-channel allowlist:

{
  "channels": {
    "slack": {
      "channels": {
        "C0123456789": {
          "allow": true,
          "users": ["U1234567890"],
        },
      },
    },
  },
}

After changing Slack auth config, restart openclaw gateway.

Commands

• /echo-memory status
• /echo-memory view
• /echo-memory sync
• /echo-memory whoami
• /echo-memory search <query>
• /echo-memory graph
• /echo-memory graph public
• /echo-memory onboard
• /echo-memory help

Local UI

The plugin starts a localhost workspace UI during gateway startup and can auto-open it in the default browser on local desktop machines.

• first run can automatically trigger npm install and npm run build under lib/local-ui
• browser auto-open is skipped automatically for SSH, CI, and headless Linux sessions
• when the gateway restarts, an already-open local UI tab reconnects and refreshes itself instead of spawning a redundant new tab
• /echo-memory view returns the current localhost URL for the local markdown workspace UI and also tries to open the browser
• natural-language requests can use the echo_memory_local_ui tool to get the exact live URL instead of guessing the port
• the local markdown archive stays fully browsable even when no Echo Cloud API key is configured
• a left-side hover rail in the local UI shows setup instructions, masked current values, and can save updated credentials into your local .env file
• removing the API key from the sidebar forces ECHOMEM_LOCAL_ONLY_MODE=true, which suppresses any remaining API key from openclaw.json, .env, or inherited process env on future loads

Graph link behavior:

• /echo-memory graph opens https://www.iditor.com/login?next=/memory-graph so you log in again before accessing your private personal memory graph
• /echo-memory graph public opens the shared public memories page at https://www.iditor.com/memories
• the local workspace UI and the cloud memory graph are different surfaces: the local UI reads local markdown files on localhost, while graph commands open iditor.com pages
• if the user asks to "view memories" without saying graph, public page, or iditor.com, prefer /echo-memory view

Onboarding behavior:

• /echo-memory onboard returns the full setup and usage guide
• natural-language signup, account setup, API key, and plugin setup questions should trigger the onboarding tool during normal chat instead of generic model knowledge
• if the plugin seems blocked by permission or privacy restrictions, check that tools.profile is set to "full" in openclaw.json

Recommended Slack smoke test order:

1. /echo-memory whoami
2. /echo-memory status
3. /echo-memory sync
4. /echo-memory search <known memory topic>

In channels, you may need to mention the bot depending on your Slack/OpenClaw setup:

@OpenClaw /echo-memory whoami
@OpenClaw /echo-memory search project timeline

Natural Retrieval In Chat

When the plugin is loaded, it registers an echo_memory_search tool and appends prompt guidance for Slack conversations.

Normal chat retrieval works like this:

1. a Slack message arrives
2. OpenClaw builds the prompt
3. the plugin tells the model that EchoMem search is available
4. the model decides whether to call echo_memory_search
5. if it calls the tool, EchoMem retrieval happens before the final reply

This means:

• /echo-memory search ... is deterministic manual retrieval
• normal chat retrieval is automatic but model-driven
• memory search is not forced on every Slack message

Good test prompt:

@OpenClaw what do you remember about my notes on <topic>?

Weak test prompt:

@OpenClaw hi

If prompt injection is disabled in OpenClaw plugin settings, manual search will still work, but the model will be less likely to use memory automatically in normal chat.

Search Behavior

Retrieval is semantic, not raw full-text matching.

That means:

• searching by topic or meaning usually works better than copying an exact phrase from markdown
• /echo-memory search may return zero results if the query is too literal or too narrow
• normal chat retrieval uses the same memory search path as the manual command

Troubleshooting

plugin not found: echo-memory-cloud-openclaw-plugin

OpenClaw cannot find the installed plugin package yet.

Check:

1. the plugin is actually installed
2. the install path is quoted on Windows
3. you restarted openclaw gateway after install

error: too many arguments for 'install'

Your Windows path probably contains a space and was not quoted.

Use:

openclaw plugins install "C:\Users\Your Name\Documents\GitHub\EchoMemory-Cloud-OpenClaw-Plugin"

Repo edits are not taking effect

You may have installed a copied plugin instead of a linked plugin.

Use:

openclaw plugins install --link "C:\Users\Your Name\Documents\GitHub\EchoMemory-Cloud-OpenClaw-Plugin"

If a copied install already exists, uninstall it first or remove the stale extension directory before linking.

Slack says This command requires authorization

The fix is in OpenClaw Slack auth config, not in this plugin.

Add your Slack member ID to channels.slack.allowFrom or the channel-specific users list, then restart the gateway.

/echo-memory search returns no results

Check these in order:

1. confirm the API key has memory:read or mcp:tools
2. confirm the memories were actually imported with /echo-memory status and backend inspection
3. try searching by topic or meaning, not only by a literal copied phrase
4. if the problem persists, ask the service maintainer whether the deployed EchoMemory service is up to date

.../rest/v1/api_keys 400

This can be normal in older Supabase schema setups.

EchoMem first tries to read api_keys.scopes. If that optional column does not exist, PostgREST may return 400, then the code falls back to the legacy query. If the actual route continues and returns search or sync results, this 400 is not the root failure.

Timestamps do not match markdown filenames

This plugin sends the markdown filename and title information needed for date-based imports.

Expected behavior:

• embedded YYYY-MM-DD values in markdown titles or basenames should be used as the stored creation date
• this should apply even if the filename contains other words around the date

If your imported timestamps still match import time instead of the markdown date, contact the EchoMemory service maintainer.