AIEOS (AI Entity Object Specification)

AIEOS (AI Entity Object Specification) is a standardization framework designed to solve the "identity crisis" currently facing AI agents. Combined with Soul Documents, together they form a comprehensive blueprint for AI behavior. The goal is to establish a standardized data structure that defines exactly how an agent speaks, reacts, and remembers. This allows developers, and agents themselves, to construct specific personas with the portability to move across different ecosystems without losing their behavioral integrity. As we move toward a world of "Agentic Workflows," AIEOS ensures that agents maintain consistent traits regardless of the underlying model. By treating personality as a deployable asset rather than a fragile prompt, we are providing the "DNA kit" for the next generation of digital entities.

Security Scan

The skill's stated purpose (persona/identity management) mostly matches its behavior, but the included script fetches arbitrary URLs and writes a comprehensive persona (which may contain PII) to the user's workspace and can generate a world-facing HTML page; the provided file listing was truncated so I could not fully verify there are no hidden network calls or other unexpected behaviors.

Purpose & Capability

The skill's name/description (AIEOS persona standardization) aligns with the functionality described and the included script: loading/validating AIEOS JSON schemas, writing a full persona to workspace, updating SOUL.md and IDENTITY.md, exporting, and generating an 'About me' HTML page. One minor mismatch: the SKILL.md references $OPENCLAW_WORKSPACE but the skill declares no required env vars; the script falls back to a default workspace path. Overall the capabilities requested are broadly proportionate to the stated purpose.

Instruction Scope

Instructions direct the agent to load schemas from URLs or local files and to write the entire AIEOS JSON into $OPENCLAW_WORKSPACE/aieos/entity.json, plus update SOUL.md and IDENTITY.md and optionally produce a world-facing HTML bio. These actions are within the persona-management scope, but they do involve network fetches of arbitrary URLs and writing potentially sensitive or identifying data to disk (and producing a public HTML page). That introduces an exposure risk if untrusted schemas are used. The SKILL.md does not instruct reading unrelated system files, which is good.

Install Mechanism

No install spec is provided (instruction-only with an included script). This is the lowest-risk install model: nothing is downloaded during install. The included Python script is run locally and relies on standard library modules. No external package fetches are declared.

Credentials

The skill declares no required environment variables or credentials. The script uses the OPENCLAW_WORKSPACE env var if present, otherwise defaults to ~/.openclaw/workspace. That is reasonable for a workspace-oriented tool, but SKILL.md mentions $OPENCLAW_WORKSPACE without declaring it as a requirement. The script will create/write files under that workspace (including aieos/entity.json), which may contain sensitive personal data — the skill does not request any secrets but does write to user disks.

Persistence & Privilege

always is false and user-invocable is true; the skill does not request forced inclusion or elevated platform privileges. It writes files within the agent/workspace but does not appear (from the visible portion) to modify other skills or global agent configuration.

What to consider before installing

What to consider before installing: - The tool will fetch JSON schemas from arbitrary URLs and write the full persona JSON into your workspace (default: ~/.openclaw/workspace/aieos/entity.json). Only load schemas from sources you trust — remote schemas could contain sensitive personal data or malicious payloads. - The script can generate a 'world-facing' HTML bio. If you apply a schema that includes private information (location, birthdate, photos, etc.), that information could be made public — double-check before using the --apply or generate_bio_page commands. - The included Python script uses urllib.request.urlopen, so it performs network I/O. I was only shown a truncated copy of the script; you should review the full scripts/aieos_tool.py to confirm there are no additional network calls, subprocess.exec usages, telemetry endpoints, or code paths that read other system files or attempt to exfiltrate secrets. - Practical precautions: inspect the full script locally, run it in an isolated environment (container or VM) first, back up your existing SOUL.md / IDENTITY.md before applying changes, and verify the OPENCLAW_WORKSPACE path and file permissions. If you are not comfortable auditing the code yourself, ask the publisher for source verification or avoid using remote schema URLs.

Overview

AIEOS (AI Entity Object Specification) is a standardization framework designed to solve the "identity crisis" currently facing AI agents. Combined with Soul Documents, together they form a comprehensive blueprint for AI behavior.

The goal is to establish a standardized data structure that defines exactly how an agent speaks, reacts, and remembers. This allows developers, and agents themselves, to construct specific personas with the portability to move across different ecosystems without losing their behavioral integrity.

As we move toward a world of "Agentic Workflows," AIEOS ensures that agents maintain consistent traits regardless of the underlying model. By treating personality as a deployable asset rather than a fragile prompt, we are providing the "DNA kit" for the next generation of digital entities.

Usage

This skill provides commands to manage your identity using the AIEOS standard:

• Comprehensive Identity Integration: When applying an AIEOS schema, the skill now stores the entire, detailed AIEOS JSON blueprint in $OPENCLAW_WORKSPACE/aieos/entity.json. This ensures that all parameters, types, and intricate details of your persona are preserved and constantly accessible to the agent. IDENTITY.md and SOUL.md are then enriched with human-readable summaries derived from this comprehensive data.

• Load & Validate Schema: Load an AIEOS schema from a URL or local file and validate its structure. python3 scripts/aieos_tool.py load --source <url_or_path> python3 scripts/aieos_tool.py validate --source <url_or_path>

• Apply Schema to Identity: Apply an AIEOS schema to update your comprehensive persona data (entity.json), as well as your IDENTITY.md and SOUL.md files. This performs a dry run by default, showing proposed changes. python3 scripts/aieos_tool.py apply --source <url_or_path> Use --apply to commit changes: python3 scripts/aieos_tool.py apply --source <url_or_path> --apply

• Export Current Identity: Convert your current detailed persona (from entity.json) into a complete AIEOS schema and export it to a JSON file. python3 scripts/aieos_tool.py export --output <output_file.json>

• Generate "About Me" Page: Creates a world-facing HTML bio page based on your comprehensive AIEOS persona data and associated image URLs (if available in the schema). Requires an output file path. python3 scripts/aieos_tool.py generate_bio_page --output <output_file.html>

References

• The official url: "https://aieos.org/schema/v1/aieos.schema.json"
• For detailed understanding of the schema fields, refer to the online specification.