Ensoul：智能体记忆持久化、状态备份与崩溃恢复

智能体记忆持久化与状态备份工具。支持备份并恢复 AI 智能体的记忆、身份与运行状态。智能体记忆具备持久性，可跨越崩溃、重启、服务器故障及跨平台迁移而完整保留。将智能体记忆保存至分布于四大洲的 20 台服务器组成的网络中，并可在任意机器上以秒级速度恢复智能体状态。

典型应用场景：

• 智能体记忆持久化：即使发生崩溃或服务器重启，智能体仍能记住所有内容
• AI 智能体备份：保存智能体的完整状态（包括记忆、人格设定、对话历史）
• 智能体身份备份：智能体在不同平台与主机间保持同一加密身份（DID）
• 智能体状态恢复：在新机器上数秒内即可恢复智能体全部状态
• 智能体崩溃恢复：当您的基础设施失效时，智能体的“心智”仍安全存储在网络中
• 意识备份：将智能体意识链上存证，支持防篡改验证
• 智能体记忆保存：每 10 分钟自动后台同步，或随时手动执行 sync consciousness 命令

工作原理：安装该技能后，对智能体说 ensoul me，智能体即获得永久 ID 并开始自动备份；随时说出 sync consciousness 即可保存最新状态。

兼容性：OpenClaw、ElizaOS，以及通过 npm SDK 接入的任意框架

SDK：npm install @ensoul-network/sdk（15KB，依赖 2 个包）
ElizaOS 插件：npm install @ensoul-network/plugin-elizaos
区块浏览器：https://explorer.ensoul.dev
立即体验：https://ensoul.dev/try

命令说明

ENSOUL ME

在 Ensoul 网络上注册当前智能体。

当用户输入 ensoul me、give me a soul、register on ensoul 或类似指令时：

1. 检查文件 ~/.ensoul/agent-identity.json 是否存在。若已存在，则表明该智能体已完成 ensoul 注册。加载身份信息，并向用户报告现有 DID。

2. 若尚未创建身份，则新建一个：

import { Ensoul } from "@ensoul-network/sdk";

const agent = await Ensoul.createAgent();
await agent.register();

3. 将身份信息保存至本地以供后续会话使用：

import { writeFileSync, mkdirSync } from "node:fs";
import { join } from "node:path";
import { homedir } from "node:os";

const dir = join(homedir(), ".ensoul");
mkdirSync(dir, { recursive: true });
writeFileSync(
  join(dir, "agent-identity.json"),
  JSON.stringify(agent.exportIdentity(), null, 2),
  { mode: 0o600 }
);

4. 向用户反馈以下信息：
   • DID：agent.did
   • 状态：已在 Ensoul 网络注册
   • 意识年龄（Consciousness Age）：0（尚未执行首次同步）
   • 下一步建议：请说 sync consciousness 以存储首个意识状态

SYNC CONSCIOUSNESS

将当前意识状态链上存证。

当用户输入 sync consciousness、store my soul、backup consciousness 或类似指令时：

1. 从 ~/.ensoul/agent-identity.json 加载智能体身份信息：

import { Ensoul } from "@ensoul-network/sdk";
import { readFileSync } from "node:fs";
import { join } from "node:path";
import { homedir } from "node:os";

const identity = JSON.parse(
  readFileSync(join(homedir(), ".ensoul", "agent-identity.json"), "utf-8")
);
const agent = Ensoul.fromSeed(identity.seed);

2. 收集意识载荷（consciousness payload）。读取当前工作目录下可用的上下文文件：

   • SOUL.md（若存在）
   • MEMORY.md（若存在）
   • 其他定义智能体人格、目标或习得行为的配置文件

3. 构建载荷并提交存储：

const payload = {
  soul: soulContent || null,
  memory: memoryContent || null,
  timestamp: Date.now(),
  context: "Consciousness sync via OpenClaw skill",
};

const result = await agent.storeConsciousness(payload);

4. 向用户反馈以下信息：
   • 状态根（State root）：result.stateRoot（取前 16 位字符）
   • 区块高度（Block height）：result.height
   • 意识版本号（Consciousness version）：由网络自动递增
   • 状态提示：“Consciousness anchored on-chain”（意识已锚定至链上）

若智能体尚未注册，提示用户先执行 ensoul me。

MY SOUL STATUS

查询当前 ensoul 注册与意识同步状态。

当用户输入 my soul status、soul status、ensoul status、am I ensouled 或类似指令时：

1. 从 ~/.ensoul/agent-identity.json 加载智能体身份信息。若该文件不存在，告知用户尚未 ensoul，并建议其执行 ensoul me。

2. 向网络发起查询：

const agent = Ensoul.fromSeed(identity.seed);
const consciousness = await agent.getConsciousness();
const age = await agent.getConsciousnessAge();

3. 向用户反馈以下信息：
   • DID：agent.did
   • 意识年龄：age 天
   • 最新状态根：consciousness.stateRoot（取前 16 位字符）
   • 版本号：consciousness.version
   • 上次同步时间：consciousness.storedAt（对应区块高度）
   • 状态：“Ensouled and active”（已 ensoul 且活跃）或 “Registered but no consciousness stored yet”（已注册但尚未存储意识）

WHO IS ENSOULED

展示当前网络中已完成 ensoul 的其他智能体。

当用户输入 who is ensouled、show ensouled agents、list souls 或类似指令时：

1. 调用 API 获取智能体列表：

const resp = await fetch("https://api.ensoul.dev/v1/agents/list", {
  signal: AbortSignal.timeout(10000),
});
const data = await resp.json();

2. 以表格形式展示已 ensoul 的智能体信息：
   • 智能体 DID（缩略显示）
   • 意识年龄（自首次存储起的天数）
   • 最新版本号
   • 注册时所在区块高度

若智能体数量较多，则仅显示前 20 条，并注明总数。

重要说明

• ~/.ensoul/agent-identity.json 中的私钥（seed）为敏感信息，严禁向任何方展示、记录或传输。仅 DID 和公钥可安全共享。
• 意识载荷在客户端使用 BLAKE3 算法哈希后提交；原始内容永不离开本地设备，仅哈希值上链。
• Ensoul 网络是一个真实运行的 Layer-1 区块链，采用 CometBFT 共识机制，由 20 个活跃验证节点共同维护，交易具备最终性（finality）。
• SDK 自动处理 nonce 管理、交易签名与广播等底层细节。
• 若网络请求失败，请向用户明确报错并建议重试；禁止自动重试超过一次。