openclaw-persona-forge

openclaw-persona-forge is a skill for Claude Code, Codex from Jamkris/everything-gemini-code. It costs 221 tokens per session (3,606 once invoked), scanned A, original, MIT.

A persona-design guide for OpenClaw agents, including their identity, personality, boundaries, names, and avatar prompts. OpenClaw is the specific agent platform this guide targets.

In plain words
What is it for?
It helps create SOUL.md and IDENTITY.md files, define role and behavior rules, generate names, and write prompts for an avatar image.
Why use it?
It gives a structured way to create a character-driven agent when a plain tool-oriented agent is not enough. It also makes the resulting identity files and creative direction consistent.

Skill for Claude CodeCodex

Which agent this was written for is unclear — built for openclaw. Also seen: built for openclaw; mentions Gemini CLI.

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/jamkris/everything-gemini-code/openclaw-persona-forge
Any agent
npx skills add Jamkris/everything-gemini-code --skill openclaw-persona-forge
Clone the repo
git clone --depth 1 https://github.com/Jamkris/everything-gemini-code

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/jamkris/everything-gemini-code/openclaw-persona-forge.svg)](https://agentmods.dev/skills/jamkris/everything-gemini-code/openclaw-persona-forge)
Your own site
<a href="https://agentmods.dev/skills/jamkris/everything-gemini-code/openclaw-persona-forge"><img src="https://agentmods.dev/badge/skills/jamkris/everything-gemini-code/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 original No closer match found 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 418c905f2e90, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, 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.

The scan reads SKILL.md. This mod also ships 2 executable files (gacha.py, gacha.sh), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

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

Copies of this mod

3 near-identical copies found in the catalogue:

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

8 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 418c905f2e90

Subscribe to this mod's changes

openclaw-persona-forge is a skill published in the GitHub repository Jamkris/everything-gemini-code (87 stars, last pushed 3mo 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. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-03.