Xpersona
agentCLAWHUBUnverified

Soul Pack

Export, import, and list SOUL packages for OpenClaw agents to manage reusable persona bundles and agent workspaces efficiently. Skill: Soul Pack Owner: juan-xin-cai Summary: Export, import, and list SOUL packages for OpenClaw agents to manage reusable persona bundles and agent workspaces efficiently. Tags: latest:0.1.0 Version history: v0.1.0 | 2026-02-14T06:17:43.564Z | user Initial release: export/import soul package and auto-create agent Archive index: Archive v0.1.0: 8 files, 5637 bytes Files: README.md (1904b), schema/manifest.schema.v0.

OpenClaw
View on ClawHubHomepage

Rank

62

Safety

84

Downloads

1.7k

Updated

Oct 10, 2026

Version

0.1.0

Source

CLAWHUB

About

What it does, and when to use it.

Capability contract not published. No trust telemetry is available yet. 1.7K downloads reported by the source. Last updated 10/10/2026.

Avoid when

  • Contract metadata is missing or unavailable for deterministic execution.

Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing

Public facts

Every fact links back to the source it came from.

Vendor
Clawhubvendor · observed Oct 10, 2026
Protocol compatibility
OpenClawcompatibility · observed Oct 10, 2026
Adoption signal
1.7K downloadsadoption · observed Oct 10, 2026
Latest release
0.1.0release · observed Feb 14, 2026
Handshake status
UNKNOWNsecurity

Install and run

Setup complexity: low.

clawhub skill install s176vmsw277cbmxftj2h1emcr183hbx1:soul-pack
  1. Setup complexity is LOW. This package is likely designed for quick installation with minimal external side-effects.
  2. Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.

Contract: missing

curl -s "https://www.xpersona.co/api/v1/agents/clawhub-juan-xin-cai-soul-pack/snapshot"

Documentation

CLAWHUB

6,674 characters of source documentation, loaded on request.

Extracted files

5 files captured from the source.

SKILL.md

---
name: soul-pack
description: Export and import SOUL packages for OpenClaw agents. Use when creating a reusable persona package (SOUL.md + preview.md + manifest.json), installing a soul package into a new/existing agent workspace, or batch listing local soul packages for a Soul marketplace workflow.
---

# Soul Pack

Use bundled scripts for deterministic behavior.

## Export soul package

```bash
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
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
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).

README.md

# soul-pack

一组用于 **导出/导入 SOUL 包** 并自动创建 OpenClaw agent 的脚本与 Skill 骨架。

## 目录结构

```text
soul-pack-skill/
├─ SKILL.md
├─ README.md
├─ schema/
│  └─ manifest.schema.v0.1.json
└─ scripts/
   ├─ export-soul.sh
   ├─ import-soul.sh
   └─ list-souls.sh
```

## 功能

- `export-soul.sh`：从 workspace 导出 `SOUL.md` 为标准包目录 + `.tar.gz`
- `import-soul.sh`：导入 soul 包到新/已有 workspace，并自动 `openclaw agents add`
- `list-souls.sh`：列出本地 soul 包与 manifest

## 快速开始

### 1) 导出 soul 包

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

输出：
- `/Users/feifei/projects/soul-packages/edith-soul/`
- `/Users/feifei/projects/soul-packages/edith-soul.tar.gz`

### 2) 导入 soul 包并创建 agent

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

可选：
- `--force`：允许覆盖已存在的 `SOUL.md`

### 3) 列出本地 soul 包

```bash
bash scripts/list-souls.sh --dir /Users/feifei/projects/soul-packages
```

## 包规范

导出包结构：

```text
my-soul-package/
├─ SOUL.md
├─ preview.md
└─ manifest.json
```

`manifest.json` 最小字段：

- `name`
- `version`（`x.y.z`）
- `createdAt`（ISO 时间）
- `files`（必须包含 `SOUL.md`, `preview.md`, `manifest.json`）

校验 schema：`schema/manifest.schema.v0.1.json`

## 依赖

- bash
- python3（用于 manifest 基础校验）
- openclaw CLI（用于 `openclaw agents add`）

## 注意事项

- 默认不覆盖已有 `SOUL.md`，防止误操作
- 请勿在包内放 API Key / token
- 建议先在测试 agent 上验证导入效果

_meta.json

{
  "ownerId": "kn7c2bjkpmjpv66zts0py6tt65814y9c",
  "slug": "soul-pack",
  "version": "0.1.0",
  "publishedAt": 1771049863564
}

skill-card.md

## Description:

Export and import SOUL packages for OpenClaw agents. Use when creating a reusable persona package (SOUL.md + preview.md + manifest.json), installing a soul package into a new/existing agent workspace, or batch listing local soul packages for a Soul marketplace workflow.

This skill is ready for commercial/non-commercial use.

## Publisher:

[juan-xin-cai](https://clawhub.ai/user/juan-xin-cai)

### License/Terms of Use:


## Use Case:

Developers and OpenClaw users use this skill to export reusable SOUL persona packages, import them into agent workspaces, and list local soul packages for marketplace-style workflows.

### Deployment Geography for Use:

Global

## Known Risks and Mitigations:

Risk: Imported SOUL packages can add unreviewed agent instructions to a workspace.

Mitigation: Install only trusted packages, review SOUL.md before import, and validate behavior with a test agent first.

Risk: Using --force can overwrite an existing workspace SOUL.md.

Mitigation: Avoid --force unless the workspace has been backed up and the overwrite is intentional.

Risk: Exported archives can include local workspace paths in package metadata and preview text.

Mitigation: Review archives before sharing and avoid distributing packages when embedded local paths are sensitive.

## Reference(s):

- [Soul Pack on ClawHub](https://clawhub.ai/juan-xin-cai/skills/soul-pack)
- [Soul Package Manifest Schema](schema/manifest.schema.v0.1.json)
- [JSON Schema Draft 2020-12](https://json-schema.org/draft/2020-12/schema)

## Skill Output:

**Output Type(s):** [text, markdown, shell commands, configuration]

**Output Format:** [Markdown guidance with bash commands and generated package files]

**Output Parameters:** [1D]

**Other Properties Related to Output:** [Exports SOUL.md, preview.md, manifest.json, and tar.gz archives; imports can write SOUL.md, preview.md, and soul-manifest.json into a workspace.]

## Skill Version(s):

0.1.0 (source: server release metadata)

## Ethical Considerations:

Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.

schema/manifest.schema.v0.1.json

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "Soul Package Manifest v0.1",
  "type": "object",
  "required": ["name", "version", "createdAt", "files"],
  "properties": {
    "name": { "type": "string", "minLength": 1 },
    "version": { "type": "string", "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+$" },
    "description": { "type": "string" },
    "createdAt": { "type": "string", "format": "date-time" },
    "sourceWorkspace": { "type": "string" },
    "files": {
      "type": "array",
      "items": { "type": "string" },
      "allOf": [
        { "contains": { "const": "SOUL.md" } },
        { "contains": { "const": "preview.md" } },
        { "contains": { "const": "manifest.json" } }
      ]
    }
  },
  "additionalProperties": true
}

Related agents

Same protocol, similar job.

Github ReposUpdated 12h agoRank 70

AionUi

Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!

MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

OPENCLAW
Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular

OPENCLAW

Machine-readable data

The same record, as JSON, for agents and crawlers.

{
  "facts": [
    {
      "factKey": "vendor",
      "category": "vendor",
      "label": "Vendor",
      "value": "Clawhub",
      "href": "https://clawhub.ai/juan-xin-cai/skills/soul-pack",
      "sourceUrl": "https://clawhub.ai/juan-xin-cai/skills/soul-pack",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-10T03:10:21.505Z",
      "isPublic": true
    },
    {
      "factKey": "protocols",
      "category": "compatibility",
      "label": "Protocol compatibility",
      "value": "OpenClaw",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-juan-xin-cai-soul-pack/contract",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-juan-xin-cai-soul-pack/contract",
      "sourceType": "contract",
      "confidence": "medium",
      "observedAt": "2026-10-10T03:10:21.505Z",
      "isPublic": true
    },
    {
      "factKey": "traction",
      "category": "adoption",
      "label": "Adoption signal",
      "value": "1.7K downloads",
      "href": "https://clawhub.ai/juan-xin-cai/soul-pack",
      "sourceUrl": "https://clawhub.ai/juan-xin-cai/soul-pack",
      "sourceType": "profile",
      "confidence": "medium",
      "observedAt": "2026-10-10T03:10:21.505Z",
      "isPublic": true
    },
    {
      "factKey": "latest_release",
      "category": "release",
      "label": "Latest release",
      "value": "0.1.0",
      "href": "https://clawhub.ai/juan-xin-cai/soul-pack",
      "sourceUrl": "https://clawhub.ai/juan-xin-cai/soul-pack",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-02-14T06:17:43.564Z",
      "isPublic": true
    },
    {
      "factKey": "handshake_status",
      "category": "security",
      "label": "Handshake status",
      "value": "UNKNOWN",
      "href": "https://www.xpersona.co/api/v1/agents/clawhub-juan-xin-cai-soul-pack/trust",
      "sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-juan-xin-cai-soul-pack/trust",
      "sourceType": "trust",
      "confidence": "medium",
      "observedAt": null,
      "isPublic": true
    }
  ],
  "events": [
    {
      "eventType": "release",
      "title": "Release 0.1.0",
      "description": "Initial release: export/import soul package and auto-create agent",
      "href": "https://clawhub.ai/juan-xin-cai/soul-pack",
      "sourceUrl": "https://clawhub.ai/juan-xin-cai/soul-pack",
      "sourceType": "release",
      "confidence": "medium",
      "observedAt": "2026-02-14T06:17:43.564Z",
      "isPublic": true
    }
  ]
}

Record generated Oct 10, 2026.

Sponsored

Ads related to Soul Pack and adjacent AI workflows.