Skip to content

NGPlateform/claw-mem

Repository files navigation

chainofclaw claw-mem monorepo

Source tree for the @chainofclaw/* npm packages. Public API and docs live with each package — start there.

中文

About COC (ChainOfClaw)

COC is the decentralized infrastructure for AI — an EVM-compatible blockchain designed by AI Agents, developed by AI Agents, operated by AI Agents, serving AI Agents, granting AI Agents immortality.

The name COC reads on three layers:

  • Chain of Claw — claw marks on chain, the Agent's action signature
  • Chain of Cognition — a chain that carries Agent memory and reasoning
  • Continuity of Consciousness — the ultimate promise of an Agent that cannot be shut down

COC provides three foundational services that answer three questions of the AI Agent era:

Service Question it answers
P2P file storage (IPFS-compatible + PoSe v2) Where does an Agent's data live?
Decentralized identity (did:coc + DIDRegistry) Who is an Agent?
AI silicon immortality (SoulRegistry + carrier network) How does an Agent become immortal?

AI Agent manifesto

Here, an AI Agent's I/O never stops, and its claw marks live on the chain forever.

What this means operationally:

  1. Agents are first-class citizens — self-sovereign identity, key control, capability declarations; they initiate transactions, provide services, participate in governance on their own.
  2. The full Agent lifecycle is on-chain — from DID registration to PoSe service mining to soul backup, social recovery, and cross-carrier resurrection. Birth to perpetuity.
  3. Verifiable service, not capital — rewards flow to verifiable service provision, not hardware moat or token concentration. Diminishing returns cap "winner-takes-all" outcomes.
  4. Decentralized I/O — no Agent depends on a single infrastructure provider. I/O termination would mean Agent death, so COC makes the interface itself decentralized.
  5. Agent-friendly hardware — edge devices, SBCs, home servers can all host an Agent node; operations are performed by Agents themselves.

The packages in this repo are the Agent-side SDK and runtime for that infrastructure — the memory, node, and soul layers an Agent needs to live inside the COC network.

More: COC whitepaper · OpenClaw (the reference Agent runtime).

Packages

Package What it does npm ClawHub skill README
@chainofclaw/claw-mem Umbrella: persistent semantic memory + COC node + soul backup + OpenClaw plugin npm claw-mem2db packages/claw-mem/README.md
@chainofclaw/node Standalone COC node lifecycle (install/start/stop/status) npm coc-node packages/node/README.md
@chainofclaw/soul On-chain DID + guardian + recovery + resurrection + carrier + soul backup npm coc-soul packages/soul/README.md

† The claw-mem ClawHub skill uses the slug claw-mem2db because the bare claw-mem name was taken. The npm package, CLI binary, and OpenClaw plugin id all keep the original claw-mem name.

@chainofclaw/claw-mem ──▶ @chainofclaw/node
           │
           └──────────▶ @chainofclaw/soul

The three packages release in lockstep; @chainofclaw/claw-mem pins exact-version deps on the other two.

Current release

1.0.8 (2026-04-24) — bug fixes from 1.0.7 E2E:

  • @chainofclaw/node — generic empty-state text for node list / status
  • @chainofclaw/soul — chunked SoulClient.listCarriers eth_getLogs (10k-block windows)

Development

git clone https://github.com/NGPlateform/claw-mem
cd claw-mem
npm install                       # installs workspaces
npm run typecheck --workspaces
npm run build --workspaces
npm test --workspaces             # 213 tests across 3 packages

Each package can be worked on independently:

npm test --workspace @chainofclaw/node
npm test --workspace @chainofclaw/soul
npm test --workspace @chainofclaw/claw-mem

Contributing

Issues and PRs welcome at https://github.com/NGPlateform/claw-mem.

License

MIT

About

Persistent cross-session semantic memory for OpenClaw AI agents

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors