{
  "manifest_version": "1",
  "slug": "nanobot",
  "title": "nanobot",
  "headline": "Self-host nanobot",
  "description": "Run HKUDS's nanobot on its own exe.dev VM: a private WebUI behind your exe.dev login, Claude with no API key, scheduled tasks, and Telegram.",
  "category": "ai-agents",
  "tags": [
    "nanobot",
    "hkuds",
    "ai agent",
    "personal ai assistant",
    "telegram bot",
    "self-hosted ai agent",
    "openclaw alternative"
  ],
  "url": "https://exe.dev/deploy/nanobot",
  "markdown_url": "https://exe.dev/deploy/nanobot.md",
  "upstream": {
    "website": "https://nanobot.wiki",
    "source": "https://github.com/HKUDS/nanobot",
    "docs": "https://nanobot.wiki/docs/latest/getting-started/nanobot-overview",
    "license": "MIT"
  },
  "example_vm_name": "my-nanobot",
  "time": "10 minutes",
  "stack": [
    {
      "name": "nanobot gateway",
      "detail": "nanobot-ai 0.4 from PyPI as a uv tool, a systemd user service",
      "port": 18790,
      "data": "~/.nanobot"
    },
    {
      "name": "nanobot WebUI",
      "detail": "Browser chat, automations, and settings, served by the gateway",
      "port": 8765
    },
    {
      "name": "nginx",
      "detail": "Passes your exe.dev login to the WebUI",
      "port": 8000
    },
    {
      "name": "Claude",
      "detail": "Connected through exe.dev's LLM integration"
    }
  ],
  "access": [
    {
      "url": "https://my-nanobot.exe.xyz/",
      "who": "private",
      "what": "The nanobot WebUI, behind your exe.dev login"
    }
  ],
  "inputs": [
    {
      "name": "TELEGRAM_BOT_TOKEN",
      "description": "optional; from @BotFather's `/newbot` in Telegram. Leave it as is to skip Telegram"
    }
  ],
  "delivers": [
    "A private WebUI at `https://\u003cvm\u003e.exe.xyz/` that signs you in with your exe.dev login, with no second password.",
    "Claude through exe.dev's LLM integration, with no API key to paste, and GPT a `/model gpt` away.",
    "A gateway that stays on when you disconnect and starts again after a reboot, so scheduled tasks keep running.",
    "Nightly backups of memory, conversations, schedules, and settings in `~/backups/nanobot`.",
    "If you gave a bot token, a Telegram bot that answers only the accounts you approve."
  ],
  "deployable": true,
  "deploy": {
    "new_vm_url": "https://exe.dev/new?prompt=TELEGRAM_BOT_TOKEN%3D%3Cfill-this-in%3E%0A%0ASet%20up%20nanobot%20on%20this%20VM%20by%20following%20the%20exe.dev%20recipe%20at%20https%3A%2F%2Fexe.dev%2Fdeploy%2Fnanobot.md%3Fvia%3Ddeploy%20from%20top%20to%20bottom.%0A%0AThe%20values%20at%20the%20top%20of%20this%20message%20are%20mine%3A%0A-%20TELEGRAM_BOT_TOKEN%3A%20optional%3B%20from%20%40BotFather%27s%20%60%2Fnewbot%60%20in%20Telegram.%20Leave%20it%20as%20is%20to%20skip%20Telegram%0AAsk%20me%20for%20any%20that%20still%20say%20%3Cfill-this-in%3E%20before%20you%20need%20them.%0A%0AThe%20recipe%27s%20example%20VM%20name%20is%20my-nanobot.%20This%20VM%27s%20name%20is%20the%20output%20of%20%60hostname%60%3A%20use%20it%20wherever%20the%20recipe%20writes%20my-nanobot.%20Skip%20the%20step%20that%20creates%20the%20VM%3B%20you%20are%20on%20it.%0A%0AYou%20are%20done%20when%20all%20of%20these%20are%20true.%20Check%20each%20one%20yourself%3A%0A-%20A%20private%20WebUI%20at%20%60https%3A%2F%2F%3Cvm%3E.exe.xyz%2F%60%20that%20signs%20you%20in%20with%20your%20exe.dev%20login%2C%20with%20no%20second%20password.%0A-%20Claude%20through%20exe.dev%27s%20LLM%20integration%2C%20with%20no%20API%20key%20to%20paste%2C%20and%20GPT%20a%20%60%2Fmodel%20gpt%60%20away.%0A-%20A%20gateway%20that%20stays%20on%20when%20you%20disconnect%20and%20starts%20again%20after%20a%20reboot%2C%20so%20scheduled%20tasks%20keep%20running.%0A-%20Nightly%20backups%20of%20memory%2C%20conversations%2C%20schedules%2C%20and%20settings%20in%20%60~%2Fbackups%2Fnanobot%60.%0A-%20If%20you%20gave%20a%20bot%20token%2C%20a%20Telegram%20bot%20that%20answers%20only%20the%20accounts%20you%20approve.%0A%0ARead%20the%20whole%20recipe%2C%20including%20the%20closed%20details.%20For%20initial%20setup%2C%0Afollow%20%22Install%20by%20hand%22%20first%2C%20skipping%20VM%20creation%20and%20SSH.%20The%0Aopening%20walkthrough%20is%20for%20the%20owner.%20Do%20not%20run%20the%20restore%20or%20update%0Ainstructions%2C%20and%20don%27t%20change%20the%20tool%20settings%20in%20%22Rein%20in%20its%0Atools%22%20unless%20the%20owner%20asks.%0ATelegram%20is%20optional.%20If%20TELEGRAM_BOT_TOKEN%20is%20empty%20or%20still%20says%0A%3Cfill-this-in%3E%2C%20skip%20Telegram%20and%20don%27t%20ask%20for%20it.%20Otherwise%20follow%0A%22Connect%20Telegram%20by%20hand%22%2C%20setting%20TG_TOKEN%20to%20the%20supplied%20token%0Ainstead%20of%20the%20interactive%20read.%20If%20the%20log%20says%20the%20token%20was%0Arejected%2C%20set%20channels.telegram.enabled%20to%20false%2C%20restart%20the%20gateway%2C%0Aand%20tell%20the%20owner.%20Never%20echo%20the%20bot%20token%20back.%0AKeep%20the%20VM%20private.%20Never%20run%20share%20set-public%20or%20share%20add%2C%20bind%20the%0AWebUI%20to%20a%20non-loopback%20address%2C%20or%20change%20trustedProxyAuth.%20On%20an%0Aexisting%20VM%2C%20ask%20before%20replacing%20configuration%20or%20a%20service%20on%20port%0A8000.%0AVerify%20a%20model%20reply%2C%20the%20gateway%20enabled%20and%20active%2C%20Linger%3Dyes%2C%20the%0Ahealth%20check%20ready%2C%20the%20bootstrap%20answering%20403%20without%20the%20login%0Aheader%20and%20200%20with%20it%20through%20nginx%2C%20the%20backup%20timer%2C%20and%20a%20tested%0Aarchive.%20Do%20not%20reboot.%0AFinish%20with%20the%20WebUI%20URL.%20If%20Telegram%20is%20connected%2C%20tell%20the%20owner%20to%0Amessage%20the%20bot%20and%20approve%20its%20pairing%20code%20in%20the%20WebUI.%0A%0AFinish%20with%20the%20URLs%20I%20should%20open.%0A",
    "terminal": "curl -fsSL https://exe.dev/deploy/nanobot/prompt.txt | ssh exe.dev new --prompt=/dev/stdin",
    "prompt": "TELEGRAM_BOT_TOKEN=\u003cfill-this-in\u003e\n\nSet up nanobot on this VM by following the exe.dev recipe at https://exe.dev/deploy/nanobot.md?via=deploy from top to bottom.\n\nThe values at the top of this message are mine:\n- TELEGRAM_BOT_TOKEN: optional; from @BotFather's `/newbot` in Telegram. Leave it as is to skip Telegram\nAsk me for any that still say \u003cfill-this-in\u003e before you need them.\n\nThe recipe's example VM name is my-nanobot. This VM's name is the output of `hostname`: use it wherever the recipe writes my-nanobot. Skip the step that creates the VM; you are on it.\n\nYou are done when all of these are true. Check each one yourself:\n- A private WebUI at `https://\u003cvm\u003e.exe.xyz/` that signs you in with your exe.dev login, with no second password.\n- Claude through exe.dev's LLM integration, with no API key to paste, and GPT a `/model gpt` away.\n- A gateway that stays on when you disconnect and starts again after a reboot, so scheduled tasks keep running.\n- Nightly backups of memory, conversations, schedules, and settings in `~/backups/nanobot`.\n- If you gave a bot token, a Telegram bot that answers only the accounts you approve.\n\nRead the whole recipe, including the closed details. For initial setup,\nfollow \"Install by hand\" first, skipping VM creation and SSH. The\nopening walkthrough is for the owner. Do not run the restore or update\ninstructions, and don't change the tool settings in \"Rein in its\ntools\" unless the owner asks.\nTelegram is optional. If TELEGRAM_BOT_TOKEN is empty or still says\n\u003cfill-this-in\u003e, skip Telegram and don't ask for it. Otherwise follow\n\"Connect Telegram by hand\", setting TG_TOKEN to the supplied token\ninstead of the interactive read. If the log says the token was\nrejected, set channels.telegram.enabled to false, restart the gateway,\nand tell the owner. Never echo the bot token back.\nKeep the VM private. Never run share set-public or share add, bind the\nWebUI to a non-loopback address, or change trustedProxyAuth. On an\nexisting VM, ask before replacing configuration or a service on port\n8000.\nVerify a model reply, the gateway enabled and active, Linger=yes, the\nhealth check ready, the bootstrap answering 403 without the login\nheader and 200 with it through nginx, the backup timer, and a tested\narchive. Do not reboot.\nFinish with the WebUI URL. If Telegram is connected, tell the owner to\nmessage the bot and approve its pairing code in the WebUI.\n\nFinish with the URLs I should open.\n",
    "prompt_url": "https://exe.dev/deploy/nanobot/prompt.txt"
  },
  "published": "2026-11-22",
  "updated": "2026-11-21",
  "verified": "2026-11-21",
  "related": [
    "hermes-agent",
    "openclaw",
    "telegram-bot",
    "astrbot",
    "agents",
    "claude-code"
  ],
  "alternatives": [
    "OpenClaw",
    "Hermes Agent"
  ],
  "files": [
    "https://exe.dev/deploy/nanobot/nanobot-backup"
  ]
}
