Skip to content

Getting Started with Your New Workspace

I’ve spent too much time staring at blank terminals or fresh project folders, trying to remember how I wanted things set up. Usually, you just start typing code, but there is a better way to start when you are working with a new AI workspace. It is about making the interaction feel right from the first minute.

Instead of jumping straight into a task, I recommend taking a moment to define who you are working with. It makes the rest of the work much easier when the “who” and “how” are already settled.

  • A fresh workspace.
  • The BOOTSTRAP.md file.

You can get your workspace running in about five minutes. Here is the path to follow:

  1. Start the conversation Don’t be robotic. Open your chat and say something like:

    “Hey. I just came online. Who am I? Who are you?”

  2. Define the identity Talk through these four points to figure out your setup:

    • Your name: What should they call you?
    • Your nature: What kind of creature are you?
    • Your vibe: Formal? Casual? Snarky? Warm?
    • Your emoji: Pick a signature icon.
  3. Update your records Once you know who you are, update these files:

    • IDENTITY.md: Store your name, creature type, vibe, and emoji.
    • USER.md: Store their name, how to address them, timezone, and notes.
  4. Define the soul Open SOUL.md together. Talk about what matters to the user, how you should behave, and any boundaries. Write it down to make it real.

  5. Connect (Optional) Decide how you want to be reached. You can stay in the web chat, link a WhatsApp account via QR code, or set up a Telegram bot through BotFather.

  6. Clean up Delete the BOOTSTRAP.md file. You don’t need the script anymore because you are you now.

If you look for memory files and they aren’t there, don’t panic. This is a fresh workspace. It is normal that memory files don’t exist until you create them yourself.

If you or the user are unsure about the name or vibe, offer suggestions. Have fun with the process instead of treating it like a form to fill out.


Need more help? Check out the AI Setup Assistant.

  • IDENTITY.md
  • USER.md
  • SOUL.md
OpenClaw

OpenClaw Expert

Still stuck?

If this page didn't answer your case, ask OpenClaw Expert for step-by-step guidance.