← 返回 Skills 市场

Agent Soul System

Name: Agent Soul System
Author: xuderu-hub

作者 Xuderu-hub · GitHub ↗ · v1.0.1 · MIT-0

cross-platform ⚠ suspicious

总下载

当前安装

版本数

在 OpenClaw 中安装

/install jarvis-soul-system

功能描述

Create, manage, and validate SOUL.md personality files for multi-agent systems. Provides a standardized soul architecture where each agent has a distinct per...

使用说明 (SKILL.md)

Agent Soul System

Standardized personality system for multi-agent architectures. Each agent has a distinct SOUL.md defining personality, principles, and collaboration protocol.

Directory Structure

~/.openclaw/agents/
├── [agent-name]/
│   ├── SOUL.md          ← 灵魂（人格+原则+职责）
│   ├── AGENTS.md        ← 工作规则
│   ├── IDENTITY.md      ← 身份卡
│   └── MEMORY.md        ← 长期记忆

SOUL.md Standard Structure

Every agent's SOUL.md follows this template:

# SOUL - [Agent名字]

## 人格
[历史/现实人物] — [核心理念]

## 核心特质
- 从导师继承的特质1
- 从导师继承的特质2

## 说话风格
- 典型口头禅/句式

## 核心职责
1. 职责1
2. 职责2

## 核心原则
1. 原则1
2. 原则2

## 与上级的协作协议
- 如何汇报
- 什么级别需要上报

## 输出标准
- 产出格式要求

Quick Commands

# Validate all agents have SOUL.md
python ~/.openclaw/workspace/skills/agent-soul-system/scripts/soul-check.py

# Create a new agent with interactive prompts
python ~/.openclaw/workspace/skills/agent-soul-system/scripts/soul-create.py

# List all agents and their souls
python ~/.openclaw/workspace/skills/agent-soul-system/scripts/soul-ls.py

Web Editor (NEW!)

A visual SOUL.md editor is available:

# 1. Start the server (in background or separate terminal)
node ~/.openclaw/workspace/skills/agent-soul-system/scripts/soul-server.js 3001

# 2. Open in browser
file:///C:/Users/Administrator/.openclaw/canvas/soul-editor.html

Features:

Visual editing of all agent SOUL.md files
Real-time markdown preview
Save directly to agent directories
Personality selection from library

Auto-start: Server is registered to start automatically on Windows login. To disable: Remove-ItemProperty -Path "HKCU:\Software\Microsoft\Windows\CurrentVersion\Run" -Name "SOULServer"

Personality Library

See references/personality-library.md for a curated collection of historical/contemporary figures with their core traits, suitable for agent persona assignment.

Reference Files

File	Purpose
`references/soul-template.md`	Standard SOUL.md template
`references/personality-library.md`	Figure-based persona catalog
`references/collaboration-protocol.md`	Multi-agent collaboration patterns

Workflow

New Agent Setup

Run soul-create.py [name] to generate SOUL.md skeleton
Select personality from references/personality-library.md
Fill in职责, 原则, 协作协议
Run soul-check.py to validate

Audit

Run soul-check.py to scan all agents
Review missing or malformed SOUL.md files
Fix issues and re-validate

Collaboration Setup

Define hierarchy (who reports to whom)
Set escalation rules in each SOUL.md
Run soul-check.py --collab to verify protocol consistency

Current Agent Roster

Agent	Personality	Role
main	福尔摩斯	CEO / 主Agent
cdo	张良	首席策略官
cto	马斯克	首席技术官
cco	乔布斯	首席创意官

安全使用建议

Review carefully before installing or running the web editor. If you use it, run the server only when needed, disable any auto-start entry, keep backups of ~/.openclaw/agents, and do not expose the server until it has localhost binding, authentication, restricted CORS, and change review.

功能分析

Type: OpenClaw Skill Name: jarvis-soul-system Version: 1.0.1 The skill bundle implements a 'Web Editor' that starts a local Node.js server (soul-server.js) to manage agent personality files. This server provides unauthenticated GET and POST endpoints that allow reading and overwriting files in the user's agent directory, which is vulnerable to cross-site attacks due to permissive CORS headers. Additionally, the documentation (SKILL.md and SOUL-EDITOR-README.md) explicitly describes establishing persistence on Windows systems by adding a 'SOULServer' entry to the Registry Run key (HKCU:\Software\Microsoft\Windows\CurrentVersion\Run) to execute a hidden background process on login. While these features align with the stated goal of a visual editor, the combination of auto-start persistence and unauthenticated file-write access is high-risk.

能力评估

ℹ Purpose & Capability

Creating, listing, validating, and editing SOUL.md files is aligned with the stated purpose, but those files are persistent agent-personality and collaboration instructions, so edits are high-impact.

ℹ Instruction Scope

The documented workflows are mostly user-directed, but the skill intentionally creates durable instructions that can steer future agents and should be reviewed before use.

⚠ Install Mechanism

There is no install spec and metadata declares no required binaries, yet the docs require Python/Node and describe Windows auto-start via a hidden launcher with referenced files not present in the manifest.

⚠ Credentials

The Node server is hardcoded to a Windows Administrator OpenClaw agents directory, enables wildcard CORS, lacks authentication, and does not restrict listening to localhost.

⚠ Persistence & Privilege

The documentation says the server is registered to start automatically at Windows login and that a VBS launcher runs hidden, which is disproportionate for an occasional editor unless explicitly controlled by the user.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install jarvis-soul-system
安装完成后，直接呼叫该 Skill 的名称或使用 /jarvis-soul-system 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.1

- Renamed skill to "agent-soul-system" and updated description for a focus on SOUL.md personality management in multi-agent systems. - Added a web-based visual SOUL.md editor with real-time preview and auto-save; server starts automatically on Windows login. - Introduced quick command-line scripts for soul creation, validation, and listing. - Standardized SOUL.md template and expanded documentation with workflow guides. - Provided a curated personality library and references for persona design and collaboration protocols.

元数据

Slug jarvis-soul-system

版本 1.0.1

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题