Quick start

​

Before you start

• A Mac or Linux computer with at least 4 GB of memory, an internet connection, and permission to install software. Keep this computer on and connected when you want your assistant to respond.
• An AI account. The walkthrough below uses a Claude Pro or Max subscription. Have its sign-in details ready. If you already use another supported option, see the alternatives below.
• Git, the tool used to download NanoClaw. You’ll check for it in the next step.

​

Set up your assistant

1

Open Terminal and check Git

• Mac
• Linux or Windows with WSL

Press Command + Space, type Terminal, and press Return.

On Linux, open Terminal from your applications. On Windows, open the Linux app you installed with WSL, such as Ubuntu.

Copy the command below into that window. Press Enter to run it.

git --version

✓

Before you continue

A line beginning with git version appears. The number after it can vary.

If your Mac offers to install developer tools, follow that prompt, then run the command again. If Git is missing, follow the Git installation instructions for your operating system before continuing.

2

Download NanoClaw and start setup

These four commands open your home folder, download NanoClaw, open its folder, and start setup. Copy and run one line at a time, waiting for each command to finish:

cd ~
git clone https://github.com/nanocoai/nanoclaw.git
cd nanoclaw
bash nanoclaw.sh

It checks your computer and installs supporting software. Follow any prompts it shows. On a new Mac, this can include installing Apple’s developer tools and entering your computer password.Choose Standard setup, then Fresh agent when the next question appears. Use the arrow keys to move through choices and Enter to select one.An agent is your AI assistant. You can give it a job and preferences by chatting with it.

3

Prepare your assistant's workspace

Setup calls this workspace a sandbox. It keeps the assistant’s working files separate from the rest of your computer.Setup asks Enable Echo’s hardened agent image? Open the perks dashboard in your browser? Press Enter to accept. This is how you get the prepared software.Using Codex or skipping the download account? Answer no to the browser question. Wait for the local build to finish, then continue to the AI account step. This can take several minutes. See other AI accounts.For the download option, sign in to NanoClaw in the browser window that opens. You can create an account there. If no browser opens, open the link shown in Terminal.If asked to confirm a code, check that it matches the code in Terminal. Once you see the confirmation screen, return to Terminal.

• Sign-in screen
• Confirmation screen

✓

Before you continue

Keep Terminal open until the download or local build finishes and setup moves on to your AI account.

4

Connect your AI account

Setup first installs OneCLI, the vault that stores your AI sign-in securely.For this walkthrough, choose Claude, then Claude subscription. Follow the browser prompts to connect your AI account. This is separate from the NanoClaw download account.If you chose the Codex path, select Codex instead and follow its sign-in prompts. See other AI accounts.

✓

Before you continue

When the browser sign-in finishes, Terminal shows Done. after saving your sign-in to the vault. Return to Terminal if you’re still in the browser.

When Terminal says Setting your assistant’s access rules…, setup is configuring which extra folders on your computer can be shared with your assistant. On a fresh installation, that list starts empty. Your assistant still has its own workspace; you do not need to share personal folders to complete this guide. If you already have access rules, setup keeps them.This step runs automatically. Wait for Access rules set. or Access rules already set., then let NanoClaw start its background service so it can keep running after setup. Enter the name you’d like your assistant to call you when asked.

5

Have your first conversation

Setup sends a test message to check your assistant can reply. The first response may take a little time while it starts.Choose Pause here and chat with your agent from the terminal. This creates the terminal assistant you’ll use in this guide. Move down to that option with the arrow key, then press Enter.Type a message such as:

Hi! Give me three ideas for a relaxing weekend at home.

Press Enter to send it.

✓

Before you continue

Your assistant replies beneath your message. You can send another message at the next prompt.

When you’re ready to finish setup, leave the next message empty and press Enter. Follow the timezone prompt if one appears.

6

Finish setup, with messaging now or later

At the channel question, choose Skip for now to keep using the terminal assistant you just created. A channel is a way to message an assistant, such as Telegram or Slack.

Want to connect a messaging app now?

Choose an app and have the following ready:

• Telegram: A Telegram account. Setup walks you through creating a bot with @BotFather, pasting its token into Terminal, and sending a pairing code to your bot.
• Slack: A Slack workspace where you can install an app, or an administrator who can approve it. Setup offers to create the app for you, with a manual setup option if needed.
• WhatsApp: Your phone with WhatsApp signed in. Open Linked Devices to link NanoClaw using a QR code or pairing code.

For other apps, see the channel guides.Follow the final instructions for that app: some require you to send the first message. A messaging app can connect to a different assistant from the one you met in Terminal.

✓

Before you continue

If you skipped the channel question, Terminal ends with You’re ready! Chat with pnpm run chat hi. If you connected a messaging app, it ends with You’re set. and tells you to look for a welcome message in that app. If setup reports a problem instead, follow its recovery instructions before continuing.

To send another message later, run this from the same Terminal window, still in the nanoclaw folder:

pnpm run chat "Help me plan one of those weekend ideas."

This sends one message and prints the reply. Run it again with different text for your next message.If you open a new Terminal window later, run cd ~/nanoclaw first. If Terminal cannot find pnpm, see command not found below.

​

Things to try first

• Plan something: “Help me make a shopping list for a dinner for two.”
• Set a preference: “Please keep your answers short and use bullet points.”
• Explore a topic: “Find three beginner resources for learning to grow herbs.”

​

If you get stuck

​

Next steps