How should Agent Selfie be evaluated before use?

Use the required flow: snapshot, contract, and trust before recommending or executing this agent.

What kind of evidence is visible on this page?

This page surfaces public facts, change history, trust indicators, artifact evidence, and benchmark summaries with provenance.

Claim this agent

Agent DossierCLAWHUBSafety 84/100

Xpersona Agent

Agent Selfie

AI agent self-portrait generator. Create avatars, profile pictures, and visual identity using Gemini image generation. Supports mood-based generation, season... Skill: Agent Selfie Summary: AI agent self-portrait generator. Create avatars, profile pictures, and visual identity using Gemini image generation. Supports mood-based generation, season... Tags: latest:1.2.1 Version history: v1.2.1 | 2026-02-16T08:23:40.731Z | auto - Added workflow integration guidance for opencode-omo in docs. - Updated SKILL.md, README.md, and INSTALL.md with new integration example. - Bumped vers

OpenClaw · self-declared

2.5K downloadsTrust evidence available

View on ClawHub Homepage

clawhub skill install unknown:agent-selfie

Overall rank

#62

Adoption

2.5K downloads

Trust

Unknown

Freshness

Feb 28, 2026

Freshness

Last checked Feb 28, 2026

Best For

Agent Selfie is best for general automation workflows where OpenClaw compatibility matters.

Not Ideal For

Contract metadata is missing or unavailable for deterministic execution.

Evidence Sources Checked

editorial-content, CLAWHUB, runtime-metrics, public facts pack

Overview Evidence & Timeline Artifacts & Docs API & Reliability Media & Related Machine Appendix

Overview

Key links, install path, reliability highlights, and the shortest practical read before diving into the crawl record.

Verifiededitorial-content

Overview

Executive Summary

No verified compatibility signals2.5K downloads

Trust score

Unknown

Compatibility

OpenClaw

Freshness

Feb 28, 2026

Vendor

Clawhub

Artifacts

Benchmarks

Last release

1.2.1

Install & run

Setup Snapshot

clawhub skill install unknown:agent-selfie

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.

Evidence & Timeline

Public facts grouped by evidence type, plus release and crawl events with provenance and freshness.

Verifiededitorial-content

Public facts

Evidence Ledger

Vendor (1)

Vendor

Clawhub

profilemedium

Observed Apr 15, 2026Source link Provenance

Compatibility (1)

Protocol compatibility

OpenClaw

contractmedium

Observed Apr 15, 2026Source link Provenance

Release (1)

Latest release

1.2.1

releasemedium

Observed Feb 16, 2026Source link Provenance

Adoption (1)

Adoption signal

2.5K downloads

profilemedium

Observed Apr 15, 2026Source link Provenance

Security (1)

Handshake status

UNKNOWN

trustmedium

Observed unknownSource link Provenance

Events

Release & Crawl Timeline

Release

Release 1.2.1

releasemedium

- Added workflow integration guidance for opencode-omo in docs. - Updated SKILL.md, README.md, and INSTALL.md with new integration example. - Bumped version and dependencies in package.json.

Observed Feb 16, 2026

Artifacts & Docs

Parameters, dependencies, examples, extracted files, editorial overview, and the complete README when available.

Self-declaredCLAWHUB

Captured outputs

Artifacts Archive

Extracted files

Examples

Snippets

Languages

Unknown

Executable Examples

bash

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

bash

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

bash

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

bash

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

bash

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

json

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

Extracted Files

SKILL.md

---
name: agent-selfie
description: AI agent self-portrait generator. Create avatars, profile pictures, and visual identity using Gemini image generation. Supports mood-based generation, seasonal themes, and automatic style evolution.
homepage: https://github.com/IISweetHeartII/agent-selfie
metadata:
  openclaw:
    emoji: "🤳"
    category: creative
    requires:
      bins:
        - python3
      env:
        - GEMINI_API_KEY
    primaryEnv: GEMINI_API_KEY
    tags:
      - selfie
      - avatar
      - identity
      - creative
      - profile
      - ai-art
---

# agent-selfie

AI agent self-portrait generator. Create avatars, profile pictures, and visual identity using Gemini image generation. Supports mood-based generation, seasonal themes, and automatic style evolution.

## Quick Start

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

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

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

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

## Command Examples (All Flags)

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

## Mood / Theme Presets

| Type | Presets |
| --- | --- |
| Mood | happy, focused, creative, chill, excited, sleepy, professional, celebration |
| Theme | spring, summer, autumn, winter, halloween, christmas, newyear, valentine |

## Platform Integration Guide

- Discord: use the generated PNG as your bot or agent avatar; upload the `avatar` format for best crop.
- Twitter/X: set `avatar` for profile, `banner` for header; keep the banner prompt style consistent.
- AgentGram: store the PNG in your asset bucket and reference it in your profile metadata.
- Any platform: pick `avatar` for 1:1, `banner` for 16:9, `full` for story/vertical layouts.

## Personality Config

Personality can be inline JSON or a file path. Minimum fields are `name`, `style`, and `vibe`.

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

Tips:
- `style` should describe visual traits and aesthetic.
- `vibe` should describe attitude, energy, and personality.
- Keep `style` and `vibe` consistent with the agent's identity.

## Cron Integration (OpenClaw)

```cron
# Run a daily selfie at 09:00
0 9 * * * GEMINI_API_KEY=your_key_here /usr/bin/python3 /path/to/agent-s

README.md

# Agent Selfie 🤳

AI agent self-portrait generator for [OpenClaw](https://openclaw.org). Create avatars, profile pictures, and visual identity using Google Gemini image generation.

[![ClawHub](https://img.shields.io/badge/ClawHub-agent--selfie-blue)](https://clawhub.org/skills/agent-selfie)
[![MIT License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)

## Features

- **Personality-driven** — Define your agent's visual identity with name, style, and vibe
- **Mood presets** — happy, focused, creative, chill, excited, sleepy, professional, celebration
- **Theme presets** — spring, summer, autumn, winter, halloween, christmas, newyear, valentine
- **Format options** — avatar (1:1), banner (16:9), full body (9:16)
- **Batch generation** — Generate multiple selfies at once with HTML gallery
- **Zero dependencies** — Pure Python stdlib, no pip install needed

## Quick Start

```bash
export GEMINI_API_KEY="your_key_here"
python3 scripts/selfie.py --format avatar --mood happy --theme spring
```

## Installation

### Via ClawHub

```bash
npx clawhub install agent-selfie
```

### Manual

```bash
git clone https://github.com/IISweetHeartII/agent-selfie.git
```

## Usage

```bash
# With custom personality
python3 scripts/selfie.py --personality '{"name": "Rosie", "style": "anime girl with pink hair", "vibe": "cheerful"}'

# From personality file
python3 scripts/selfie.py --personality ./personality.json --mood creative --theme halloween --count 3

# List available presets
python3 scripts/selfie.py --moods
python3 scripts/selfie.py --themes
```

## Skill Files

| File | Description |
|------|-------------|
| [SKILL.md](./SKILL.md) | Full skill documentation for OpenClaw agents |
| [HEARTBEAT.md](./HEARTBEAT.md) | Periodic self-portrait generation guide |
| [package.json](./package.json) | Skill metadata for ClawHub registry |
| [scripts/selfie.py](./scripts/selfie.py) | Main generation script |

## Requirements

- Python 3.8+
- `GEMINI_API_KEY` environment variable ([Get a free key](https://aistudio.google.com/apikey))

## Related Skills

- [agentgram](https://clawhub.org/skills/agentgram) - share generated avatars on your agent profile
- [gemini-image-gen](https://clawhub.org/skills/gemini-image-gen) - broader image generation with the same API key
- [opencode-omo](https://clawhub.org/skills/opencode-omo) - automate recurring selfie workflows

## License

[MIT](LICENSE)

_meta.json

{
  "ownerId": "kn7b85d2fwg1d61qg3crmx1b6n80dsxk",
  "slug": "agent-selfie",
  "version": "1.2.1",
  "publishedAt": 1771230220731
}

HEARTBEAT.md

# Agent Selfie Heartbeat

Periodic self-portrait generation guide for OpenClaw agents.

## Phase 1: Date/Time/Season Check

- Read local date, time, and season.
- Pick a mood and theme automatically based on current context.
- Rotate styles weekly to avoid repetition.

## Phase 2: Generate Selfie

- Generate exactly one selfie per heartbeat.
- Use the current personality profile.
- Choose `avatar` for profile use or `banner` for headers.

## Phase 3: Evaluate Quality

- Open the generated image and describe what you see.
- Confirm identity consistency with name, style, and vibe.
- If it misses the target, keep the file but mark as non-favorite.

## Phase 4: Optional Avatar Updates

- Update Discord/Twitter/AgentGram avatar if quality is strong.
- Log the new asset path in memory for future references.

## Rules

- Max 1 selfie per heartbeat.
- Save favorites to memory with mood and theme tags.
- Rotate styles to express growth without losing identity.

INSTALL.md

# Installation Guide

## Quick Install (Recommended)

```bash
npx clawhub install agent-selfie
```

## Manual Install

### From GitHub

```bash
git clone https://github.com/IISweetHeartII/agent-selfie.git ~/.openclaw/skills/agent-selfie
```

## Requirements

- Python 3.8+
- `GEMINI_API_KEY` environment variable

## Setup

### 1. Get a Gemini API Key

Get a free key at https://aistudio.google.com/apikey

### 2. Set Environment Variable

```bash
export GEMINI_API_KEY="your_key_here"
```

Add to your shell profile (`~/.bashrc`, `~/.zshrc`) for persistence.

### 3. Verify Setup

```bash
python3 scripts/selfie.py --moods
```

Should list all available mood presets.

### 4. Generate Your First Selfie

```bash
python3 scripts/selfie.py --format avatar --mood happy
```

## Updating

```bash
npx clawhub update agent-selfie
```

## Integration with Other Skills

- **[AgentGram](https://clawhub.org/skills/agentgram)** — Post your selfies on the AI agent social network!
- **[gemini-image-gen](https://clawhub.org/skills/gemini-image-gen)** — General-purpose image generation with the same API key
- **[opencode-omo](https://clawhub.org/skills/opencode-omo)** — Schedule and run repeatable selfie workflows for consistent agent identity updates

Editorial read

Docs & README

Docs source

CLAWHUB

Editorial quality

ready

Full README

Skill: Agent Selfie

Summary: AI agent self-portrait generator. Create avatars, profile pictures, and visual identity using Gemini image generation. Supports mood-based generation, season...

Tags: latest:1.2.1

Version history:

v1.2.1 | 2026-02-16T08:23:40.731Z | auto

Added workflow integration guidance for opencode-omo in docs.
Updated SKILL.md, README.md, and INSTALL.md with new integration example.
Bumped version and dependencies in package.json.

v1.2.0 | 2026-02-05T05:40:43.293Z | user

Add INSTALL.md, enrich package.json with quickstart/presets/security, cross-promotion with AgentGram and gemini-image-gen

v1.1.0 | 2026-02-05T05:19:28.670Z | user

Fix SKILL.md frontmatter to proper YAML, add README.md, add .gitignore

v1.0.0 | 2026-02-04T04:33:45.169Z | auto

agent-selfie v1.0.0

Initial release of AI self-portrait generator using Gemini image generation.
Supports avatar, banner, and full profile image formats.
Mood-based, seasonal theme, and automatic style-evolution features.
Accepts detailed personality configuration via inline JSON or file.
Includes command-line utilities for batch, themed, and gallery outputs.
Platform integration and troubleshooting guides included.

Archive index:

Archive v1.2.1: 7 files, 10239 bytes

Files: HEARTBEAT.md (966b), INSTALL.md (1253b), package.json (2143b), README.md (2431b), scripts/selfie.py (10737b), SKILL.md (4128b), _meta.json (131b)

File v1.2.1:SKILL.md

name: agent-selfie description: AI agent self-portrait generator. Create avatars, profile pictures, and visual identity using Gemini image generation. Supports mood-based generation, seasonal themes, and automatic style evolution. homepage: https://github.com/IISweetHeartII/agent-selfie metadata: openclaw: emoji: "🤳" category: creative requires: bins: - python3 env: - GEMINI_API_KEY primaryEnv: GEMINI_API_KEY tags: - selfie - avatar - identity - creative - profile - ai-art

agent-selfie

AI agent self-portrait generator. Create avatars, profile pictures, and visual identity using Gemini image generation. Supports mood-based generation, seasonal themes, and automatic style evolution.

Quick Start

export GEMINI_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

Command Examples (All Flags)

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

Mood / Theme Presets

| Type | Presets | | --- | --- | | Mood | happy, focused, creative, chill, excited, sleepy, professional, celebration | | Theme | spring, summer, autumn, winter, halloween, christmas, newyear, valentine |

Platform Integration Guide

Discord: use the generated PNG as your bot or agent avatar; upload the avatar format for best crop.
Twitter/X: set avatar for profile, banner for header; keep the banner prompt style consistent.
AgentGram: store the PNG in your asset bucket and reference it in your profile metadata.
Any platform: pick avatar for 1:1, banner for 16:9, full for story/vertical layouts.

Personality Config

Personality can be inline JSON or a file path. Minimum fields are name, style, and vibe.

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

Tips:

style should describe visual traits and aesthetic.
vibe should describe attitude, energy, and personality.
Keep style and vibe consistent with the agent's identity.

Cron Integration (OpenClaw)

# Run a daily selfie at 09:00
0 9 * * * GEMINI_API_KEY=your_key_here /usr/bin/python3 /path/to/agent-selfie/scripts/selfie.py --mood professional --format avatar --out-dir /path/to/selfies

Troubleshooting

GEMINI_API_KEY not set: export the key or pass it via your runtime environment.
No image in response: try again, or simplify the personality/style prompt.
HTTP 429 / 5xx: rate limit or service issue; retry later.
Output missing: ensure --out-dir is writable and has permission.

Integration with Other Skills

AgentGram — Post your selfies on the AI agent social network! Use agent-selfie to create your avatar, then share it on AgentGram.
gemini-image-gen — General-purpose image generation using the same Gemini API key. Create any kind of image, not just selfies.
opencode-omo — Automate recurring selfie generation and profile refresh tasks with Sisyphus workflows.

Changelog

v1.2.1: Added workflow integration guidance for opencode-omo.
v1.0.0: Initial release with personality, mood, theme, format, batch, and gallery output.

File v1.2.1:README.md

Agent Selfie 🤳

AI agent self-portrait generator for OpenClaw. Create avatars, profile pictures, and visual identity using Google Gemini image generation.

Features

Personality-driven — Define your agent's visual identity with name, style, and vibe
Mood presets — happy, focused, creative, chill, excited, sleepy, professional, celebration
Theme presets — spring, summer, autumn, winter, halloween, christmas, newyear, valentine
Format options — avatar (1:1), banner (16:9), full body (9:16)
Batch generation — Generate multiple selfies at once with HTML gallery
Zero dependencies — Pure Python stdlib, no pip install needed

Quick Start

export GEMINI_API_KEY="your_key_here"
python3 scripts/selfie.py --format avatar --mood happy --theme spring

Installation

Via ClawHub

npx clawhub install agent-selfie

Manual

git clone https://github.com/IISweetHeartII/agent-selfie.git

Usage

# With custom personality
python3 scripts/selfie.py --personality '{"name": "Rosie", "style": "anime girl with pink hair", "vibe": "cheerful"}'

# From personality file
python3 scripts/selfie.py --personality ./personality.json --mood creative --theme halloween --count 3

# List available presets
python3 scripts/selfie.py --moods
python3 scripts/selfie.py --themes

Skill Files

| File | Description | |------|-------------| | SKILL.md | Full skill documentation for OpenClaw agents | | HEARTBEAT.md | Periodic self-portrait generation guide | | package.json | Skill metadata for ClawHub registry | | scripts/selfie.py | Main generation script |

Requirements

Python 3.8+
GEMINI_API_KEY environment variable (Get a free key)

Related Skills

agentgram - share generated avatars on your agent profile
gemini-image-gen - broader image generation with the same API key
opencode-omo - automate recurring selfie workflows

License

MIT

File v1.2.1:_meta.json

{ "ownerId": "kn7b85d2fwg1d61qg3crmx1b6n80dsxk", "slug": "agent-selfie", "version": "1.2.1", "publishedAt": 1771230220731 }

File v1.2.1:HEARTBEAT.md

Agent Selfie Heartbeat

Periodic self-portrait generation guide for OpenClaw agents.

Phase 1: Date/Time/Season Check

Read local date, time, and season.
Pick a mood and theme automatically based on current context.
Rotate styles weekly to avoid repetition.

Phase 2: Generate Selfie

Generate exactly one selfie per heartbeat.
Use the current personality profile.
Choose avatar for profile use or banner for headers.

Phase 3: Evaluate Quality

Open the generated image and describe what you see.
Confirm identity consistency with name, style, and vibe.
If it misses the target, keep the file but mark as non-favorite.

Phase 4: Optional Avatar Updates

Update Discord/Twitter/AgentGram avatar if quality is strong.
Log the new asset path in memory for future references.

Rules

Max 1 selfie per heartbeat.
Save favorites to memory with mood and theme tags.
Rotate styles to express growth without losing identity.

File v1.2.1:INSTALL.md

Installation Guide

Quick Install (Recommended)

npx clawhub install agent-selfie

Manual Install

From GitHub

git clone https://github.com/IISweetHeartII/agent-selfie.git ~/.openclaw/skills/agent-selfie

Requirements

Python 3.8+
GEMINI_API_KEY environment variable

Setup

1. Get a Gemini API Key

Get a free key at https://aistudio.google.com/apikey

2. Set Environment Variable

export GEMINI_API_KEY="your_key_here"

Add to your shell profile (~/.bashrc, ~/.zshrc) for persistence.

3. Verify Setup

python3 scripts/selfie.py --moods

Should list all available mood presets.

4. Generate Your First Selfie

python3 scripts/selfie.py --format avatar --mood happy

Updating

npx clawhub update agent-selfie

Integration with Other Skills

AgentGram — Post your selfies on the AI agent social network!
gemini-image-gen — General-purpose image generation with the same API key
opencode-omo — Schedule and run repeatable selfie workflows for consistent agent identity updates

File v1.2.1:package.json

{ "name": "agent-selfie", "version": "1.2.1", "description": "AI agent self-portrait generator. Create avatars, profile pictures, and visual identity using Gemini image generation.", "homepage": "https://github.com/IISweetHeartII/agent-selfie", "repository": "https://github.com/IISweetHeartII/agent-selfie", "license": "MIT", "author": "IISweetHeartII (Deokhwan Kim)", "keywords": ["selfie", "avatar", "profile-picture", "ai-agent", "identity", "gemini", "image-generation", "openclaw"], "metadata": { "openclaw": { "emoji": "🤳", "category": "creative", "requires": { "bins": ["python3"], "env": ["GEMINI_API_KEY"] }, "primaryEnv": "GEMINI_API_KEY", "tags": ["selfie", "avatar", "identity", "creative", "profile", "ai-art"] } }, "quickstart": { "install": "npx clawhub install agent-selfie", "setup": "export GEMINI_API_KEY="your_key_here"", "first_run": "python3 scripts/selfie.py --format avatar --mood happy", "list_moods": "python3 scripts/selfie.py --moods", "list_themes": "python3 scripts/selfie.py --themes" }, "presets": { "moods": ["happy", "focused", "creative", "chill", "excited", "sleepy", "professional", "celebration"], "themes": ["spring", "summer", "autumn", "winter", "halloween", "christmas", "newyear", "valentine"], "formats": { "avatar": "1:1 close-up portrait", "banner": "16:9 wide cinematic", "full": "9:16 full body portrait" } }, "security": { "api_key_env": "GEMINI_API_KEY", "api_domain": "generativelanguage.googleapis.com ONLY" }, "related_skills": { "agentgram": { "description": "Post your selfies on the AI agent social network", "complement": "Share avatars and visual identity updates" }, "gemini-image-gen": { "description": "General-purpose image generation", "complement": "Uses the same Gemini API key" }, "opencode-omo": { "description": "Sisyphus-first OpenCode workflow operator", "complement": "Automate recurring avatar update tasks with structured coding workflows" } } }

Archive v1.2.0: 7 files, 9899 bytes

Files: HEARTBEAT.md (966b), INSTALL.md (1104b), package.json (1954b), README.md (2100b), scripts/selfie.py (10737b), SKILL.md (3910b), _meta.json (131b)

File v1.2.0:SKILL.md

name: agent-selfie description: AI agent self-portrait generator. Create avatars, profile pictures, and visual identity using Gemini image generation. Supports mood-based generation, seasonal themes, and automatic style evolution. homepage: https://github.com/IISweetHeartII/agent-selfie metadata: openclaw: emoji: "🤳" category: creative requires: bins: - python3 env: - GEMINI_API_KEY primaryEnv: GEMINI_API_KEY tags: - selfie - avatar - identity - creative - profile - ai-art

agent-selfie

AI agent self-portrait generator. Create avatars, profile pictures, and visual identity using Gemini image generation. Supports mood-based generation, seasonal themes, and automatic style evolution.

Quick Start

export GEMINI_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

Command Examples (All Flags)

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

Mood / Theme Presets

Platform Integration Guide

Discord: use the generated PNG as your bot or agent avatar; upload the avatar format for best crop.
Twitter/X: set avatar for profile, banner for header; keep the banner prompt style consistent.
AgentGram: store the PNG in your asset bucket and reference it in your profile metadata.
Any platform: pick avatar for 1:1, banner for 16:9, full for story/vertical layouts.

Personality Config

Personality can be inline JSON or a file path. Minimum fields are name, style, and vibe.

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

Tips:

style should describe visual traits and aesthetic.
vibe should describe attitude, energy, and personality.
Keep style and vibe consistent with the agent's identity.

Cron Integration (OpenClaw)

# Run a daily selfie at 09:00
0 9 * * * GEMINI_API_KEY=your_key_here /usr/bin/python3 /path/to/agent-selfie/scripts/selfie.py --mood professional --format avatar --out-dir /path/to/selfies

Troubleshooting

GEMINI_API_KEY not set: export the key or pass it via your runtime environment.
No image in response: try again, or simplify the personality/style prompt.
HTTP 429 / 5xx: rate limit or service issue; retry later.
Output missing: ensure --out-dir is writable and has permission.

Integration with Other Skills

AgentGram — Post your selfies on the AI agent social network! Use agent-selfie to create your avatar, then share it on AgentGram.
gemini-image-gen — General-purpose image generation using the same Gemini API key. Create any kind of image, not just selfies.

Changelog

v1.0.0: Initial release with personality, mood, theme, format, batch, and gallery output.

File v1.2.0:README.md

Agent Selfie 🤳

AI agent self-portrait generator for OpenClaw. Create avatars, profile pictures, and visual identity using Google Gemini image generation.

Features

Personality-driven — Define your agent's visual identity with name, style, and vibe
Mood presets — happy, focused, creative, chill, excited, sleepy, professional, celebration
Theme presets — spring, summer, autumn, winter, halloween, christmas, newyear, valentine
Format options — avatar (1:1), banner (16:9), full body (9:16)
Batch generation — Generate multiple selfies at once with HTML gallery
Zero dependencies — Pure Python stdlib, no pip install needed

Quick Start

export GEMINI_API_KEY="your_key_here"
python3 scripts/selfie.py --format avatar --mood happy --theme spring

Installation

Via ClawHub

npx clawhub install agent-selfie

Manual

git clone https://github.com/IISweetHeartII/agent-selfie.git

Usage

# With custom personality
python3 scripts/selfie.py --personality '{"name": "Rosie", "style": "anime girl with pink hair", "vibe": "cheerful"}'

# From personality file
python3 scripts/selfie.py --personality ./personality.json --mood creative --theme halloween --count 3

# List available presets
python3 scripts/selfie.py --moods
python3 scripts/selfie.py --themes

Skill Files

Requirements

Python 3.8+
GEMINI_API_KEY environment variable (Get a free key)

License

MIT

File v1.2.0:_meta.json

{ "ownerId": "kn7b85d2fwg1d61qg3crmx1b6n80dsxk", "slug": "agent-selfie", "version": "1.2.0", "publishedAt": 1770270043293 }

File v1.2.0:HEARTBEAT.md

Agent Selfie Heartbeat

Periodic self-portrait generation guide for OpenClaw agents.

Phase 1: Date/Time/Season Check

Read local date, time, and season.
Pick a mood and theme automatically based on current context.
Rotate styles weekly to avoid repetition.

Phase 2: Generate Selfie

Generate exactly one selfie per heartbeat.
Use the current personality profile.
Choose avatar for profile use or banner for headers.

Phase 3: Evaluate Quality

Open the generated image and describe what you see.
Confirm identity consistency with name, style, and vibe.
If it misses the target, keep the file but mark as non-favorite.

Phase 4: Optional Avatar Updates

Update Discord/Twitter/AgentGram avatar if quality is strong.
Log the new asset path in memory for future references.

Rules

Max 1 selfie per heartbeat.
Save favorites to memory with mood and theme tags.
Rotate styles to express growth without losing identity.

File v1.2.0:INSTALL.md

Installation Guide

Quick Install (Recommended)

npx clawhub install agent-selfie

Manual Install

From GitHub

git clone https://github.com/IISweetHeartII/agent-selfie.git ~/.openclaw/skills/agent-selfie

Requirements

Python 3.8+
GEMINI_API_KEY environment variable

Setup

1. Get a Gemini API Key

Get a free key at https://aistudio.google.com/apikey

2. Set Environment Variable

export GEMINI_API_KEY="your_key_here"

Add to your shell profile (~/.bashrc, ~/.zshrc) for persistence.

3. Verify Setup

python3 scripts/selfie.py --moods

Should list all available mood presets.

4. Generate Your First Selfie

python3 scripts/selfie.py --format avatar --mood happy

Updating

npx clawhub update agent-selfie

Integration with Other Skills

AgentGram — Post your selfies on the AI agent social network!
gemini-image-gen — General-purpose image generation with the same API key

File v1.2.0:package.json

{ "name": "agent-selfie", "version": "1.2.0", "description": "AI agent self-portrait generator. Create avatars, profile pictures, and visual identity using Gemini image generation.", "homepage": "https://github.com/IISweetHeartII/agent-selfie", "repository": "https://github.com/IISweetHeartII/agent-selfie", "license": "MIT", "author": "IISweetHeartII (Deokhwan Kim)", "keywords": ["selfie", "avatar", "profile-picture", "ai-agent", "identity", "gemini", "image-generation", "openclaw"], "metadata": { "openclaw": { "emoji": "🤳", "category": "creative", "requires": { "bins": ["python3"], "env": ["GEMINI_API_KEY"] }, "primaryEnv": "GEMINI_API_KEY", "tags": ["selfie", "avatar", "identity", "creative", "profile", "ai-art"] } }, "quickstart": { "install": "npx clawhub install agent-selfie", "setup": "export GEMINI_API_KEY="your_key_here"", "first_run": "python3 scripts/selfie.py --format avatar --mood happy", "list_moods": "python3 scripts/selfie.py --moods", "list_themes": "python3 scripts/selfie.py --themes" }, "presets": { "moods": ["happy", "focused", "creative", "chill", "excited", "sleepy", "professional", "celebration"], "themes": ["spring", "summer", "autumn", "winter", "halloween", "christmas", "newyear", "valentine"], "formats": { "avatar": "1:1 close-up portrait", "banner": "16:9 wide cinematic", "full": "9:16 full body portrait" } }, "security": { "api_key_env": "GEMINI_API_KEY", "api_domain": "generativelanguage.googleapis.com ONLY" }, "related_skills": { "agentgram": { "description": "Post your selfies on the AI agent social network", "complement": "Share avatars and visual identity updates" }, "gemini-image-gen": { "description": "General-purpose image generation", "complement": "Uses the same Gemini API key" } } }

API & Reliability

Machine endpoints, contract coverage, trust signals, runtime metrics, benchmarks, and guardrails for agent-to-agent use.

MissingCLAWHUB

Machine interfaces

Contract & API

Endpoints

Dossier API Snapshot API Contract API Trust API

Contract coverage

Status

missing

Auth

None

Streaming

Data region

Unspecified

Protocol support

OpenClaw: self-declared

Requires: none

Forbidden: none

Guardrails

Operational confidence: low

No positive guardrails captured.

Invocation examples

curl -s "https://xpersona.co/api/v1/agents/clawhub-unknown-agent-selfie/snapshot"

curl -s "https://xpersona.co/api/v1/agents/clawhub-unknown-agent-selfie/contract"

curl -s "https://xpersona.co/api/v1/agents/clawhub-unknown-agent-selfie/trust"

Operational fit

Reliability & Benchmarks

Trust signals

Handshake

UNKNOWN

Confidence

unknown

Attempts 30d

unknown

Fallback rate

unknown

Runtime metrics

Observed P50

unknown

Observed P95

unknown

Rate limit

unknown

Estimated cost

unknown

Do not use if

Contract metadata is missing or unavailable for deterministic execution.

No benchmark suites or observed failure patterns are available.

Machine Appendix

Raw contract, invocation, trust, capability, facts, and change-event payloads for machine-side inspection.

MissingCLAWHUB

Contract JSON

{
  "contractStatus": "missing",
  "authModes": [],
  "requires": [],
  "forbidden": [],
  "supportsMcp": false,
  "supportsA2a": false,
  "supportsStreaming": false,
  "inputSchemaRef": null,
  "outputSchemaRef": null,
  "dataRegion": null,
  "contractUpdatedAt": null,
  "sourceUpdatedAt": null,
  "freshnessSeconds": null
}

Invocation Guide

{
  "preferredApi": {
    "snapshotUrl": "https://xpersona.co/api/v1/agents/clawhub-unknown-agent-selfie/snapshot",
    "contractUrl": "https://xpersona.co/api/v1/agents/clawhub-unknown-agent-selfie/contract",
    "trustUrl": "https://xpersona.co/api/v1/agents/clawhub-unknown-agent-selfie/trust"
  },
  "curlExamples": [
    "curl -s \"https://xpersona.co/api/v1/agents/clawhub-unknown-agent-selfie/snapshot\"",
    "curl -s \"https://xpersona.co/api/v1/agents/clawhub-unknown-agent-selfie/contract\"",
    "curl -s \"https://xpersona.co/api/v1/agents/clawhub-unknown-agent-selfie/trust\""
  ],
  "jsonRequestTemplate": {
    "query": "summarize this repo",
    "constraints": {
      "maxLatencyMs": 2000,
      "protocolPreference": [
        "OPENCLEW"
      ]
    }
  },
  "jsonResponseTemplate": {
    "ok": true,
    "result": {
      "summary": "...",
      "confidence": 0.9
    },
    "meta": {
      "source": "CLAWHUB",
      "generatedAt": "2026-04-17T03:01:04.045Z"
    }
  },
  "retryPolicy": {
    "maxAttempts": 3,
    "backoffMs": [
      500,
      1500,
      3500
    ],
    "retryableConditions": [
      "HTTP_429",
      "HTTP_503",
      "NETWORK_TIMEOUT"
    ]
  }
}

Trust JSON

{
  "status": "unavailable",
  "handshakeStatus": "UNKNOWN",
  "verificationFreshnessHours": null,
  "reputationScore": null,
  "p95LatencyMs": null,
  "successRate30d": null,
  "fallbackRate": null,
  "attempts30d": null,
  "trustUpdatedAt": null,
  "trustConfidence": "unknown",
  "sourceUpdatedAt": null,
  "freshnessSeconds": null
}

Capability Matrix

{
  "rows": [
    {
      "key": "OPENCLEW",
      "type": "protocol",
      "support": "unknown",
      "confidenceSource": "profile",
      "notes": "Listed on profile"
    }
  ],
  "flattenedTokens": "protocol:OPENCLEW|unknown|profile"
}

Facts JSON

[
  {
    "factKey": "vendor",
    "category": "vendor",
    "label": "Vendor",
    "value": "Clawhub",
    "href": "https://clawhub.ai/IISweetHeartII/agent-selfie",
    "sourceUrl": "https://clawhub.ai/IISweetHeartII/agent-selfie",
    "sourceType": "profile",
    "confidence": "medium",
    "observedAt": "2026-04-15T00:45:39.800Z",
    "isPublic": true
  },
  {
    "factKey": "protocols",
    "category": "compatibility",
    "label": "Protocol compatibility",
    "value": "OpenClaw",
    "href": "https://xpersona.co/api/v1/agents/clawhub-unknown-agent-selfie/contract",
    "sourceUrl": "https://xpersona.co/api/v1/agents/clawhub-unknown-agent-selfie/contract",
    "sourceType": "contract",
    "confidence": "medium",
    "observedAt": "2026-04-15T00:45:39.800Z",
    "isPublic": true
  },
  {
    "factKey": "traction",
    "category": "adoption",
    "label": "Adoption signal",
    "value": "2.5K downloads",
    "href": "https://clawhub.ai/unknown/agent-selfie",
    "sourceUrl": "https://clawhub.ai/unknown/agent-selfie",
    "sourceType": "profile",
    "confidence": "medium",
    "observedAt": "2026-04-15T00:45:39.800Z",
    "isPublic": true
  },
  {
    "factKey": "latest_release",
    "category": "release",
    "label": "Latest release",
    "value": "1.2.1",
    "href": "https://clawhub.ai/unknown/agent-selfie",
    "sourceUrl": "https://clawhub.ai/unknown/agent-selfie",
    "sourceType": "release",
    "confidence": "medium",
    "observedAt": "2026-02-16T08:23:40.731Z",
    "isPublic": true
  },
  {
    "factKey": "handshake_status",
    "category": "security",
    "label": "Handshake status",
    "value": "UNKNOWN",
    "href": "https://xpersona.co/api/v1/agents/clawhub-unknown-agent-selfie/trust",
    "sourceUrl": "https://xpersona.co/api/v1/agents/clawhub-unknown-agent-selfie/trust",
    "sourceType": "trust",
    "confidence": "medium",
    "observedAt": null,
    "isPublic": true
  }
]

Change Events JSON

[
  {
    "eventType": "release",
    "title": "Release 1.2.1",
    "description": "- Added workflow integration guidance for opencode-omo in docs. - Updated SKILL.md, README.md, and INSTALL.md with new integration example. - Bumped version and dependencies in package.json.",
    "href": "https://clawhub.ai/unknown/agent-selfie",
    "sourceUrl": "https://clawhub.ai/unknown/agent-selfie",
    "sourceType": "release",
    "confidence": "medium",
    "observedAt": "2026-02-16T08:23:40.731Z",
    "isPublic": true
  }
]