⚠ 原项目（Official Upstream）：
AstrBotDevs/AstrBot当前仓库：
astrbot-miaoyimiao（基于原项目二次开发，非官方主仓）。
- 🧠 长期记忆（LTM）系统：新增
MemoryEvent/MemoryItem/Evidence数据模型、读写策略、维护策略，以及 Dashboard 管理 API 与可视化页面。 - 🗂️ 项目上下文（Project Context）索引：支持源码符号检索、依赖追踪、架构摘要，以及语义索引构建与检索能力。
- 结构化解析：
Python(.py/.pyi)、JS/TS/Vue(.js/.jsx/.ts/.tsx/.vue)、Markdown/RST(.md/.rst)。 - 依赖追踪：支持 Python 本地导入与 JS/TS/Vue 本地导入（含相对路径、
@/、~/、/根路径写法）。 - 路径范围：扫描根目录由索引构建参数决定，默认排除
.git、node_modules、dist、build、venv等目录。 - 范围查询：Dashboard 新增
GET /api/project_context/scope，可查看当前支持后缀、排除规则与已索引路径样本。
- 结构化解析：
- 🛠️ 工程运维（Engineering Ops）中心：集成后台任务观测、工具演进策略预览/应用、编码韧性（resilience）指标与事件快照。
- 🔁 运行时韧性增强：增加工具循环重试、LLM 失败恢复、流式降级与上下文超限防护策略。
- 🧩 工作流编辑与部署：新增 Workflow 路由与前端页面，支持工作流保存、测试、多模态输入，以及部署为可用 Provider。
- 🔌 专业工具预设与后台任务工具：补充 MCP 专业预设与后台任务状态/列表/取消工具，提升可观测与闭环执行能力。
- 🖼️ Linux Desktop 截图发送可靠性增强：本地 Python 工具新增
IMAGE_DATA/ASTRBOT_IMAGE_OUTPUT解析，避免“模型误判已发图”；同时补充截图发送闭环约束（必须收到send_message_to_user成功回执后才宣称已发送）。
差异基线：
git diff upstream/master..master（当前分支对AstrBotDevs/AstrBot官方主线）。
- 2026-02-28：已合并
upstream/master（截至881b409e），并保留本 fork 的冲突文件定制逻辑（agent runner / tool exec / live chat / 相关测试）。
本仓库新增了长期记忆关系图谱视图，便于从“关系结构”而不是“表格记录”视角审查记忆状态。
- 入口：
Dashboard -> Long-term Memory -> 记忆图谱 - 交互能力：
- 支持按
scope / scope_id / status / predicate / min_confidence / max_relations筛选 - 支持节点与边点击联动，查看关系详情（subject/predicate/object、置信度、状态、关联 memory_id 等）
- 支持谓词图例与关系密度概览，快速定位热点关系
- 支持按
- 数据来源：
/api/ltm/relations（图谱展示的是关系层memory_relations，不是memory_items表格本身） - 使用说明：
- 图谱默认主要观察
active关系；若当前只有shadow记忆，图谱可能为空 - 关系写入依赖候选事实被激活并同步为 relation；因此历史数据可能需要后续补聊或回填流程才能完全可视化
- 图谱默认主要观察
AstrBot is an open-source all-in-one Agent chatbot platform that integrates with mainstream instant messaging apps. It provides reliable and scalable conversational AI infrastructure for individuals, developers, and teams. Whether you're building a personal AI companion, intelligent customer service, automation assistant, or enterprise knowledge base, AstrBot enables you to quickly build production-ready AI applications within your IM platform workflows.
- 💯 Free & Open Source.
- ✨ AI LLM Conversations, Multimodal, Agent, MCP, Skills, Knowledge Base, Persona Settings, Auto Context Compression.
- 🤖 Supports integration with Dify, Alibaba Cloud Bailian, Coze, and other agent platforms.
- 🌐 Multi-Platform: QQ, WeChat Work, Feishu, DingTalk, WeChat Official Accounts, Telegram, Slack, and more.
- 📦 Plugin Extensions with 1000+ plugins available for one-click installation.
- 🛡️ Agent Sandbox for isolated, safe execution of code, shell calls, and session-level resource reuse.
- 💻 WebUI Support.
- 🌈 Web ChatUI Support with built-in agent sandbox and web search.
- 🌐 Internationalization (i18n) Support.
| 💙 Role-playing & Emotional Companionship | ✨ Proactive Agent | 🚀 General Agentic Capabilities | 🧩 1000+ Community Plugins |
|---|---|---|---|
|
|
|
|
uv tool install astrbot
astrbotRequires uv to be installed.
We recommend deploying AstrBot using Docker / Docker Compose.
Please refer to the official documentation: Deploy AstrBot with Docker.
AstrBot has been officially listed on RainYun's cloud application platform with one-click deployment.
Desktop repository: AstrBot-desktop.
Supports multiple system architectures, direct package installation, and out-of-the-box usage. A convenient one-click desktop deployment option for beginners.
A quick deployment and multi-instance solution with environment isolation. Visit the AstrBot Launcher repository and install the package for your OS from the latest release.
Community-contributed deployment method.
yay -S astrbot-gitMore deployment methods: BT-Panel Deployment | 1Panel Deployment | CasaOS Deployment | Manual Deployment
Connect AstrBot to your favorite chat platform.
| Platform | Maintainer |
|---|---|
| Official | |
| OneBot v11 protocol implementation | Official |
| Telegram | Official |
| Wecom & Wecom AI Bot | Official |
| WeChat Official Accounts | Official |
| Feishu (Lark) | Official |
| DingTalk | Official |
| Slack | Official |
| Discord | Official |
| LINE | Official |
| Satori | Official |
| Misskey | Official |
| WhatsApp (Coming Soon) | Official |
| Matrix | Community |
| KOOK | Community |
| VoceChat | Community |
| Service | Type |
|---|---|
| OpenAI and Compatible Services | LLM Services |
| Anthropic | LLM Services |
| Google Gemini | LLM Services |
| Moonshot AI | LLM Services |
| Zhipu AI | LLM Services |
| DeepSeek | LLM Services |
| Ollama (Self-hosted) | LLM Services |
| LM Studio (Self-hosted) | LLM Services |
| CompShare | LLM Services |
| 302.AI | LLM Services |
| TokenPony | LLM Services |
| SiliconFlow | LLM Services |
| PPIO Cloud | LLM Services |
| ModelScope | LLM Services |
| OneAPI | LLM Services |
| Dify | LLMOps Platforms |
| Alibaba Cloud Bailian Applications | LLMOps Platforms |
| Coze | LLMOps Platforms |
| OpenAI Whisper | Speech-to-Text Services |
| SenseVoice | Speech-to-Text Services |
| OpenAI TTS | Text-to-Speech Services |
| Gemini TTS | Text-to-Speech Services |
| GPT-Sovits-Inference | Text-to-Speech Services |
| GPT-Sovits | Text-to-Speech Services |
| FishAudio | Text-to-Speech Services |
| Edge TTS | Text-to-Speech Services |
| Alibaba Cloud Bailian TTS | Text-to-Speech Services |
| Azure TTS | Text-to-Speech Services |
| Minimax TTS | Text-to-Speech Services |
| Volcano Engine TTS | Text-to-Speech Services |
Issues and Pull Requests are always welcome! Feel free to submit your changes to this project :)
You can contribute by reviewing issues or helping with pull request reviews. Any issues or PRs are welcome to encourage community participation. Of course, these are just suggestions—you can contribute in any way you like. For adding new features, please discuss through an Issue first.
AstrBot uses ruff for code formatting and linting.
git clone https://github.com/AstrBotDevs/AstrBot
pip install pre-commit
pre-commit install- Group 1: 322154837
- Group 3: 630166526
- Group 5: 822130018
- Group 6: 753075035
- Group 7: 743746109
- Group 8: 1030353265
- Developer Group: 975206796
Special thanks to all Contributors and plugin developers for their contributions to AstrBot ❤️
Additionally, the birth of this project would not have been possible without the help of the following open-source projects:
- NapNeko/NapCatQQ - The amazing cat framework
Tip
If this project has helped you in your life or work, or if you're interested in its future development, please give the project a Star. It's the driving force behind maintaining this open-source project <3
Companionship and capability should never be at odds. What we aim to create is a robot that can understand emotions, provide genuine companionship, and reliably accomplish tasks.
私は、高性能ですから!
