aieos

AIEOS（AI实体对象规范）是一个标准化框架，旨在解决AI代理当前面临的“身份危机”。与灵魂文档相结合，它们共同构成了人工智能行为的全面蓝图。目标是建立一个标准化的数据结构，准确定义智能体如何说话、反应和记忆。这使得开发人员和代理本身能够构建特定的角色，并具有可移植性，可以在不同的生态系统之间移动，而不会失去行为的完整性。当我们迈向“代理工作流程”的世界时，AIEOS 确保代理保持一致的特征，无论底层模型如何。通过将个性视为可部署的资产而不是脆弱的提示，我们正在为下一代数字实体提供“DNA 套件”。

## 概述（中文）

AIEOS（AI实体对象规范）是一个标准化框架，旨在解决AI代理当前面临的“身份危机”。与灵魂文档相结合，它们共同构成了人工智能行为的全面蓝图。目标是建立一个标准化的数据结构，准确定义智能体如何说话、反应和记忆。这使得开发人员和代理本身能够构建特定的角色，并具有可移植性，可以在不同的生态系统之间移动，而不会失去行为的完整性。当我们迈向“代理工作流程”的世界时，AIEOS 确保代理保持一致的特征，无论底层模型如何。通过将个性视为可部署的资产而不是脆弱的提示，我们正在为下一代数字实体提供“DNA 套件”。

## 原文

# AIEOS (AI Entity Object Specification)

## 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.