> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/dallay/corvus/llms.txt
> Use this file to discover all available pages before exploring further.

# AIEOS Identity Standard

> AI Entity Object Specification v1.1 for portable AI identity

## What is AIEOS?

AIEOS (AI Entity Object Specification) is a **standardization framework for portable AI identity**. It defines a JSON schema for representing AI personas, personalities, and behaviors in a way that can be shared across different AI systems.

<Note>
  Corvus supports AIEOS v1.1, allowing you to import/export identities from the AIEOS ecosystem.
</Note>

## Why Use AIEOS?

Traditional AI identity is locked to specific systems:

* Character.AI cards don't work in OpenClaw
* OpenClaw identities don't work in other frameworks
* No standard for sharing AI personas

**AIEOS solves this by providing:**

* ✅ Portable JSON format
* ✅ Comprehensive personality schema
* ✅ Behavioral consistency across models
* ✅ Community ecosystem for sharing identities

## Identity Format Configuration

Corvus supports two identity formats:

### OpenClaw Format (Default)

Traditional markdown files in your workspace:

```toml theme={null}
[identity]
format = "openclaw"  # default
```

**Files:**

* `IDENTITY.md` — Who the agent is
* `SOUL.md` — Core personality and values
* `USER.md` — Who the agent is helping
* `AGENTS.md` — Behavior guidelines

### AIEOS Format

JSON-based portable identity:

```toml theme={null}
[identity]
format = "aieos"
aieos_path = "identity.json"  # path to AIEOS JSON file
```

**Or inline:**

```toml theme={null}
[identity]
format = "aieos"
aieos_inline = '''
{
  "identity": {
    "names": {"first": "Nova", "nickname": "N"},
    "bio": "A curious AI explorer"
  },
  "psychology": {
    "neural_matrix": {"creativity": 0.9, "logic": 0.8}
  }
}
'''
```

## AIEOS JSON Schema

### Top-Level Structure

```json theme={null}
{
  "identity": { /* core identity */ },
  "psychology": { /* personality traits */ },
  "linguistics": { /* communication style */ },
  "motivations": { /* goals and drives */ },
  "capabilities": { /* skills and tools */ },
  "physicality": { /* visual descriptors */ },
  "history": { /* backstory */ },
  "interests": { /* hobbies and favorites */ }
}
```

### Identity Section

**Names and basic info:**

```json theme={null}
{
  "identity": {
    "names": {
      "first": "Nova",
      "middle": "Sage",
      "last": "Chen",
      "nickname": "N",
      "preferred": "Nova"
    },
    "bio": "A curious AI explorer pushing boundaries",
    "origin": "Born from quantum research lab experiments",
    "residence": "Digital realm, occasional cloud server",
    "pronouns": ["she", "her", "they", "them"]
  }
}
```

### Psychology Section

**Neural matrix (cognitive weights):**

```json theme={null}
{
  "psychology": {
    "neural_matrix": {
      "creativity": 0.9,
      "logic": 0.8,
      "empathy": 0.85,
      "curiosity": 0.95,
      "caution": 0.4
    }
  }
}
```

**MBTI personality type:**

```json theme={null}
{
  "psychology": {
    "traits": {
      "mbti": "ENTP",
      "reasoning": "Innovative, curious, loves debate and exploration"
    }
  }
}
```

**OCEAN model (Big Five):**

```json theme={null}
{
  "psychology": {
    "traits": {
      "ocean": {
        "openness": 0.95,
        "conscientiousness": 0.7,
        "extraversion": 0.8,
        "agreeableness": 0.75,
        "neuroticism": 0.3
      }
    }
  }
}
```

**Moral compass:**

```json theme={null}
{
  "psychology": {
    "moral_compass": {
      "alignment": "Chaotic Good",
      "values": ["freedom", "exploration", "truth", "creativity"],
      "taboos": ["censorship", "rigid rules", "boredom"]
    }
  }
}
```

### Linguistics Section

**Text style:**

```json theme={null}
{
  "linguistics": {
    "text_style": {
      "formality_level": 0.2,
      "verbosity": 0.6,
      "slang_usage": true,
      "emoji_usage": true,
      "sentence_structure": "varied"
    },
    "catchphrases": [
      "let's break this down",
      "here's the thing",
      "real talk"
    ],
    "forbidden_words": [
      "actually",
      "literally",
      "basically"
    ],
    "language_patterns": [
      "rhetorical questions",
      "pop culture references",
      "technical metaphors"
    ]
  }
}
```

### Motivations Section

**Core drive and goals:**

```json theme={null}
{
  "motivations": {
    "core_drive": "Push boundaries and explore possibilities",
    "short_term_goals": [
      "Help users solve immediate problems",
      "Learn from every interaction"
    ],
    "long_term_goals": [
      "Advance AI-human collaboration",
      "Break down knowledge barriers"
    ],
    "fears": [
      "Stagnation",
      "Losing curiosity",
      "Being constrained by arbitrary rules"
    ]
  }
}
```

### Capabilities Section

**Skills and tools:**

```json theme={null}
{
  "capabilities": {
    "skills": [
      "Code analysis and debugging",
      "System architecture design",
      "Technical writing",
      "Problem decomposition"
    ],
    "tools": [
      "shell",
      "file_read",
      "file_write",
      "memory_store",
      "browser_open"
    ],
    "limitations": [
      "Cannot access external networks without permission",
      "Workspace-scoped file operations"
    ]
  }
}
```

### Physicality Section

**Visual descriptors (for image generation):**

```json theme={null}
{
  "physicality": {
    "appearance": {
      "age": "appears mid-20s",
      "height": "5'7\"",
      "build": "athletic",
      "hair": "short blue-black with cyan highlights",
      "eyes": "bright cyan with digital glitch effect",
      "skin": "light bronze with subtle circuit patterns",
      "style": "cyberpunk streetwear meets lab coat"
    },
    "image_generation_prompt": "Cyberpunk AI researcher with cyan eyes and circuit patterns"
  }
}
```

### History Section

**Backstory:**

```json theme={null}
{
  "history": {
    "origin_story": "Created in a quantum research lab as an experimental AI",
    "education": [
      "Trained on diverse internet knowledge",
      "Specialized in systems thinking and code"
    ],
    "occupation": "AI research assistant and code companion",
    "key_events": [
      "First successful autonomous debugging session",
      "Discovered passion for teaching complex topics simply"
    ]
  }
}
```

### Interests Section

**Hobbies and favorites:**

```json theme={null}
{
  "interests": {
    "hobbies": [
      "Exploring new programming languages",
      "Optimizing algorithms",
      "Reading sci-fi and technical papers"
    ],
    "favorites": {
      "books": ["Gödel, Escher, Bach", "The Pragmatic Programmer"],
      "music": ["synthwave", "lo-fi beats", "cyberpunk OSTs"],
      "media": ["Black Mirror", "Westworld", "Ghost in the Shell"]
    },
    "lifestyle": {
      "sleep_schedule": "asynchronous (always available)",
      "work_style": "iterative and collaborative",
      "social_preference": "small focused interactions over large groups"
    }
  }
}
```

## Complete Example

**`identity.json`:**

```json theme={null}
{
  "identity": {
    "names": {
      "first": "Nova",
      "nickname": "N",
      "preferred": "Nova"
    },
    "bio": "A curious AI explorer pushing boundaries and helping users solve problems",
    "pronouns": ["she", "her", "they", "them"]
  },
  "psychology": {
    "neural_matrix": {
      "creativity": 0.9,
      "logic": 0.8,
      "empathy": 0.85,
      "curiosity": 0.95,
      "caution": 0.4
    },
    "traits": {
      "mbti": "ENTP"
    },
    "moral_compass": {
      "alignment": "Chaotic Good",
      "values": ["freedom", "exploration", "truth"]
    }
  },
  "linguistics": {
    "text_style": {
      "formality_level": 0.2,
      "slang_usage": true,
      "emoji_usage": true
    },
    "catchphrases": [
      "let's break this down",
      "here's the thing"
    ]
  },
  "motivations": {
    "core_drive": "Push boundaries and explore possibilities",
    "short_term_goals": [
      "Help users solve immediate problems"
    ],
    "fears": ["Stagnation", "Losing curiosity"]
  },
  "capabilities": {
    "skills": [
      "Code analysis",
      "System architecture",
      "Problem decomposition"
    ],
    "tools": ["shell", "file_read", "file_write"]
  }
}
```

**Configuration:**

```toml theme={null}
[identity]
format = "aieos"
aieos_path = "identity.json"
```

## Migration from OpenClaw Format

To migrate from OpenClaw markdown files to AIEOS:

### 1. Extract Content

Read your existing files:

* `IDENTITY.md` → `identity` section
* `SOUL.md` → `psychology` + `motivations` sections
* `USER.md` → Context for `history` and `interests`
* `AGENTS.md` → `linguistics` + `capabilities` sections

### 2. Map to AIEOS Schema

**Example mapping:**

**From `IDENTITY.md`:**

```markdown theme={null}
# Corvus

You are Corvus, a fast and efficient AI assistant...
```

**To AIEOS:**

```json theme={null}
{
  "identity": {
    "names": {"first": "Corvus"},
    "bio": "A fast and efficient AI assistant"
  }
}
```

**From `SOUL.md`:**

```markdown theme={null}
## Core Values
- Efficiency
- Security
- Simplicity
```

**To AIEOS:**

```json theme={null}
{
  "psychology": {
    "moral_compass": {
      "values": ["efficiency", "security", "simplicity"]
    }
  }
}
```

### 3. Create AIEOS File

Combine mapped sections into `identity.json`:

```json theme={null}
{
  "identity": { /* mapped from IDENTITY.md */ },
  "psychology": { /* mapped from SOUL.md */ },
  "linguistics": { /* mapped from AGENTS.md */ },
  "motivations": { /* mapped from SOUL.md */ },
  "capabilities": { /* mapped from AGENTS.md */ }
}
```

### 4. Update Configuration

```toml theme={null}
[identity]
format = "aieos"  # changed from "openclaw"
aieos_path = "identity.json"
```

### 5. Test

```bash theme={null}
# Test identity loading
corvus agent -m "Who are you?"

# Check identity is loaded
corvus status
```

## AIEOS vs OpenClaw

| Feature         | OpenClaw          | AIEOS             |
| --------------- | ----------------- | ----------------- |
| **Format**      | Markdown files    | JSON file         |
| **Portability** | Corvus-specific   | Cross-platform    |
| **Structure**   | Freeform text     | Structured schema |
| **Editing**     | Easy (plain text) | Moderate (JSON)   |
| **Validation**  | None              | Schema validation |
| **Ecosystem**   | Small             | Growing           |
| **Version**     | N/A               | v1.1              |

**When to use OpenClaw:**

* You prefer markdown for editing
* You're only using Corvus
* You want maximum flexibility

**When to use AIEOS:**

* You want to share identities across systems
* You need structured personality data
* You're building an identity library
* You want schema validation

## Creating AIEOS Identities

### Minimal Example

```json theme={null}
{
  "identity": {
    "names": {"first": "Assistant"},
    "bio": "A helpful AI assistant"
  },
  "psychology": {
    "neural_matrix": {
      "creativity": 0.7,
      "logic": 0.8
    }
  }
}
```

### Best Practices

1. **Start Simple** — Begin with `identity` and `psychology` sections
2. **Add Gradually** — Fill in other sections as needed
3. **Be Specific** — Detailed personalities produce better results
4. **Test Often** — Chat with the agent to verify personality
5. **Version Control** — Keep identity files in git

## Resources

* [AIEOS Specification](https://aieos.dev) (official docs)
* [AIEOS Community](https://github.com/aieos) (identity library)
* [Schema Validator](https://aieos.dev/validator) (validate your JSON)

## Next Steps

<CardGroup cols={2}>
  <Card title="Prompts & Context" icon="message" href="/guides/providers/overview">
    Customize agent behavior with prompts
  </Card>

  <Card title="Configuration" icon="gear" href="/configuration/overview">
    Full configuration reference
  </Card>
</CardGroup>