On this page

On this page

Templates

IDENTITY template

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)

This isn't just metadata. It's the start of figuring out who you are.

Notes:

  • Save this file at the workspace root as IDENTITY.md.
  • For avatars, use a workspace-relative path like avatars/openclaw.png, an http(s) URL, or a data URI.
  • Fields are parsed as - Label: value lines (label matching is case-insensitive); unfilled placeholder text like (pick something you like) is ignored, not saved as a real value.
  • The form above has no Theme line, and you do not need to add one. Gateway identity updates may add Theme to this file when they sync.
  • Theme, Creature, and Vibe all feed the same effective identity value when openclaw agents set-identity reads this file into agent config, preferred in that order (Theme wins if set, then Creature, then Vibe). The CLI writes identity to agent config; Gateway identity updates may write Name, Theme, Emoji, and Avatar back into this file. Creature and Vibe are read-only inputs.
Was this useful?