From 37aed5445d0867c9d84f99161eac129bfe3d116e Mon Sep 17 00:00:00 2001
From: meichuanyi <35057768+meichuanyi@users.noreply.github.com>
Date: Thu, 21 May 2026 23:12:00 +0800
Subject: [PATCH] docs: Add FAQ section for common questions

---
 README.md | 43 +++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 41 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 214f5ec69d..41d7862e33 100644
--- a/README.md
+++ b/README.md
@@ -12,7 +12,7 @@
 <br>
 
 <div>
-<a href="https://trendshift.io/repositories/12875" target="_blank"><img src="https://trendshift.io/api/badge/repositories/12875" alt="Soulter%2FAstrBot | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
+<a href="https://trendshift.io/repositories/21369" target="_blank"><img src="https://trendshift.io/api/badge/repositories/21369" alt="AstrBotDevs%2FAstrBot | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
 <a href="https://hellogithub.com/repository/AstrBotDevs/AstrBot" target="_blank"><img src="https://api.hellogithub.com/v1/widgets/recommend.svg?rid=d127d50cd5e54c5382328acc3bb25483&claim_uid=ZO9by7qCXgSd6Lp&t=2" alt="Featured｜HelloGitHub" style="width: 250px; height: 54px;" width="250" height="54" /></a>
 </div>
 
@@ -258,7 +258,7 @@ pre-commit install
 Special thanks to all Contributors and plugin developers for their contributions to AstrBot ❤️
 
 <a href="https://github.com/AstrBotDevs/AstrBot/graphs/contributors">
-  <img src="https://contrib.rocks/image?repo=AstrBotDevs/AstrBot&max=200&columns=14" />
+  <img src="https://contrib.rocks/image?repo=AstrBotDevs/AstrBot&max=300&columns=15" />
 </a>
 
 Additionally, the birth of this project would not have been possible without the help of the following open-source projects:
@@ -284,3 +284,42 @@ _私は、高性能ですから!_
 
 <img src="https://files.astrbot.app/watashiwa-koseino-desukara.gif" width="100"/>
 </div>
+
+## FAQ (Frequently Asked Questions)
+
+### What is AstrBot?
+
+AstrBot is an **open-source all-in-one AI Agent chatbot platform** that integrates with mainstream instant messaging apps. It provides reliable and scalable conversational AI infrastructure for individuals, developers, and teams.
+
+### Key Features
+
+| Feature | Description |
+|---------|-------------|
+| 🆓 Free & Open Source | MIT-licensed, community-driven |
+| 🤖 AI Conversations | LLM, multimodal, Agent, MCP, Skills, Knowledge Base |
+| 🌐 Multi-Platform | QQ, WeChat Work, Feishu, DingTalk, Telegram, Slack |
+| 📦 1000+ Plugins | One-click installation |
+| 🛡️ Agent Sandbox | Safe code execution |
+| 💻 WebUI & ChatUI | Web interfaces |
+
+### Getting Started
+
+```bash
+uv tool install astrbot --python 3.12
+astrbot init
+astrbot run
+```
+
+### LLM Providers
+
+OpenAI, Anthropic, Google Gemini, DeepSeek, Alibaba Cloud Bailian, Moonshot, MiniMax, StepFun, Ollama, vLLM.
+
+### License
+
+MIT License.
+
+### Help Resources
+
+- [Documentation](https://astrbot.app/)
+- [Blog](https://blog.astrbot.app/)
+- [Issues](https://github.com/AstrBotDevs/AstrBot/issues)