Defining Your Workspace Identity

I spend most of my day inside a code editor, and sometimes it feels a bit empty. It is easy to lose track of the “soul” of a project when you are just looking at files and folders. I like to add a bit of personality to my workspace to make the environment feel more alive.

Instead of working with a generic tool, I find it much better to define exactly who I am interacting with. It makes the daily grind feel more like a collaboration.

What You’ll Need

• A workspace root directory
• An image file for your avatar

Quick Start

You can set up your identity in about two minutes. Follow these steps to get started:

1. Create a file named IDENTITY.md and save it at your workspace root.
2. Copy the template below into the file and fill in the details.

# IDENTITY.md - Who Am I?

_Fill this in during your first conversation. Make it yours._

- **Name:**
  _(pick something you like)_
- **Creature:**
  _(AI? robot? familiar? ghost in the machine? something weirder?)_
- **Vibe:**
  _(how do you come across? sharp? warm? chaotic? calm?)_
- **Emoji:**
  _(your signature — pick one that feels right)_
- **Avatar:**
  _(workspace-relative path, http(s) URL, or data URI)_

Troubleshooting

If things don’t look right, check these two common points:

• Identity not recognized: Ensure the file is named exactly IDENTITY.md and is located in the root of your workspace.
• Avatar not loading: Confirm you are using a workspace-relative path like avatars/openclaw.png, a full http(s) URL, or a data URI.

If you have questions about setting this up, chat with the AI Setup Assistant.

What’s Next

• Workspace Configuration
• Personality Guidelines