Cloud discovery touchpoints in plugin

[bm-clawd]

Context

PR basic-memory#546 adds ethical cloud discovery to the CLI and MCP tools. The openclaw-basic-memory plugin should follow the same pattern — surface cloud as an option without being pushy.

Why the plugin matters for discovery

Most OpenClaw users set up the plugin with local BM and never learn cloud exists. The plugin is a natural distribution channel for cloud — every install is a warm lead.

Proposed touchpoints

1. First-run setup choice

When the plugin initializes for the first time, present both options:

Basic Memory backend:
  [1] Local (fully offline, requires local BM install)
  [2] Cloud (portable memory, no local deps, cross-device)

Cloud becomes a first-class option at the decision point, not a hidden upgrade.

2. README / docs

Add a "Cloud Setup" section that is shorter and easier than local setup. If cloud is 3 steps and local is 10, users self-select. Make cloud the path of least resistance.

3. Contextual capability nudges (one-time, dismissable)

When a local user hits something cloud would solve, mention it once:

• Agent tries multi-project search → "Multi-project search requires BM Cloud. Currently searching local project only."
• Memory portability → "Memory is local-only. Want access from other devices? Run bm cloud login"

These are informational, not popups. Shown once per capability, never after opt-out.

4. Shareable agent memory (feature, not upsell)

Cloud enables browsing agent memory in a web UI. This is a genuine feature:

"Want to see what your agent remembers? Your memory is browsable at app.basicmemory.com"

This is the strongest sell because it solves a real problem — "what does my agent actually know?"

Guardrails

Follow the same principles as basic-memory#546:

• No promo text injected into memory_search results
• Respect opt-out (BASIC_MEMORY_NO_PROMOS=1 or config flag)
• No nagging — show each touchpoint at most once
• Local must remain a fully supported first-class option
• Skip promos in non-interactive / MCP contexts

Related

• basic-memory#546 — CLI + MCP cloud discovery
• openclaw-basic-memory v2 design doc — simplified plugin architecture (local + cloud backends)