中文 | English

DotBot

DotBot (.Bot) is a lightweight OpenClaw written in C# that is secure, reliable, and ready to use out of the box.

✨ Features

🪶 Lightweight & Minimal Written in C#，built on .NET 10, single-file, no complex dependencies.

🚀 One-Click Deployment No complicated configuration process required.

🔒 Secure Approval Multi-layer security with approval flow for high-risk operations.

• 🛠️ Tool Capabilities: File read/write (workspace-scoped), controlled Shell commands, Web scraping, optional SubAgent delegation
• 🔌 MCP Integration: Connect external tool services via Model Context Protocol
• 🎮 Multiple Runtime Modes: Local REPL, QQ Bot (OneBot V11), WeCom Bot, API Service (OpenAI-compatible), Gateway multi-channel concurrent mode
• 📊 Dashboard: Built-in Web UI for real-time monitoring of token usage, session history, and tool call traces
• 🧩 Skills System: Dynamically load Skills from workspace
• 📢 Notification Push: WeCom group bot and Webhook notifications

QQ bot mode

CLI mode

In API mode, you can use ChatBox to communicate with DotBot

Dashboard monitors usage and session history

🚀 Quick Start

Prerequisites

• .NET 10 SDK (only required for building)
• Supported LLM API Key (OpenAI-compatible format)

Build & Install

# Build the Release package
build.bat

# Configure the path to environment variables (optional)
cd Release/DotBot
powershell -File install_to_path.ps1

Configuration

DotBot uses a two-level configuration: Global config (~/.bot/appsettings.json) and Workspace config (<workspace>/.bot/appsettings.json).

For first-time use, create the global config file:

{
    "ApiKey": "sk-your-api-key",
    "Model": "gpt-4o-mini",
    "EndPoint": "https://api.openai.com/v1"
}

💡 Storing API Key in global config prevents it from leaking into workspace Git repositories.

Launch

# Enter the workspace
cd Workspace

# Start DotBot (CLI mode)
dotbot

Runtime Modes

Mode	Enable Condition	Usage
CLI Mode	Default	Local REPL interaction
API Mode	Api.Enabled = true	OpenAI-compatible HTTP service
QQ Bot	QQBot.Enabled = true	OneBot V11 protocol bot
WeCom Bot	WeComBot.Enabled = true	WeChat Work bot

📚 Documentation

Document	Description
Configuration Guide	Tools, security, blacklists, approval, MCP, Gateway
API Mode Guide	OpenAI-compatible API, tool filtering, SDK examples
QQ Bot Guide	NapCat / permissions / approval
WeCom Guide	WeCom push notifications / bot mode
DashBoard Guide	Built-in Web debugging UI, Trace data viewer
Documentation Index	Full documentation navigation

🙏 Credits

Inspired by nanobot and built on the Microsoft Agent Framework, this project utilized multiple AI tools to complete all development work for the first release version within two weeks.

Google Nano Banana Pro generated the project's logo.

Thanks to Devin AI for providing free ACU credits to facilitate development.

• HKUDS/nanobot
• microsoft/agent-framework
• NapNeko/NapCatQQ
• spectreconsole/spectre.console
• modelcontextprotocol/csharp-sdk

📄 License

Apache License 2.0