Skip to content
Back to search

CountBot

更适配中文用户的轻量开源AI Agent | 国产大模型Coding plan支持 | 兼容OpenClaw Skills生态| 已接入微信ClawBot/微博龙虾/飞书/钉钉/QQ/小智AI/Telegram/deepseek-v4。

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/countbot-ai/CountBot with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/countbot-ai/CountBot'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/countbot-ai--countbot/badge.svg)](/listings/countbot-ai--countbot)

HTML

<a href="/listings/countbot-ai--countbot"><img src="/api/listings/countbot-ai--countbot/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 191 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <div align="center">
  2. <h1>CountBot</h1>
  3. <p><strong>A lightweight multi-tenant AI Agent for your server</strong></p>
  4. <p>One runtime for isolated tenants. Switch between Agent execution and plain conversation to balance capability and cost.</p>
  5. <p>
  6. <a href="README_ZH.md">中文</a> | English
  7. </p>
  8. <p>
  9. <a href="https://github.com/countbot-ai/countbot/stargazers"><img src="https://img.shields.io/github/stars/countbot-ai/countbot?style=social" alt="GitHub stars"></a>
  10. <a href="https://github.com/countbot-ai/countbot"><img src="https://img.shields.io/badge/version-1.1.0-2f6feb.svg" alt="Version"></a>
  11. <a href="https://github.com/countbot-ai/countbot"><img src="https://img.shields.io/badge/Python-3.8+-blue.svg" alt="Python"></a>
  12. <a href="https://github.com/countbot-ai/countbot"><img src="https://img.shields.io/badge/Node-18+-339933.svg" alt="Node"></a>
  13. <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License"></a>
  14. </p>
  15. </div>
  16. ---
  17. ## What Is CountBot
  18. CountBot is a privately deployable, long-running AI Agent runtime. It connects IM channels, tool execution, scheduled tasks and a multi-tenant permission system. You can send requests through Lark, WeCom, WeChat, QQ and other platforms, or use the web interface directly.
  19. It is designed for multi-user scenarios: one server hosts multiple isolated tenants, each with its own workspace, sessions, memory, model configuration and quota. Agent and chat modes can be switched per task to control context size and token cost.
  20. > Shared host resources, isolated tenant data. Use Agent for execution, chat mode for plain conversation.
  21. ---
  22. ## What's New in 1.1.0
  23. 1. **DeepSeek native integration**
  24. DeepSeek is the default provider, using the official Anthropic Messages endpoint. Web search, URL reading, PDF/Office attachment parsing, ASR, TTS and safety checks are connected to the request pipeline.
  25. 2. **Multi-user multi-tenant**
  26. Each regular user has an isolated workspace, sessions, memory, skills and runtime. Administrators can assign shared models per user and restrict the models and modes available to a specific user. Keys are not sent to the frontend, and key operations are recorded in the audit log. Users can also configure their own providers and API keys.
  27. 3. **Agent / chat dual mode**
  28. A multi-agent engineering setup relies on preloaded context, tool definitions and execution rules to give the model complex-task execution ability; this capability chain is necessary for automation. Not every conversation needs that engineering context. Carrying a large preloaded text set into simple Q&A, rewriting or requirement alignment creates unnecessary token overhead. CountBot offers two modes that switch seamlessly within a session: Agent mode loads the full set of tools, skills, teams and execution rules for complex tasks; chat mode trims context and removes tool definitions for Q&A, rewriting, translation, brainstorming and casual chat. Local token estimation is supported, and administrators can restrict the modes available to each user.
  29. 4. **Rebuilt frontend workspace**
  30. Chat, settings, admin, scheduler, skills, MCP, Wiki, teams, memory and tools are split into modules. The composer groups model selection, reasoning level, mode switch, attachments and speech actions.
  31. 5. **Security and quota governance**
  32. Workspace path restrictions, command guard, outbound URL SSRF validation, key isolation, shared-model daily limits, session serialization, usage statistics and audit logs.
  33. ---
  34. ## Core Capabilities
  35. - **Multi-tenant governance**: separate administrator and regular-user roles. Each tenant has an isolated workspace, session history, long-term memory, skill configuration and model configuration. Administrators can assign shared models, set daily call limits, review usage and audit entries.
  36. - **Agent / chat dual mode**: Agent mode enables tool calls, skills, team collaboration and workflow orchestration; chat mode does not inject tool definitions or execution rules, reducing context cost for lightweight Q&A.
  37. - **DeepSeek native capabilities**: DeepSeek is the default API provider with web search, URL reading, document parsing, speech-to-text, text-to-speech and safety checks. Attachments are cached by content hash. Multiple providers and three request protocols are supported, with multi-key rotation and failure cooldown.
  38. - **IM channels**: Web, Lark, WeCom, WeChat, QQ, DingTalk, Telegram, Weibo, XiaoZhi and ServerChan can be managed from one system.
  39. - **Tools and extensions**: file read, write, edit, directory listing, web fetching, command execution and screenshots (when optional dependencies are available) can be enabled and combined as needed; the Agent can mix them flexibly in a task. MCP, Wiki knowledge base, skills and external coding agents are also supported.
  40. ---
  41. ## Quick Start
  42. ### From source
  43. ```bash
  44. git clone https://github.com/countbot-ai/countbot.git
  45. cd CountBot
  46. python -m venv .venv
  47. source .venv/bin/activate # Windows: .venv\Scripts\activate
  48. pip install -r requirements.txt
  49. python start_app.py
  50. ```
  51. Open `http://127.0.0.1:8000` and follow the first-run guide to set the administrator password. The remote setup entry has an expiry; adjust it with `REMOTE_SETUP_SECRET_TTL_MINUTES` (10–120 minutes, default 30).
  52. Host and port can be overridden with environment variables:
  53. ```bash
  54. # Linux / macOS
  55. COUNTBOT_HOST=0.0.0.0 COUNTBOT_PORT=8000 python start_app.py
  56. ```
  57. ```powershell
  58. # Windows PowerShell
  59. $env:COUNTBOT_HOST = '0.0.0.0'
  60. $env:COUNTBOT_PORT = '8001'
  61. python start_app.py
  62. ```
  63. For networks with slow PyPI access:
  64. ```bash
  65. pip install -r requirements.txt -i https://mirrors.aliyun.com/pypi/simple/
  66. ```
  67. If GitHub access is restricted, use the Gitee mirror:
  68. ```bash
  69. git clone https://gitee.com/countbot-ai/CountBot.git
  70. ```
  71. ### Desktop build
  72. Windows, macOS and Linux builds are available for download:
  73. - [GitHub Releases](https://github.com/countbot-ai/countbot/releases)
  74. - [Gitee Releases](https://gitee.com/countbot-ai/CountBot/releases)
  75. ### Server deployment
  76. CountBot is a standard web service and can be hosted with `systemd`, `supervisor` or containers. Complete administrator initialization before exposing remote access, then configure a reverse proxy and HTTPS.
  77. ---
  78. ## Supported Channels
  79. | Channel | Direction | Notes |
  80. | --- | --- | --- |
  81. | Lark | Both ways | Event subscription, group and private chats |
  82. | WeCom | Both ways | Enterprise bot |
  83. | WeChat | Both ways | Multiple account bindings |
  84. | QQ | Both ways | QQ Open Platform bot |
  85. | DingTalk | Both ways | Internal enterprise bot |
  86. | Telegram | Both ways | Direct Bot API |
  87. | Weibo | Both ways | Weibo bot |
  88. | XiaoZhi AI | Both ways | XiaoZhi AI hardware integration |
  89. | ServerChan | Push only | Single HTTP notification |
  90. ---
  91. ## Documentation and Community
  92. - [Documentation](https://countbot.cn/docs)
  93. - [Issue feedback](https://github.com/countbot-ai/countbot/issues)
  94. ---
  95. ## Development and Contributions
  96. ```bash
  97. # Backend local development
  98. uvicorn backend.app:app --reload --host 0.0.0.0 --port 8000
  99. # Frontend local development
  100. cd frontend
  101. npm install
  102. npm run dev
  103. # Frontend type-check and build
  104. npm run type-check
  105. npm run build
  106. # Backend tests
  107. python -m pytest -q tests
  108. ```
  109. The frontend requires Node.js 18+ and npm 9+.
  110. Issues, bug fixes, capability extensions and documentation improvements are welcome.
  111. ---
  112. ## License and Acknowledgements
  113. ### License
  114. MIT License
  115. ### Inspiration
  116. - OpenClaw
  117. - NanoBot
  118. - ZeroClaw
  119. - anthropics/skills
  120. ### Technical thanks
  121. Thanks to the open-source projects behind FastAPI, Vue.js, SQLAlchemy and Pydantic.
  122. ---
  123. <div align="center">
  124. <p>Shared host, isolated tenants. Run Agent when execution is needed; switch to chat mode to reduce cost.</p>
  125. <p>
  126. <a href="https://countbot.cn">Website</a> ·
  127. <a href="https://github.com/countbot-ai/countbot">GitHub</a> ·
  128. <a href="https://gitee.com/countbot-ai/CountBot">Gitee</a> ·
  129. <a href="https://countbot.cn/docs">Documentation</a>
  130. </p>
  131. </div>

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.