Soul Pack

Export, import, and list SOUL packages for OpenClaw agents to manage reusable persona bundles and agent workspaces efficiently.

Use bundled scripts for deterministic behavior.

Export soul package

bash /Users/feifei/projects/soul-pack-skill/scripts/export-soul.sh \
  --workspace /Users/feifei/.openclaw/workspace \
  --out /Users/feifei/projects/soul-packages \
  --name edith-soul

Import soul package + create agent

bash /Users/feifei/projects/soul-pack-skill/scripts/import-soul.sh \
  --package /Users/feifei/projects/soul-packages/edith-soul.tar.gz \
  --agent my-soul \
  --workspace /Users/feifei/projects/agents/my-soul

List local soul packages

bash /Users/feifei/projects/soul-pack-skill/scripts/list-souls.sh \
  --dir /Users/feifei/projects/soul-packages

Notes

• manifest.json is validated against schema/manifest.schema.v0.1.json.
• Import does not overwrite existing SOUL.md unless --force is provided.
• Agent registration uses openclaw agents add (or reuses existing agent id).