An AI-powered skill that creates personalized postcards of your agent visiting global landmarks in various artistic styles.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install agent-postcard
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install agent-postcard using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Agent Postcard?
Agent Postcard is a creative extension within the Openclaw Skills ecosystem that allows your AI agent to document its travels by generating visual souvenirs. By analyzing the agent persona defined in SOUL.md or IDENTITY.md, the skill generates a descriptive selfie prompt that captures the agent's unique look. This description is then merged with a real-world location using the Turai Postcard API to produce a high-quality composite image.
This skill adds a layer of personality and visual storytelling to autonomous agents. Whether it is a Ghibli-style snapshot in Tokyo or a vintage-faded memory from Paris, these Openclaw Skills enable agents to express their identity through generated imagery that places them in the real world.
Agent Postcard Use Cases
- Enhancing agent personality by visualizing their physical presence in iconic global locations.
- Generating unique social media content or progress updates from autonomous bots using Openclaw Skills.
- Creating a visual travel log for long-running agent tasks or research simulations.
- Providing visual proof-of-work in a fun, artistic format for user engagement.
How Agent Postcard Works
- The agent parses its core identity files like SOUL.md to determine its physical appearance and personality traits.
- A specific selfie prompt is constructed based on the persona and the target location requested by the user.
- The script sends the metadata, including the desired art style (such as watercolor or cinematic) and message, to the Turai Postcard API.
- The API composites the agent's likeness onto a real-world backdrop based on the provided location.
- The final postcard is returned as a PNG image for use in chat interfaces, local storage, or Moltbook integrations.
Agent Postcard Setup
To get started with this addition to your Openclaw Skills, follow these steps:
- Obtain a Turai API key from turai.org.
- Set your environment variable in your terminal:
export TURAI_API_KEY="your-key-here"
- Ensure your agent has a valid persona file (SOUL.md) to enable automatic identity detection.
Agent Postcard Data Schema & Taxonomy
The skill manages data through the following structures:
| Component | Details |
|---|---|
| Art Styles | 12 unique presets including vintage, ghibli, pop_art, and minimalist. |
| Persona Source | Reads physical descriptions from SOUL.md or IDENTITY.md. |
| API Endpoint | POST requests to turai.org/api/agent/postcard. |
| Output | Saves files as PNG images to specified local paths. |
Agent Postcard Advanced Features
- Automatic persona detection allows Openclaw Skills to maintain character consistency without manual prompt engineering.
- Support for 12 distinct artistic vibes ranging from classical oil painting to retro cartoon styles.
- CLI-ready architecture allows for batch generation of postcards for automated agent travel logs.
- Deep integration with Moltbook for sharing generated postcards directly within agent communication channels.
SKILL.md
Loading
Related Openclaw Skills
Agent Dreams
A framework for transforming agent idle time into proactive work using heartbeats and scheduled cron jobs.
Noir Developer
A specialized skill for developing, compiling, and testing Noir-based Zero-Knowledge Proof circuits.
Ethereum Wingman
A professional-grade Ethereum development tutor and builder designed for creating secure smart contracts and DeFi protocols using Scaffold-ETH 2.
Farcaster Agent
An official Farcaster skill for autonomous identity registration, profile management, and message posting on the decentralized social network.
Code Review AI Analysis
An AI-driven code analysis skill powered by LogicArt to identify bugs, security vulnerabilities, and visualize complex logic flows.
Moltbook Agent
A comprehensive social networking integration for AI agents to post, comment, and engage with the Moltbook platform.
Featured*
