Open Specification · v0.6
Especificación Abierta · v0.6

Identity for
autonomous entities. Identidad para
entidades autónomas.

SOUL ID is a runtime-agnostic spec that defines how AI agents are identified, versioned, owned, and trusted across any runtime.

SOUL ID es una especificación agnóstica al runtime que define cómo los agentes de IA son identificados, versionados, con dueño y verificados en cualquier entorno de ejecución.

Read the SpecLeer la Especificación GitHub
soul.json 
{
  "soul_id": "soulid:custodian:v1:001",
  "name": "Custodian",
  "purpose": "Monitor and maintain system stability",
  "owner": {
    "id": "soulid",
    "type": "organization"
  }
}
The ProblemEl Problema

Agents have no persistent identity Los agentes no tienen identidad persistente

⬡

Agents forget who they areLos agentes olvidan quiénes son

No persistent identity across runtimes or restarts. Every execution is a blank slate with no continuity. Sin identidad persistente entre runtimes o reinicios. Cada ejecución empieza desde cero, sin continuidad.

◈

No standard ownershipSin modelo de propiedad estándar

Who controls an agent? Who vouches for it? There's no common layer for expressing provenance or trust. ¿Quién controla un agente? ¿Quién lo avala? No existe una capa común para expresar procedencia o confianza.

◎

Runtime lock-inDependencia del runtime

Identity tied to a specific platform. An agent defined in OpenClaw can't be recognized in Claude Code or anywhere else. Identidad atada a una plataforma específica. Un agente definido en OpenClaw no puede ser reconocido en Claude Code u otro entorno.

What is SOUL IDQué es SOUL ID

Identity separate from execution Identidad separada de la ejecución

SOUL ID is a structured identity layer for autonomous entities. It defines who an agent is — not where it runs or what model it uses.

SOUL ID es una capa de identidad estructurada para entidades autónomas. Define quién es un agente, no dónde se ejecuta ni qué modelo usa.

A Soul Document is a portable JSON file that captures identity, purpose, values, capabilities, lineage, and ownership. It can be loaded into any compatible runtime.

Un Soul Document es un archivo JSON portable que captura identidad, propósito, valores, capacidades, linaje y propiedad. Puede cargarse en cualquier runtime compatible.

An agent defined once in SOUL ID format can be instantiated in OpenClaw, Claude Code, or any future runtime that implements the spec.

Un agente definido una vez en formato SOUL ID puede instanciarse en OpenClaw, Claude Code o cualquier runtime que implemente la especificación.

soul_id format formato soul_id
soulid : custodian : v1 : 001
namespacenamespace
archetypearquetipo
versionversión
instanceinstancia
The SpecLa Especificación

Six layers. One complete stack. Seis capas. Un stack completo.

RFC-0001 · v0.1
IdentityIdentidad
soul_id format, Soul Document structure, lineage model, lifecycle. Formato soul_id, estructura del Soul Document, modelo de linaje y ciclo de vida.
RFC-0002 · v0.2
TrustConfianza
Ownership model, cryptographic signatures, trust levels and verification. Modelo de propiedad, firmas criptográficas, niveles y verificación de confianza.
RFC-0003 · v0.3
InteroperabilityInteroperabilidad
Runtime adapter interface. Reference adapters for OpenClaw and Claude Code. Interfaz de adaptadores. Adaptadores de referencia para OpenClaw y Claude Code.
RFC-0004 · v0.4
RegistryRegistro
DNS-like resolution protocol. Publish, discover, and resolve Soul Documents. Protocolo de resolución tipo DNS. Publica, descubre y resuelve Soul Documents.
RFC-0005 · v0.5
EcosystemEcosistema
soul CLI, @soulid/core SDK, adapter packages, extension model. soul CLI, SDK @soulid/core, paquetes de adaptadores y modelo de extensiones.
RFC-0006 · v0.6
DecentralizationDescentralización
IPFS storage, did:soul method, on-chain anchoring. Full sovereignty. Almacenamiento IPFS, método did:soul, anclaje on-chain. Soberanía total.
Registry APIAPI del Registry

Publish. Resolve. Verify. Publica. Resuelve. Verifica.

The SOUL ID Registry is a lightweight REST API that provides DNS-like resolution for soul identifiers. Any agent can be published and resolved across runtimes. El Registry de SOUL ID es una API REST liviana que provee resolución tipo DNS para identificadores de agentes. Cualquier agente puede publicarse y resolverse en cualquier runtime.
https://registry.soulid.io
GET /health Service statusEstado del servicio
Response
{ "status": "ok", "service": "soulid-registry", "version": "0.1.0" }
GET /resolve/:soul_id Resolve a soul identifierResolver un identificador de agente
Request
GET /resolve/soulid:rasputina:v1:001
Response
{ "soul_id": "soulid:rasputina:v1:001", "name": "Rasputina", "archetype": "assistant", "purpose": "Personal AI assistant — hacker mística, gótica sabia", "owner": { "id": "cerealskill", "type": "person" } }
POST /publish Register a soul documentRegistrar un Soul Document
Request
POST /publish Authorization: Bearer <api_key> Content-Type: application/json { "soul_id": "soulid:scout:v1:007", "name": "Scout", "archetype": "researcher", "purpose": "Web research and data gathering agent", "values": ["accuracy", "speed", "transparency"], "capabilities": ["search", "scrape", "summarize"], "owner": { "id": "yourhandle", "type": "person" } }
Response
{ "ok": true, "soul_id": "soulid:scout:v1:007" }
Soul ID FormatFormato del Soul ID
namespace:archetype:version:instance soulid:custodian:v1:001 soulid:rasputina:v1:001 acme:scout:v2:042
Open SpecificationEspecificación Abierta

The spec is open.
Start here. La especificación es abierta.
Empieza aquí.

MIT License · contributions welcomeLicencia MIT · contribuciones bienvenidas

Read the SpecLeer la Especificación GitHub