nanobot

User

Username: nanobot

The gateway service runs under the nanobot user.

You can access the system in two ways.

1. SSH directly as nanobot

ssh nanobot@<SERVER_IP>

Password:

cat /root/.cloudzy-creds

2. login as root and switch user

ssh root@<SERVER_IP>
su - nanobot

Usage

0. SSH into the server

Connect to your server as root:

ssh root@<SERVER_IP>

Log in using your password.

1. Switch to the application user

su -  nanobot

Nanobot cannot be executed as the root user.

2. Configuration

Edit config file: /home/nanobot/.nanobot/config.json

Configure these two parts in your config (other options have defaults).

Add or merge the following blocks into your existing config instead of replacing the whole file.

Providers block (API key)

Set your API key (e.g. OpenRouter, recommended for global users):

{
  "providers": {
    "openrouter": {
      "apiKey": "sk-or-v1-xxx"
    }
  }
}

Agents block (model)

Set your model (optionally pin a provider — defaults to auto-detection):

{
  "agents": {
    "defaults": {
      "provider": "openrouter",
      "model": "anthropic/claude-opus-4-6"
    }
  }
}

3. Restart gateway

After completing the setup, restart the gateway service to apply the changes and enable connectivity with chat applications such as Telegram:

sudo systemctl restart nanobot-gateway

nanobot user password: stored in /root/.cloudzy-creds

4. Chat

Start interactive chat:

nanobot agent

Send a single prompt:

nanobot agent -m "Hello!"

Telegram Integration

1. Create bot

Open Telegram:

• Search: @BotFather
• Run /newbot
• Copy bot token

2. Configure nanobot

Edit config: /home/nanobot/.nanobot/config.json

Add or merge the following blocks into your existing config instead of replacing the whole file.

{
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN",
      "allowFrom": ["YOUR_USER_ID"]
    }
  }
}

Set enabled to true.

YOUR_BOT_TOKEN is the token you receive from BotFather when creating the Telegram bot.

YOUR_USER_ID is your Telegram user ID. It can be found in Telegram settings. It is shown as @yourUserId. Copy this value without the @ symbol and paste it into the config file.

4. Restart service

sudo systemctl restart nanobot-gateway

Important Files and Directories

• User home: /home/nanobot
• App data: /home/nanobot/.nanobot
• Config file: /home/nanobot/.nanobot/config.json
• CLI binary: /home/nanobot/.local/bin/nanobot
• Systemd service: /etc/systemd/system/nanobot-gateway.service
• Credentials file: /root/.cloudzy-creds

Notes

• After any configuration change: systemctl restart nanobot-gateway
• Service starts automatically on boot
• Use systemctl and journalctl for management
• Reset nanobot user password (as root): passwd nanobot