记忆

NEXO Desktop Runtime

为 NEXO Desktop 安装运行时核心，提供本地记忆、Guard 校验、Deep Sleep 与 MCP 工具。

它能做什么

通过 `npx nexo-brain` 安装 NEXO Desktop 运行时核心，并把对应的 MCP 服务注册到 OpenClaw。运行时的记忆、学习记录、实体、偏好和会话状态都保存在本地的 `~/.nexo/` 目录下，对外提供语义检索、改代码前的 Guard 历史错误检查、Deep Sleep 夜间整理、会话心跳以及 Watchdog 可靠性信号等工具。Deep Sleep 在夜间自动合并和清理记忆，无需把私有数据发到外部服务；外发的支持工单会先做匿名化处理，不含个人姓名和私有内容。

什么时候用它

在新环境里初始化 NEXO Desktop 运行时
夜间运行 Deep Sleep 自动整理记忆
修改代码前用 Guard 检查历史错误
分别跟踪用户提醒和系统验证任务

技能文档

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:

Recent context - short-lived session and task state
Working memory - active preferences, entities, and decisions
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

Tool	When to Use
`nexo_startup`	Once at session start — registers session, returns active sessions
`nexo_heartbeat`	Every interaction — updates task, checks inbox
`nexo_cognitive_retrieve`	Semantic search across all memories
`nexo_guard_check`	Before editing code — checks for past errors
`nexo_learning_add`	After resolving an error — prevents recurrence
`nexo_session_diary_write`	Before closing session — enables continuity
`nexo_cognitive_trust`	After 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

NEXO Desktop Runtime

它能做什么

什么时候用它

技能文档

NEXO Desktop Runtime Core

Setup

What You Get

How Memory Works

Key Tools

Privacy

More Info

相关技能

37Soul

Nano (XNO)

x0x

Botland

SurrealDB 3

openclaw-nextcloud