README
¶
nagobot
Tired of endless configuration and unstable runtime? Try nagobot.
nagobot is an ultra-light AI assistant built with Go. One install, all channels.
Website · Releases · Documentation
Inspired by nanobot (github.com/HKUDS/nanobot) and openclaw (github.com/openclaw).
This project is evolving rapidly.
Features
Multi-provider AI assistant with tool calling, async multi-threading, cron scheduling, web search, and context compression — deployable via Telegram, Web, or CLI.
Supported Providers and Models
Run nagobot set-model --list to see all supported provider/model pairs.
Channels
- Telegram
- Discord
- Web
- CLI
Requirements
- Go
1.23.3+
Build
go build -o nagobot .
Install
curl -fsSL https://nagobot.com/install.sh | bash
Windows (PowerShell):
irm https://nagobot.com/install.ps1 | iex
Quick Start
- Run the interactive setup wizard:
nagobot onboard
The wizard will guide you through provider selection, API key setup, and optional Telegram configuration.
The wizard will also install the service, which starts automatically on boot.
The project may change drastically between versions. Please re-run onboard after updating.
Documentation
Play
Don't know how to use it? Try these example prompts:
Create a job that runs at 9am, 12pm, and 6pm every day. Based on my conversation history, search news for me.
I want you to search for recent stock market topics, please create 3 threads to search.
Documentation
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
Package agent provides prompt builders.
|
Package agent provides prompt builders. |
|
Package channel provides messaging channel interfaces and implementations.
|
Package channel provides messaging channel interfaces and implementations. |
|
Package cmd provides CLI commands.
|
Package cmd provides CLI commands. |
|
Package config handles configuration loading and saving.
|
Package config handles configuration loading and saving. |
|
experiments
|
|
|
glm5
command
Minimal experiment for Zhipu GLM-5 API.
|
Minimal experiment for Zhipu GLM-5 API. |
|
minimax
command
Minimal experiment for MiniMax M2.5 API.
|
Minimal experiment for MiniMax M2.5 API. |
|
internal
|
|
|
Package logger provides a minimal slog-based logging wrapper.
|
Package logger provides a minimal slog-based logging wrapper. |
|
Package monitor provides metrics collection, storage, and balance checking.
|
Package monitor provides metrics collection, storage, and balance checking. |
|
Package provider provides LLM provider implementations.
|
Package provider provides LLM provider implementations. |
|
Package skills provides the skill system for nagobot.
|
Package skills provides the skill system for nagobot. |
|
Package tgmd converts standard Markdown into Telegram-compatible HTML.
|
Package tgmd converts standard Markdown into Telegram-compatible HTML. |
|
msg
Package msg defines the WakeMessage type shared between thread and tools.
|
Package msg defines the WakeMessage type shared between thread and tools. |
|
Package tools provides the tool interface and built-in tools.
|
Package tools provides the tool interface and built-in tools. |