Picture by Creator
# Introduction
I used to be searching for a substitute for OpenClaw, not as a result of it isn’t helpful, however as a result of it might really feel too heavy and bloated for easy on a regular basis use. I needed one thing light-weight, straightforward to arrange, and easy to connect with WhatsApp with out going via too many difficult steps. That’s once I got here throughout Nanobot on GitHub, and I additionally observed that many individuals have been beginning to discuss it on YouTube.
On this tutorial, we’ll discover the Nanobot structure and the way it works. Then, in six easy steps, we’ll undergo the set up, setup, and strategy of connecting it to WhatsApp so you can begin utilizing it as a 24/7 synthetic intelligence (AI) agent for a variety of duties.
# Utilizing Nanobot For Your First AI Agent
Nanobot is a wonderful selection for a primary AI agent as a result of it retains the general setup easy whereas nonetheless supporting the options that matter in real-world utilization. It may hook up with messaging platforms equivalent to WhatsApp, Telegram, Slack, Discord, Feishu, QQ, and electronic mail, whereas additionally working with a variety of mannequin suppliers and mannequin context protocol (MCP) instrument servers. This gives learners with a transparent technique to perceive how an agent is structured with out beginning with a system that feels overly advanced.
Structure of Nanobot | Picture from HKUDS/nanobot
It additionally stands out as a substitute for OpenClaw as a result of it gives sensible integrations and on a regular basis usability from the beginning. Alongside messaging channels, it helps instrument calling, internet search, scheduled duties, voice transcription, real-time progress streaming, and a number of supplier choices, which makes it simpler to show it right into a helpful private assistant as an alternative of only a demo venture.
# Step 1: Putting in uv
First, set up uv, which Nanobot makes use of to handle the Python atmosphere and dependencies. Then, verify it was put in appropriately by checking the model.
curl -LsSf https://astral.sh/uv/set up.sh | sh
Verify the set up:
Output:
uv 0.10.9 (f675560f3 2026-03-06)
# Step 2: Putting in Nanobot
As soon as uv is put in, use it to put in the Nanobot bundle. This can add the Nanobot command line interface (CLI) so it may be launched instantly from the terminal.
uv instrument set up nanobot-ai
# Step 3: Initializing Your Nanobot Venture
Subsequent, run the onboarding command to initialize Nanobot.
This creates the essential native setup, together with the default configuration listing at ~/.nanobot and the workspace Nanobot makes use of to retailer its information. After this step, Nanobot is prepared for supplier, mannequin, and channel configuration.
# Step 4: Including Your Nanobot Configuration
Navigate to your ~/.nanobot/config.json file, then copy and paste the configuration beneath. Earlier than saving, exchange the placeholder values with your individual OpenAI API key, mannequin, and WhatsApp quantity.
{
“suppliers”: {
“openai”: {
“apiKey”: “sk-REPLACE_ME”
}
},
“brokers”: {
“defaults”: {
“mannequin”: “openai/gpt-5.3-codex”,
“supplier”: “openai”
}
},
“channels”: {
“whatsapp”: {
“enabled”: true,
“allowFrom”: [“1234567890”]
}
}
}
Earlier than you save, edit:
- apiKey along with your actual OpenAI API key
- mannequin if you wish to use a special mannequin
- allowFrom with your individual WhatsApp quantity
One essential be aware — current Nanobot points present that WhatsApp allowFrom formatting could be barely inconsistent in follow, and a few customers report it really works higher with out the “+” signal relying on their particular setup.
# Step 5: Connecting Nanobot To WhatsApp
Earlier than beginning the WhatsApp login circulation, be certain that Node.js and npm are put in in your machine, because the WhatsApp bridge runs via a Node-based course of.
First, begin the login circulation in a single terminal:
nanobot channels login whatsapp
This can generate a QR code that you should scan from WhatsApp → Settings → Linked Units in your cellphone. As soon as the machine is linked, open a second terminal and begin the Nanobot gateway:
That is the method that retains the channel operating so Nanobot can obtain and reply to WhatsApp messages.
# Step 6: Testing Your AI Agent On WhatsApp
To check the agent, you have to a second cellphone. This second cellphone quantity ought to already be added to the allowFrom checklist in your configuration file. Once you ship a message to the primary cellphone quantity related to Nanobot, it ought to reply via WhatsApp.
On this instance, the immediate asks what is going on on this planet. Nanobot then processes the request, performs an online search if instruments are enabled, and returns an in depth snapshot primarily based on the newest info.
Whereas the gateway terminal is operating, you possibly can observe the total agent workflow in actual time. This consists of receiving the message, calling instruments, producing the response, and sending the reply again, which makes it simpler to verify that every part is functioning appropriately.
# Last Ideas
Organising Nanobot confirmed me that constructing a private AI agent doesn’t should be overly difficult, although it was not totally friction-free. I appreciated how shortly I may transition from a terminal setup to a working WhatsApp-connected agent that gives helpful responses in follow.
Nonetheless, I did encounter a couple of minor hurdles. On Home windows, if Node.js or npm was already put in in a sure configuration, the Python script generally did not detect npm appropriately within the terminal, which made the preliminary setup barely complicated. Moreover, the shortage of in depth WhatsApp documentation meant it was not instantly apparent that the interface works by messaging the related machine instantly somewhat than via a separate bot chat interface.
Regardless of these minor points, Nanobot stays a robust start line for anybody seeking to construct their first AI agent. It gives a core agent expertise with out the overhead of heavier alternate options. As soon as the setup is operational, its worth turns into instantly obvious, bridging the hole between easy terminal instructions and a really useful private assistant.
Abid Ali Awan (@1abidaliawan) is an authorized knowledge scientist skilled who loves constructing machine studying fashions. At present, he’s specializing in content material creation and writing technical blogs on machine studying and knowledge science applied sciences. Abid holds a Grasp’s diploma in know-how administration and a bachelor’s diploma in telecommunication engineering. His imaginative and prescient is to construct an AI product utilizing a graph neural community for college kids combating psychological sickness.
