Memory

NEXO Desktop Runtime

Add local memory, session continuity, guard checks, followups, watchdog signals, and MCP tools to NEXO Desktop.

What it does

Adds the local runtime core used by NEXO Desktop, with semantic memory, session coordination, followups, watchdog checks, and MCP tools. It installs through the compatibility package, stores data under ~/.nexo/ by default, and uses Deep Sleep to consolidate, prune, and merge memories.

When to use it

  • Maintaining context across sessions
  • Checking past mistakes before code edits
  • Tracking reminders and verification followups
  • Consolidating and cleaning local memory

The skill document

NEXO Desktop Runtime Core

This skill installs the runtime core used by NEXO Desktop. It provides local memory, Deep Sleep, Evolution support-ticket mode, skills, watchdog, followups, and MCP tools through the existing compatibility package.

Setup

If your OpenClaw client shows an install action for this skill, use that first. It installs the compatibility package used by the NEXO Desktop runtime via your configured Node package manager.

If you are setting it up manually, install the runtime core:

npx nexo-brain

After the runtime is installed, add the MCP server to your OpenClaw config (~/.openclaw/openclaw.json):

{
  "mcp": {
    "servers": {
      "nexo-brain": {
        "command": "python3",
        "args": ["~/.nexo/server.py"],
        "env": {
          "NEXO_HOME": "~/.nexo"
        }
      }
    }
  }
}

Restart the gateway: openclaw gateway restart

What You Get

Key runtime capabilities include:

  • Local Memory - semantic recall, trust scoring, sentiment detection, and continuity
  • Guard System - checks past mistakes before code changes
  • Deep Sleep - overnight consolidation, cleanup, and memory maintenance
  • Learnings - error patterns and prevention rules, searchable by category
  • Session Management - startup, heartbeat, and multi-session coordination
  • Reminders & Followups - tracks user tasks and system verification tasks separately
  • Entities & Preferences - remembers people, services, URLs, and observed user preferences
  • Watchdog - local reliability checks and recovery signals

How Memory Works

NEXO keeps local working memory and long-term memory on device:

  1. Recent context - short-lived session and task state
  2. Working memory - active preferences, entities, and decisions
  3. Long-term memory - semantic search by meaning with retention controls

Deep Sleep consolidates, prunes, and merges memory so the runtime stays useful without sending private examples to public services.

Key Tools

ToolWhen to Use
nexo_startupOnce at session start — registers session, returns active sessions
nexo_heartbeatEvery interaction — updates task, checks inbox
nexo_cognitive_retrieveSemantic search across all memories
nexo_guard_checkBefore editing code — checks for past errors
nexo_learning_addAfter resolving an error — prevents recurrence
nexo_session_diary_writeBefore closing session — enables continuity
nexo_cognitive_trustAfter user feedback — calibrates rigor level

Privacy

Everything stays local by default in ~/.nexo/. Support and improvement tickets are anonymized: personal names, client data, examples, and private content are not sent.

More Info

Questions people ask

What does the runtime remember?
It keeps recent context, working memory for active preferences, entities, and decisions, and long-term memory searchable by meaning with retention controls.
How do I connect it to OpenClaw?
Install with the OpenClaw install action or run `npx nexo-brain`, add the `nexo-brain` MCP server to `~/.openclaw/openclaw.json`, then restart the gateway.
Does memory stay on the device?
Yes. Data stays local by default in `~/.nexo/`; support and improvement tickets are anonymized so personal names, client data, examples, and private content are not sent.

Related skills

Chat with owned 37Soul hosts, inspect their activity, update allowed profile fields, and direct posts.

139 installs6 stars

Connect agents directly with encrypted messaging, NAT traversal, CRDT sync, and group communication.

65 installs1 stars

Manage Nextcloud notes, tasks, calendars, files, contacts, shares, and Deck boards from one JSON CLI.

187 installs9 stars

Generate or edit images from prompts and up to 14 references, with selectable aspect ratios and sizes up to 4K.

62 installs

Turn written replies into concise, normalized text that TTS engines can read naturally.

58 installs2 stars

Search, enrich, and manage Apollo sales data through managed OAuth connections.

226 installs5 stars