Kembali ke skill
nanobot
oleh HKUDS
Claude CodeโBelum ada penilaian
Penilaian Anda
Ringkasan
"๐ nanobot: The Ultra-Lightweight Personal AI Agent"
Deskripsi

<div align="center">
<p>
<a href="https://pypi.org/project/nanobot-ai/"><img src="https://img.shields.io/pypi/v/nanobot-ai" alt="PyPI"></a>
<a href="https://pepy.tech/project/nanobot-ai"><img src="https://static.pepy.tech/badge/nanobot-ai" alt="Downloads"></a>
<img src="https://img.shields.io/badge/python-โฅ3.11-blue" alt="Python">
<img src="https://img.shields.io/badge/license-MIT-green" alt="License">
<a href="https://github.com/HKUDS/nanobot/graphs/commit-activity" target="_blank">
<img alt="Commits last month" src="https://img.shields.io/github/commit-activity/m/HKUDS/nanobot?labelColor=%20%2332b583&color=%20%2312b76a"></a>
<a href="https://github.com/HKUDS/nanobot/issues?q=is%3Aissue%20is%3Aclosed" target="_blank">
<img alt="Issues closed" src="https://img.shields.io/github/issues-search?query=repo%3AHKUDS%2Fnanobot%20is%3Aissue%20is%3Aclosed&label=issues%20closed&labelColor=%20%237d89b0&color=%20%235d6b98"></a>
<a href="https://twitter.com/intent/follow?screen_name=nanobot_project" target="_blank">
<img src="https://img.shields.io/twitter/follow/nanobot_project?logo=X&color=%20%23f5f5f5" alt="follow on X(Twitter)"></a>
<a href="https://nanobot.wiki/docs/latest/getting-started/nanobot-overview"><img src="https://img.shields.io/badge/Docs-nanobot.wiki-blue?style=flat&logo=readthedocs&logoColor=white" alt="Docs"></a>
<a href="./COMMUNICATION.md"><img src="https://img.shields.io/badge/Feishu-Group-E9DBFC?style=flat&logo=feishu&logoColor=white" alt="Feishu"></a>
<a href="./COMMUNICATION.md"><img src="https://img.shields.io/badge/WeChat-Group-C5EAB4?style=flat&logo=wechat&logoColor=white" alt="WeChat"></a>
<a href="https://discord.gg/MnCvHqpUGB"><img src="https://img.shields.io/badge/Discord-Community-5865F2?style=flat&logo=discord&logoColor=white" alt="Discord"></a>
</p>
</div>
๐ **nanobot** is an open-source and ultra-lightweight AI agent in the spirit of [OpenClaw](https://github.com/openclaw/openclaw), [Claude Code](https://www.anthropic.com/claude-code), and [Codex](https://www.openai.com/codex/). It keeps the core agent loop small and readable while still supporting chat channels, memory, MCP and practical deployment paths, so you can go from local setup to a long-running personal agent with minimal overhead.
## ๐ข News
- **2026-04-21** ๐ Released **v0.1.5.post2** โ Windows & Python 3.14 support, Office document reading, SSE streaming for the OpenAI-compatible API, and stronger reliability across sessions, memory, and channels. Please see [release notes](https://github.com/HKUDS/nanobot/releases/tag/v0.1.5.post2) for details.
- **2026-04-20** ๐จ Kimi K2.6 support, Telegram long-message split, WebUI typography & dark-mode polish.
- **2026-04-19** ๐ WebUI i18n locale switcher, atomic session writes with auto-repair.
- **2026-04-18** ๐งช Initial WebUI chat, smarter setup wizard menus, WebSocket multi-chat multiplexing.
- **2026-04-17** ๐ช Windows & Python 3.14 CI, Dream line-age memory, email self-loop guard.
- **2026-04-16** ๐ก SSE streaming for OpenAI-compatible API, Discord channel allow-list.
- **2026-04-15** ๐๏ธ LM Studio & nullable API keys, MiniMax thinking endpoint, runtime SelfTool.
- **2026-04-14** ๐ Released **v0.1.5.post1** โ Dream skill discovery, mid-turn follow-up injection, WebSocket channel, and deeper channel integrations. Please see [release notes](https://github.com/HKUDS/nanobot/releases/tag/v0.1.5.post1) for details.
- **2026-04-13** ๐ก๏ธ Agent turn hardened โ user messages persisted early, auto-compact skips active tasks.
- **2026-04-12** ๐ Lark global domain support, Dream learns discovered skills, shell sandbox tightened.
- **2026-04-11** โก Context compact shrinks sessions on the fly; Kagi web search; QQ & WeCom full media.
<details>
<summary>Earlier news</summary>
- **2026-04-10** ๐ Notebook editing tool, multiple MCP servers, Feishu streaming & done-emoji.
- **2026-04-09** ๐ WebSocket channel, unified cross-channel session, `disabled_skills` config.
- **2026-04-08** ๐ค API file uploads, OpenAI reasoning auto-routing with Responses fallback.
- **2026-04-07** ๐ง Anthropic adaptive thinking, MCP resources & prompts exposed as tools.
- **2026-04-06** ๐ฐ๏ธ Langfuse observability, unified Whisper transcription, email attachments.
- **2026-04-05** ๐ Released **v0.1.5** โ sturdier long-running tasks, Dream two-stage memory, production-ready sandboxing and programming Agent SDK. Please see [release notes](https://github.com/HKUDS/nanobot/releases/tag/v0.1.5) for details.
- **2026-04-04** ๐ Jinja2 response templates, Dream memory hardened, smarter retry handling.
- **2026-04-03** ๐ง Xiaomi MiMo provider, chain-of-thought reasoning visible, Telegram UX polish.
- **2026-04-02** ๐งฑ Long-running tasks run more reliably โ core runtime hardening.
- **2026-04-01** ๐ GitHub Copilot auth restored; stricter workspace paths; OpenRouter Claude caching fix.
- **2026-03-31** ๐ฐ๏ธ WeChat multimodal alignment, Discord/Matrix polish, Python SDK facade, MCP and tool fixes.
- **2026-03-30** ๐งฉ OpenAI-compatible API tightened; composable agent lifecycle hooks.
- **2026-03-29** ๐ฌ WeChat voice, typing, QR/media resilience; fixed-session OpenAI-compatible API.
- **2026-03-28** ๐ Provider docs refresh; skill template wording fix.
- **2026-03-27** ๐ Released **v0.1.4.post6** โ architecture decoupling, litellm removal, end-to-end streaming, WeChat channel, and a security fix. Please see [release notes](https://github.com/HKUDS/nanobot/releases/tag/v0.1.4.post6) for details.
- **2026-03-26** ๐๏ธ Agent runner extracted and lifecycle hooks unified; stream delta coalescing at boundaries.
- **2026-03-25** ๐ StepFun provider, configurable timezone, Gemini thought signatures.
- **2026-03-24** ๐ง WeChat compatibility, Feishu CardKit streaming, test suite restructured.
- **2026-03-23** ๐ง Command routing refactored for plugins, WhatsApp/WeChat media, unified channel login CLI.
- **2026-03-22** โก End-to-end streaming, WeChat channel, Anthropic cache optimization, `/status` command.
- **2026-03-21** ๐ Replace `litellm` with native `openai` + `anthropic` SDKs. Please see [commit](https://github.com/HKUDS/nanobot/commit/3dfdab7).
- **2026-03-20** ๐ง Interactive setup wizard โ pick your provider, model autocomplete, and you're good to go.
- **2026-03-19** ๐ฌ Telegram gets more resilient under load; Feishu now renders code blocks properly.
- **2026-03-18** ๐ท Telegram can now send media via URL. Cron schedules show human-readable details.
- **2026-03-17** โจ Feishu formatting glow-up, Slack reacts when done, custom endpoints support extra headers, and image handling is more reliable.
- **2026-03-16** ๐ Released **v0.1.4.post5** โ a refinement-focused release with stronger reliability and channel support, and a more dependable day-to-day experience. Please see [release notes](https://github.com/HKUDS/nanobot/releases/tag/v0.1.4.post5) for details.
- **2026-03-15** ๐งฉ DingTalk rich media, smarter built-in skills, and cleaner model compatibility.
- **2026-03-14** ๐ฌ Channel plugins, Feishu replies, and steadier MCP, QQ, and media handling.
- **2026-03-13** ๐ Multi-provider web search, LangSmith, and broader reliability improvements.
- **2026-03-12** ๐ VolcEngine support, Telegram reply context, `/restart`, and sturdier memory.
- **2026-03-11** ๐ WeCom, Ollama, cleaner discovery, and safer tool behavior.
- **2026-03-10** ๐ง Token-based memory, shared retries, and cleaner gateway and Telegram behavior.
- **2026-03-09** ๐ฌ Slack thread polish and better Feishu audio compatibility.
- **2026-03-08** ๐ Released **v0.1.4.post4** โ a reliability-packed release with safer defaults, better multi-instance support, sturdier MCP, and major channel and provider improvements. Please see [release notes](https://github.com/HKUDS/nanobot/releases/tag/v0.1.4.post4) for details.
- **2026-03-07** ๐ Azure OpenAI provider, WhatsApp media, QQ group chats, and more Telegram/Feishu polish.
- **2026-03-06** ๐ช Lighter providers, smarter media handling, and sturdier memory and CLI compatibility.
- **2026-03-05** โก๏ธ Telegram draft streaming, MCP SSE support, and broader channel reliability fixes.
- **2026-03-04** ๐ ๏ธ Dependency cleanup, safer file reads, and another round of test and Cron fixes.
- **2026-03-03** ๐ง Cleaner user-message merging, safer multimodal saves, and stronger Cron guards.
- **2026-03-02** ๐ก๏ธ Safer default access control, sturdier Cron reloads, and cleaner Matrix media handling.
- **2026-03-01** ๐ Web proxy support, smarter Cron reminders, and Feishu rich-text parsing improvements.
- **2026-02-28** ๐ Released **v0.1.4.post3** โ cleaner context, hardened session history, and smarter agent. Please see [release notes](https://github.com/HKUDS/nanobot/releases/tag/v0.1.4.post3) for details.
- **2026-02-27** ๐ง Experimental thinking mode support, DingTalk media messages, Feishu and QQ channel fixes.
- **2026-02-26** ๐ก๏ธ Session poisoning fix, WhatsApp dedup, Windows path guard, Mistral compatibility.
- **2026-02-25** ๐งน New Matrix channel, cleaner session context, auto workspace template sync.
- **2026-02-24** ๐ Released **v0.1.4.post2** โ a reliability-focused release with a redesigned heartbeat, prompt cache optimization, and hardened provider & channel stability. See [release notes](https://github.com/HKUDS/nanobot/releases/tag/v0.1.4.post2) for details.
- **2026-02-23** ๐ง Virtual tool-call heartbeat, prompt cache optimization, Slack mrkdwn fixes.
- **2026-02-22** ๐ก๏ธ Slack thread isolation, Discord typing fix, agent reliability improvements.
- **2026-02-21** ๐ Released **v0.1.4.post1** โ new providers, media support across channels, and major stability improvements. See [release notes](https://github.com/HKUDS/nanobot/releases/tag/v0.1.4.post1) for details.
- **2026-02-20** ๐ฆ Feishu now receives multimodal files from users. More reliable memory under the hood.
- **2026-02-19** โจ Slack now sends files, Discord splits long messages, and subagents work in CLI mode.
- **2026-02-18** โก๏ธ nanobot now supports VolcEngine, MCP custom auth headers, and Anthropic prompt caching.
- **2026-02-17** ๐ Released **v0.1.4** โ MCP support, progress streaming, new providers, and multiple channel improvements. Please see [release notes](https://github.com/HKUDS/nanobot/releases/tag/v0.1.4) for details.
- **2026-02-16** ๐ฆ nanobot now integrates a [ClawHub](https://clawhub.ai) skill โ search and install public agent skills.
- **2026-02-15** ๐ nanobot now supports OpenAI Codex provider with OAuth login support.
- **2026-02-14** ๐ nanobot now supports MCP! See [MCP section](#mcp-model-context-protocol) for details.
- **2026-02-13** ๐ Released **v0.1.3.post7** โ includes security hardening and multiple improvements. **Please upgrade to the latest version to address security issues**. See [release notes](https://github.com/HKUDS/nanobot/releases/tag/v0.1.3.post7) for more details.
- **2026-02-12** ๐ง Redesigned memory system โ Less code, more reliable. Join the [discussion](https://github.com/HKUDS/nanobot/discussions/566) about it!
- **2026-02-11** โจ Enhanced CLI experience and added MiniMax support!
- **2026-02-10** ๐ Released **v0.1.3.post6** with improvements! Check the updates [notes](https://github.com/HKUDS/nanobot/releases/tag/v0.1.3.post6) and our [roadmap](https://github.com/HKUDS/nanobot/discussions/431).
- **2026-02-09** ๐ฌ Added Slack, Email, and QQ support โ nanobot now supports multiple chat platforms!
- **2026-02-08** ๐ง Refactored Providersโadding a new LLM provider now takes just 2 simple steps! Check [here](#providers).
- **2026-02-07** ๐ Released **v0.1.3.post5** with Qwen support & several key improvements! Check [here](https://github.com/HKUDS/nanobot/releases/tag/v0.1.3.post5) for details.
- **2026-02-06** โจ Added Moonshot/Kimi provider, Discord integration, and enhanced security hardening!
- **2026-02-05** โจ Added Feishu channel, DeepSeek provider, and enhanced scheduled tasks support!
- **2026-02-04** ๐ Released **v0.1.3.post4** with multi-provider & Docker support! Check [here](https://github.com/HKUDS/nanobot/releases/tag/v0.1.3.post4) for details.
- **2026-02-03** โก Integrated vLLM for local LLM support and improved natural language task scheduling!
- **2026-02-02** ๐ nanobot officially launched! Welcome to try ๐ nanobot!
</details>
## ๐ก Key Features of nanobot
- **Ultra-lightweight**: stable long-running agent behavior with a small, readable core.
- **Research-ready**: the codebase is intentionally simple enough to study, modify, and extend.
- **Practical**: chat channels, API, memory, MCP, and deployment paths are already built in.
- **Hackable**: you can start fast, then go deeper through repo docs instead of a monolithic landing page.
## ๐ฆ Install
> [!IMPORTANT]
> If you want the newest features and experiments, install from source.
>
> If you want the most stable day-to-day experience, install from PyPI or with `uv`.
**Install from source**
```bash
git clone https://github.com/HKUDS/nanobot.git
cd nanobot
pip install -e .
```
**Install with `uv`**
```bash
uv tool install nanobot-ai
```
**Install from PyPI**
```bash
pip install nanobot-ai
```
## ๐ Quick Start
**1. Initialize**
```bash
nanobot onboard
```
**2. Configure** (`~/.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.
*Set your API key* (e.g. [OpenRouter](https://openrouter.ai/keys), recommended for global users):
```json
{
"providers": {
"openrouter": {
"apiKey": "sk-or-v1-xxx"
}
}
}
```
*Set your model* (optionally pin a provider โ defaults to auto-detection):
```json
{
"agents": {
"defaults": {
"provider": "openrouter",
"model": "anthropic/claude-opus-4-6"
}
}
}
```
**3. Chat**
```bash
nanobot agent
```
- Want different LLM providers, web search, MCP, security settings, or more config options? See [Configuration](./docs/configuration.md)
- Want to run nanobot in chat apps like Telegram, Discord, WeChat or Feishu? See [Chat Apps](./docs/chat-apps.md)
- Want Docker or Linux service deployment? See [Deployment](./docs/deployment.md)
## ๐งช WebUI (Development)
> [!NOTE]
> The WebUI development workflow currently requires a source checkout and is not yet shipped together with the official packaged release. See [WebUI Document](./webui/README.md) for full WebUI development docs and build steps.
<p align="center">
<img src="images/nanobot_webui.png" alt="nanobot webui preview" width="900">
</p>
**1. Enable the WebSocket channel in `~/.nanobot/config.json`**
```json
{ "channels": { "websocket": { "enabled": true } } }
```
**2. Start the gateway**
```bash
nanobot gateway
```
**3. Start the webui dev server**
```bash
cd webui
bun install
bun run dev
```
## ๐๏ธ Architecture
<p align="center">
<img src="images/nanobot_arch.png" alt="nanobot architecture" width="800">
</p>
๐ nanobot stays lightweight by centering everything around a small agent loop: messages come in from chat apps, the LLM decides when tools are needed, and memory or skills are pulled in only as context instead of becoming a heavy orchestration layer. That keeps the core path readable and easy to extend, while still letting you add channels, tools, memory, and deployment options without turning the system into a monolith.
## โจ Features
<table align="center">
<tr align="center">
<th><p align="center">๐ 24/7 Real-Time Market Analysis</p></th>
<th><p align="center">๐ Full-Stack Software Engineer</p></th>
<th><p align="center">๐
Smart Daily Routine Manager</p></th>
<th><p align="center">๐ Personal Knowledge Assistant</p></th>
</tr>
<tr>
<td align="center"><p align="center"><img src="case/search.gif" width="180" height="400"></p></td>
<td align="center"><p align="center"><img src="case/code.gif" width="180" height="400"></p></td>
<td align="center"><p align="center"><img src="case/schedule.gif" width="180" height="400"></p></td>
<td align="center"><p align="center"><img src="case/memory.gif" width="180" height="400"></p></td>
</tr>
<tr>
<td align="center">Discovery โข Insights โข Trends</td>
<td align="center">Develop โข Deploy โข Scale</td>
<td align="center">Schedule โข Automate โข Organize</td>
<td align="center">Learn โข Memory โข Reasoning</td>
</tr>
</table>
## ๐ Docs
Browse the [repo docs](./docs/README.md) for the latest features and GitHub development version, or visit [nanobot.wiki](https://nanobot.wiki/docs/latest/getting-started/nanobot-overview) for the stable release documentation.
- Talk to your nanobot with familiar chat apps: [Chat Apps](./docs/chat-apps.md)
- Configure providers, web search, MCP, and runtime behavior: [Configuration](./docs/configuration.md)
- Integrate nanobot with local tools and automations: [OpenAI-Compatible API](./docs/openai-api.md) ยท [Python SDK](./docs/python-sdk.md)
- Run nanobot with Docker or as a Linux service: [Deployment](./docs/deployment.md)
## ๐ค Contribute & Roadmap
PRs welcome! The codebase is intentionally small and readable. ๐ค
### Branching Strategy
| Branch | Purpose |
|--------|---------|
| `main` | Stable releases โ bug fixes and minor improvements |
| `nightly` | Experimental features โ new features and breaking changes |
**Unsure which branch to target?** See [CONTRIBUTING.md](./CONTRIBUTING.md) for details.
**Roadmap** โ Pick an item and [open a PR](https://github.com/HKUDS/nanobot/pulls)!
- **Multi-modal** โ See and hear (images, voice, video)
- **Long-term memory** โ Never forget important context
- **Better reasoning** โ Multi-step planning and reflection
- **More integrations** โ Calendar and more
- **Self-improvement** โ Learn from feedback and mistakes
### Contributors
<a href="https://github.com/HKUDS/nanobot/graphs/contributors">
<img src="https://contrib.rocks/image?repo=HKUDS/nanobot&max=100&columns=12&updated=20260210" alt="Contributors" />
</a>
## โญ Star History
<div align="center">
<a href="https://star-history.com/#HKUDS/nanobot&Date">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/svg?repos=HKUDS/nanobot&type=Date&theme=dark" />
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/svg?repos=HKUDS/nanobot&type=Date" />
<img alt="Star History Chart" src="https://api.star-history.com/svg?repos=HKUDS/nanobot&type=Date" style="border-radius: 15px; box-shadow: 0 0 30px rgba(0, 217, 255, 0.3);" />
</picture>
</a>
</div>
<p align="center">
<em> Thanks for visiting โจ nanobot!</em><br><br>
<img src="https://visitor-badge.laobi.icu/badge?page_id=HKUDS.nanobot&style=for-the-badge&color=00d4ff" alt="Views">
</p>Instalasi
Pasang skill dari https://github.com/HKUDS/nanobotSkill ini belum dipublikasikan di registri ClawHub. Tempel prompt ke coding agent Anda โ Claude Code, Cursor, Codex โ dan skill-nya akan dipasang langsung dari repositori sumbernya.
Buka repositori