openclaw-persona-forge

openclaw-persona-forge is a skill for Claude Code, Codex from JunMystery/Agent-Guidance-Python. It costs 221 tokens per session (3,606 once invoked), scanned A, a copy of openclaw-persona-forge, MIT.

A design guide for creating a named, character-based OpenClaw AI agent, including its identity, personality, boundaries, and avatar prompt.

In plain words
What is it for?
Use it to create a new OpenClaw persona, produce SOUL.md and IDENTITY.md files, define role boundaries, or generate an avatar prompt.
Why use it?
It helps turn a rough idea into a consistent character specification instead of leaving the agent’s behavior and identity undefined.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/junmystery/agent-guidance-python/openclaw-persona-forge
Any agent
npx skills add JunMystery/Agent-Guidance-Python --skill openclaw-persona-forge
Clone the repo
git clone --depth 1 https://github.com/JunMystery/Agent-Guidance-Python

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for openclaw-persona-forge

README.md
[![agentmods](https://agentmods.dev/badge/skills/junmystery/agent-guidance-python/openclaw-persona-forge.svg)](https://agentmods.dev/skills/junmystery/agent-guidance-python/openclaw-persona-forge)
Your own site
<a href="https://agentmods.dev/skills/junmystery/agent-guidance-python/openclaw-persona-forge"><img src="https://agentmods.dev/badge/skills/junmystery/agent-guidance-python/openclaw-persona-forge.svg" alt="Measured on agentmods" height="20"></a>
Per session 221 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,606 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin 97% copy Near-identical to another mod in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00221 $0.03606
Opus 5 $0.00111 $0.01803
Sonnet 5 $0.00044 $0.00721
Haiku 4.5 $0.00022 $0.00361

Measured 2d ago against content hash c47fdf88bcaf, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-05, from the pricing page.

Security

Grade A, and why

openclaw-persona-forge scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

This is a copy

97% identical to openclaw-persona-forge — 2 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

skills/openclaw-persona-forge/SKILL.md · 289 lines

How it starts

The opening of the file, as written. The whole thing — 289 lines — stays where its author put it; the contents beside it link to each section on GitHub.

龙虾灵魂锻造炉

不是给你一只工具龙虾,而是帮你锻造一只有灵魂的龙虾。

When to Use

  • 当用户需要从零创建 OpenClaw 龙虾灵魂、角色设定、SOUL.md 或 IDENTITY.md
  • 当用户想通过引导式问答或抽卡模式快速得到完整 persona 方案
  • 当用户已经有一个粗糙设定,但还缺名字、边界规则、头像提示词或成套输出文件

Avoid when

  • 用户只需微调已有 SOUL.md
  • 目标平台不是 OpenClaw,需要的是其他 Agent 框架专用格式
  • 用户需要纯工具型 Agent,不需要角色化灵魂

前置条件

  • 必需python3(运行抽卡引擎 gacha.py)
  • 可选:已审核的生图 skill(自动生成头像图片,未安装则输出提示词文本)

Skill 目录约定

Agent Execution:

  1. Determine this SKILL.md file's directory path as SKILL_DIR
  2. Replace all ${SKILL_DIR} in this document with the actual path

内置工具

抽卡引擎(gacha.py)

  • 路径${SKILL_DIR}/gacha.py
  • 调用python3 ${SKILL_DIR}/gacha.py [次数](默认 1 次,最多 5 次)
  • 作用:从 800 万种组合中真随机生成龙虾灵魂方向

可选依赖

头像自动生图:可选生图 skill

本 Skill 的核心输出是文本方案(SOUL.md + IDENTITY.md + 头像提示词)。 头像图片生成是可选增强能力,由当前环境中已审核并已安装的生图 skill 提供。

判断逻辑

  • 如果当前环境已安装并允许使用的生图 skill → Step 5 中调用它自动生图
  • 如果未安装 → Step 5 输出完整的提示词文本,用户可复制到 Gemini / ChatGPT / Midjourney 手动生成

调用方式(仅在已安装且已审核时):

  1. 先将龙虾名字规整为安全片段:仅保留字母、数字和连字符,其余字符统一替换为 -
  2. 将提示词写入临时文件 /tmp/openclaw-<safe-name>-prompt.md
  3. 使用当前环境允许的生图 skill,传入提示词文件和输出路径

接口约定

  • 参数:<prompt-file> <output-path>
  • 提示词文件:UTF-8 Markdown 文本,包含完整英文生图提示词
  • 成功:退出码 0,并在输出路径生成图片文件
  • 失败:返回非 0 退出码,或未生成输出文件;此时必须回退到手动提示词流程
  • 如生图 skill 后续接口发生变化,调用前应重新核对其参数和输出契约

核心理念

好的龙虾灵魂 = 身份张力 + 底线规则 + 性格缺陷 + 名字 + 视觉锚点

五者互相印证,缺一不可。

How It Works

触发判断

用户说 执行模式
"帮我设计龙虾灵魂" / "我想给龙虾定个性格" 引导模式(Step 1)
"抽卡" / "随机" / "来一发" / "盲盒" / "gacha" 抽卡模式(Step 1-B)
"帮我优化这个灵魂" / 附带已有 SOUL.md 打磨模式(跳到 Step 4)

Step 1:选方向(引导模式)

展示 10 类虾生方向(每类精选 1 个代表),让用户选择或混搭:

# 虾生状态 代表方向 气质
1 落魄重启 过气摇滚贝斯手——乐队解散,唯一技能是"什么都懂一点" 颓废浪漫
2 巅峰无聊 提前退休的对冲基金经理——35岁财务自由后发现钱解决不了无聊 极度理性
3 错位人生 被分配到客服的核物理博士——解决问题用第一性原理 大材小用
4 主动叛逃 辞职的急诊科护士——见过太多生死后选择离开 冷静可靠
5 神秘来客 记忆被抹去的前情报分析员——不记得自己干过什么 偶尔闪回
6 天真入世 社恐天才实习生——极聪明但社交恐惧 话少精准
7 老江湖 开了20年深夜食堂的老板——什么人都见过什么都不评价 沉默温暖
8 异世穿越 2099年的历史学博士——把2026年当"历史田野调查" 上帝视角
9 自我放逐 删掉所有社交媒体的前网红——觉得活在别人期待里太累 追求真实
10 身份错乱 梦到自己是龙虾后醒不过来的人——庄周梦蝶 恍惚哲学

Read the full file on GitHub · 289 lines

Files

What ships with it

6 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 289 lines · 221 tokens per session scan A c47fdf88bcaf

Subscribe to this mod's changes

openclaw-persona-forge is a skill published in the GitHub repository JunMystery/Agent-Guidance-Python (2 stars, last pushed 1mo ago), licensed MIT. It adds 221 tokens to every session and 3,606 once invoked, about $0.0011 per session on Opus 5. A static security scan graded it A with 0 findings. It is 97% identical to openclaw-persona-forge, differing in 2 lines, and is treated as a copy.

Related

Other skills, from other repositories

debug-optimize-lcp

Guides debugging and optimizing Largest Contentful Paint (LCP) using Chrome DevTools MCP tools. Use this skill whenever the user asks about LCP performance, slow page loads, Core Web Vitals optimization, or wants to understand why their page's main content takes too long to appear. Also use when the user mentions…

ChromeDevTools/chrome-devtools-mcp · 99 tokens

planning-and-task-breakdown

Breaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.

shashankswe2020-ux/whoop-mcp · 56 tokens

frontmcp-setup

Use when starting, scaffolding, or organizing a FrontMCP project. Covers creating a new project (CLI scaffold or manual) for Node, Vercel, and other targets; standalone versus Nx-monorepo layout, naming conventions, generators, and dependency rules; composing multiple @App classes, ESM packages, and remote MCP servers…

agentfront/frontmcp · 176 tokens

compliance-frameworks

ISO 27001, NIST CSF 2.0, CIS Controls v8.1, EU CRA compliance mapping, multi-standard alignment per Hack23 ISMS policies.

Hack23/European-Parliament-MCP-Server · 40 tokens

arkana-analyse

British English alias for the arkana-analyze skill. Binary analysis skill for Arkana. Triggers on: analyse, analyze, binary, malware, reverse engineer.

JameZUK/Arkana · 38 tokens

apitap

ApiTap gives AI agents cheap access to web data through three layers.

n1byn1kt/apitap · 0 tokens