Filesystemコンポーネント

エージェントのリレーショナルな部分は config を指し、ディスク上の部分はインストールルート以下に配置されます。レイアウトは単一のフラットなツリーではなく、スコープごとに編成されます。インスタンス全体の状態、エージェント間で共有されるリソース、エージェントごとのプライベートデータには、それぞれ専用のトップレベルディレクトリが割り当てられます。

<install>/
├── data/                         — instance-wide state (not per-agent)
│   ├── sessions/                 — chat session stores
│   │   └── sessions.db, acp-sessions.db
│   ├── state/                    — runtime state
│   │   └── costs.jsonl, runtime-trace.jsonl
│   ├── devices.db                — paired-device metadata
│   └── memory/                   — shared instance memory
│       └── brain.db, audit.db, response_cache.db,
│           MEMORY_SNAPSHOT.md, archive/
├── shared/                       — resources agents draw on in common
│   └── skills/<bundle>/          — skill bundles
│       └── SKILL.md, scripts/, references/, assets/
└── agents/                       — per-agent private data
    └── <alias>/
        └── workspace/            — the agent's jailed filesystem sandbox
            └── memory/
                └── brain.db

3つのルートは3つのスコープにマッピングされます:

• data/ は、個々のエージェントではなくインストール全体に属する状態を保持します: チャットの sessions/、ランタイムの state/（コスト追跡など）、devices.db 内のペアリング済みデバイスのメタデータ、および data/memory/ 下の共有インスタンスメモリ。有効なゲートウェイベアラートークンは設定状態のままです。devices.db により、ペアリング済みデバイスを可視化・管理できます。
• shared/ にはエージェントが共通で利用するリソースが格納されており、特に shared/skills/<bundle>/ 配下のスキルバンドルが含まれます。
• agents/<alias>/ には、1つのエージェントに固有のすべてのプライベートな情報が格納されます。デフォルトでは、エージェントのワークスペースは <install>/agents/<alias>/workspace/ であり、エージェントが読み書きするすべての情報はこの中に保持されます。エージェントのアイデンティティソースは、このワークスペースを基準にして解決されます。クロスエージェントアクセスを明示的に許可しない限り、エージェントは自身のワークスペースに**隔離（jail）**されます。

ワークスペース

ワークスペースはエージェントのファイルシステムサンドボックスです。以下のフィールドはスキーマから生成されます。

zeroclaw config set agents.<alias>.workspace.access <value>

export ZEROCLAW_agents__<alias>__workspace__access=

zeroclaw config set agents.<alias>.workspace.path <value>

export ZEROCLAW_agents__<alias>__workspace__path=

zeroclaw config set agents.<alias>.workspace.read_memory_from <value>

export ZEROCLAW_agents__<alias>__workspace__read_memory_from=

zeroclaw config set agents.<alias>.workspace.unrestricted_filesystem <value>

export ZEROCLAW_agents__<alias>__workspace__unrestricted_filesystem=

注目に値する点が2つあります:

• access はエージェント間のファイルシステム共有のためのインバウンド許可リストです。空の場合はジェイル状態（自身のワークスペースのみ）を意味します。エントリは、指定された兄弟エージェントにこのエージェントのワークスペースへの読み取りまたは書き込みモードを付与します。
• unrestricted_filesystem はエスケープハッチです。true の場合、エージェントはホストファイルシステムが許可するあらゆるものにアクセスできます。デフォルトではオフになっており、これを有効にすると監査の対象となります。

メモリ

各エージェントは、ワークスペース配下（agents/<alias>/workspace/memory/）に独自のメモリストアを保持し、data/memory/ 内の共有インスタンスメモリとは分離されています。バックエンドはエージェントごとに選択されます:

zeroclaw config set agents.<alias>.memory.backend <value>

export ZEROCLAW_agents__<alias>__memory__backend=

バックエンドは新しいエージェントに対してデフォルトで SQLite を使用し、エージェントがディスク上にデータを書き込むとその値はロックされるため、既存のメモリの下でバックエンドを黙って入れ替えることはできません。エージェント間のメモリ共有は、ワークスペースの read_memory_from 許可リストによるオプトイン方式です。メモリモデル自体については、Runtime internals を参照してください。システム横断的な状態マップについては、Runtime state and persistence を参照してください。

ID情報

エージェントのアイデンティティ（その個性）は、エージェントごとに設定されます。

zeroclaw config set agents.<alias>.identity.aieos_inline <value>

export ZEROCLAW_agents__<alias>__identity__aieos_inline=

zeroclaw config set agents.<alias>.identity.aieos_path <value>

export ZEROCLAW_agents__<alias>__identity__aieos_path=

zeroclaw config set agents.<alias>.identity.format <value>

export ZEROCLAW_agents__<alias>__identity__format=

format は ID の読み込み方法を選択します。デフォルトではプロジェクトのパーソナリティファイルを読み込みます。代替の方法では、ワークスペースからの相対パスまたはインラインのいずれかで AIEOS JSON 定義を読み込みます。