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:

bash

npx nexo-brain

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

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 Usenexo_startupOnce at session start — registers session, returns active sessionsnexo_heartbeatEvery interaction — updates task, checks inboxnexo_cognitive_retrieveSemantic search across all memoriesnexo_guard_checkBefore editing code — checks for past errorsnexo_learning_addAfter resolving an error — prevents recurrencenexo_session_diary_writeBefore closing session — enables continuitynexo_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#

• GitHub
• npm