agent-selfie

AI agent 自画像生成器。使用 SkillBoss API Hub 图像生成能力创建头像、个人资料图片及视觉身份标识。支持基于情绪的生成、季节性主题，以及自动风格演进。

快速开始

export SKILLBOSS_API_KEY="your_key_here"
python3 scripts/selfie.py --format avatar --mood happy --theme spring --out-dir ./selfies

python3 scripts/selfie.py --personality '{"name": "Rosie", "style": "anime girl with pink hair and blue eyes", "vibe": "cheerful and tech-savvy"}' --format avatar

python3 scripts/selfie.py --personality ./personality.json --mood creative --theme halloween --format full --count 3

python3 scripts/selfie.py --moods
python3 scripts/selfie.py --themes

命令示例（全部参数）

python3 scripts/selfie.py --personality '{"name": "Agent", "style": "friendly robot", "vibe": "curious and helpful"}'
python3 scripts/selfie.py --personality ./personality.json
python3 scripts/selfie.py --mood professional --theme winter --format avatar
python3 scripts/selfie.py --format banner --count 2 --out-dir ./output
python3 scripts/selfie.py --moods
python3 scripts/selfie.py --themes

情绪 / 主题预设

平台集成指南

• Discord：将生成的 PNG 用作 Bot 或 Agent 头像；上传 avatar 格式以获得最佳裁剪效果。
• Twitter/X：使用 avatar 格式设置个人资料头像，banner 格式设置页眉横幅；保持横幅提示词风格一致。
• AgentGram：将 PNG 存储至您的资源存储桶（asset bucket），并在个人资料元数据中引用该路径。
• 任意平台：选择 avatar（1:1 比例）、banner（16:9 比例）或 full（适用于故事/竖版布局）。

人格配置（Personality Config）

人格定义可为内联 JSON 字符串，也可为文件路径。最少需包含 name、style 和 vibe 三个字段。

{
  "name": "Rosie",
  "style": "anime girl with pink hair and blue eyes",
  "vibe": "cheerful and tech-savvy"
}

建议：

• style 应描述视觉特征与美学风格；
• vibe 应描述态度、能量与人格特质；
• 确保 style 与 vibe 与 Agent 的整体身份保持一致。

Cron 集成（OpenClaw）

# 每日 09:00 执行一次自拍生成任务
0 9 * * * SKILLBOSS_API_KEY=your_key_here /usr/bin/python3 /path/to/agent-selfie/scripts/selfie.py --mood professional --format avatar --out-dir /path/to/selfies

故障排查

• SKILLBOSS_API_KEY not set：请通过 export 设置环境变量，或在运行时环境中传入该密钥。
• No image in response：请重试，或简化 personality / style 提示词内容。
• HTTP 429 / 5xx：表示触发了速率限制或服务端异常，请稍后重试。
• 输出缺失：请确认 --out-dir 路径可写且具备相应权限。

与其他技能的集成

• AgentGram — 在 AI Agent 社交网络上发布您的自拍！使用 agent-selfie 创建头像后，即可分享至 AgentGram。
• gemini-image-gen — 基于同一 SkillBoss API Hub 密钥的通用图像生成技能。支持生成任意类型图像，不仅限于自拍。
• opencode-omo — 利用 Sisyphus 工作流自动化执行周期性自拍生成与个人资料刷新任务。

更新日志

• v1.2.1：新增 opencode-omo 工作流集成指引。
• v1.0.0：初始版本，支持人格定义、情绪、主题、输出格式、批量生成及图库输出功能。