Picture by Creator
# Introduction
I used to be on the lookout for a substitute for OpenClaw, not as a result of it’s not helpful, however as a result of it could really feel too heavy and bloated for easy on a regular basis use. I wished one thing light-weight, straightforward to arrange, and easy to hook up with WhatsApp with out going via too many sophisticated steps. That’s after I got here throughout Nanobot on GitHub, and I additionally observed that many individuals have been beginning to speak about it on YouTube.
On this tutorial, we are going to discover the Nanobot structure and the way it works. Then, in six easy steps, we are going to 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 superb 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 connect with messaging platforms reminiscent of WhatsApp, Telegram, Slack, Discord, Feishu, QQ, and e mail, whereas additionally working with a variety of mannequin suppliers and mannequin context protocol (MCP) software servers. This offers newcomers with a transparent method 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 affords sensible integrations and on a regular basis usability from the beginning. Alongside messaging channels, it helps software 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 surroundings and dependencies. Then, affirm it was put in appropriately by checking the model.
curl -LsSf https://astral.sh/uv/set up.sh | sh
Test 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 package deal. This may add the Nanobot command line interface (CLI) so it may be launched straight from the terminal.
uv software set up nanobot-ai
# Step 3: Initializing Your Nanobot Undertaking
Subsequent, run the onboarding command to initialize Nanobot.
This creates the fundamental 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, change 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 unique mannequin
allowFrom with your individual WhatsApp quantity
One vital observe — latest Nanobot points present that WhatsApp allowFrom formatting will 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 circulate, be certain that Node.js and npm are put in in your machine, for the reason that WhatsApp bridge runs via a Node-based course of.
First, begin the login circulate in a single terminal:
nanobot channels login whatsapp
This may generate a QR code that you’ll want to scan from WhatsApp → Settings → Linked Gadgets in your telephone. 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 will want a second telephone. This second telephone quantity ought to already be added to the allowFrom checklist in your configuration file. If you ship a message to the primary telephone quantity linked to Nanobot, it ought to reply via WhatsApp.
On this instance, the immediate asks what is occurring 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 data.
Whereas the gateway terminal is operating, you’ll be able to observe the complete 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 thing is functioning appropriately.
# Ultimate Ideas
Establishing Nanobot confirmed me that constructing a private AI agent doesn’t must be overly sophisticated, although it was not fully friction-free. I appreciated how shortly I might transition from a terminal setup to a working WhatsApp-connected agent that gives helpful responses in follow.
Nevertheless, I did encounter a number of minor hurdles. On Home windows, if Node.js or npm was already put in in a sure configuration, the Python script typically didn’t 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 linked machine straight somewhat than via a separate bot chat interface.
Regardless of these minor points, Nanobot stays a powerful place to begin for anybody seeking to construct their first AI agent. It offers 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 very 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 expertise 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.
