Skip to content

Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.

docs: add AstrBot plugin to agent integrations (#2211)

t0saki415eaa0692df
diff --git a/docs/en/agent-integrations/01-overview.md b/docs/en/agent-integrations/01-overview.md
index 63d0ada41..95909b879 100644
--- a/docs/en/agent-integrations/01-overview.md
+++ b/docs/en/agent-integrations/01-overview.md
@@ -10,6 +10,7 @@ OpenViking can act as the long-term memory and context backend for many agent ru
| **OpenClaw** | [OpenClaw Plugin](./03-openclaw.md) — context-engine + hooks + tools + runtime manager, deep lifecycle integration |
| **Codex** | [Codex Memory Plugin](./04-codex.md) — lifecycle hooks for auto-recall, incremental capture, and pre-compact commit |
| **LangChain / LangGraph** | [LangChain and LangGraph](./06-langchain-langgraph.md) — session context backend, chat history, retriever, `viking_*` tools, LangGraph store, and middleware for agent workflows |
+| **AstrBot** (QQ / Telegram / Discord and other IMs) | [Other community plugins](./05-other-plugins.md#astrbot-plugin) — auto-capture group chats, semantic recall, configurable venue memory isolation |
| **OpenCode** | [Other community plugins](./05-other-plugins.md) — explicit-tool and context-injection variants |
| **Cursor / Trae / Manus / Claude Desktop / ChatGPT / …** | [MCP Integration Guide](../guides/06-mcp-integration.md) — point any MCP-compatible client at the built-in `/mcp` endpoint |
| **Hermes Agent (Nous Research)** | [Hermes — OpenViking memory provider](https://hermes-agent.nousresearch.com/docs/user-guide/features/memory-providers#openviking) — first-class OpenViking memory provider, no plugin install needed |
@@ -19,7 +20,7 @@ OpenViking can act as the long-term memory and context backend for many agent ru
Some integrations go beyond what a generic MCP client can do:
- **Generic MCP clients** call OpenViking on demand through tools the model decides to invoke. Setup is one config snippet.
-- **Hooks-based plugins** (Claude Code, Codex, OpenClaw) drive recall and capture from runtime lifecycle events — every prompt, every turn, session start/end, compact, subagent spawn. The model doesn't need to "remember to recall."
+- **Hooks-based plugins** (Claude Code, Codex, OpenClaw, AstrBot) drive recall and capture from runtime lifecycle events — every prompt, every turn, session start/end, compact, subagent spawn. The model doesn't need to "remember to recall."
- **SDK integrations** (LangChain/LangGraph) wire OpenViking into framework-native abstractions such as retrievers, tools, chat history, stores, and middleware.
For agents whose runtime exposes hooks, middleware, or a context-engine slot, the native integration path is usually the better default.
diff --git a/docs/en/agent-integrations/05-other-plugins.md b/docs/en/agent-integrations/05-other-plugins.md
index 942e785bd..049f01e0f 100644
--- a/docs/en/agent-integrations/05-other-plugins.md
+++ b/docs/en/agent-integrations/05-other-plugins.md
@@ -2,6 +2,23 @@
The repo also ships several community/experimental plugins beyond the headline Claude Code, Codex, and OpenClaw integrations. They differ in target runtime, integration depth, and maintenance status — read each one's README before adopting.
+## AstrBot plugin
+
+[AstrBot](https://github.com/AstrBotDevs/AstrBot) is a multi-platform IM bot framework supporting QQ (AIOCQHTTP), Telegram, Discord, Lark, and 20+ other platforms.
+
+Source: [astrbot_plugin_openviking_memory](https://github.com/t0saki/astrbot_plugin_openviking_memory)
+
+Provides OpenViking long-term memory for AstrBot: auto-captures group/DM conversations, performs semantic recall before each LLM request, and supports configurable venue memory isolation.
+
+**Installation**: In AstrBot WebUI, search **OpenViking Memory** in the Plugin Marketplace; or install from URL: `https://github.com/t0saki/astrbot_plugin_openviking_memory.git`
+
+**Key features**:
+
+- Hooks-based auto-recall and auto-capture — the model doesn't need to invoke tools explicitly
+- Three isolation modes: `venue_user` (per-group/DM), `venue_user_fanout` (cross-venue sharing), `global_user` (single user)
+- Four auto-commit triggers: message count, token threshold, idle timeout, and process-exit flush
+- Backfills platform message history on first venue encounter
+
## OpenCode plugins
Two OpenCode plugin variants exist with different design choices. Pick whichever matches your usage — we don't make the decision for you.
diff --git a/docs/zh/agent-integrations/01-overview.md b/docs/zh/agent-integrations/01-overview.md
index 0f579501f..360e88e28 100644
--- a/docs/zh/agent-integrations/01-overview.md
+++ b/docs/zh/agent-integrations/01-overview.md
@@ -10,6 +10,7 @@ OpenViking 可以作为多种 Agent 运行时的长期记忆与上下文后端
| **OpenClaw** | [OpenClaw 插件](./03-openclaw.md) — context-engine + hooks + tools + 运行时管理一体化集成,覆盖完整生命周期 |
| **Codex** | [Codex 记忆插件](./04-codex.md) — 生命周期 hooks 自动召回、增量捕获、compaction 前 commit |
| **LangChain / LangGraph** | [LangChain 和 LangGraph](./06-langchain-langgraph.md) — session context backend、chat history、retriever、`viking_*` tools、LangGraph store 和 workflow middleware |
+| **AstrBot**(QQ / Telegram / Discord 等 IM) | [其他社区插件](./05-other-plugins.md#astrbot-插件) — 自动捕获群聊对话、语义召回、可配置的 venue 记忆隔离 |
| **OpenCode** | [其他社区插件](./05-other-plugins.md) — 显式工具版本与上下文注入版本 |
| **Cursor / Trae / Manus / Claude Desktop / ChatGPT / …** | [MCP 集成指南](../guides/06-mcp-integration.md) — 任何兼容 MCP 的客户端都可直接对接内置 `/mcp` 端点 |
| **Hermes Agent (Nous Research)** | [Hermes — OpenViking 记忆提供方](https://hermes-agent.nousresearch.com/docs/user-guide/features/memory-providers#openviking) — 一等公民支持,无需额外安装插件 |
@@ -19,7 +20,7 @@ OpenViking 可以作为多种 Agent 运行时的长期记忆与上下文后端
部分集成能力超过通用 MCP 客户端:
- **通用 MCP 客户端**:模型主动调用工具时按需访问 OpenViking。配置只需一份连接片段。
-- **基于 hooks 的插件**(Claude Code、Codex、OpenClaw):在运行时生命周期事件(每次 prompt、每轮结束、session 起止、compact、subagent 派生等)中驱动召回与捕获。模型不需要"记得调用"。
+- **基于 hooks 的插件**(Claude Code、Codex、OpenClaw、AstrBot):在运行时生命周期事件(每次 prompt、每轮结束、session 起止、compact、subagent 派生等)中驱动召回与捕获。模型不需要"记得调用"。
- **SDK 集成**(LangChain/LangGraph):把 OpenViking 接入框架原生抽象,例如 retriever、tools、chat history、store 和 middleware。
如果你的 Agent runtime 暴露 hooks、middleware 或 context-engine 槽位,原生集成通常是更好的默认选择。
diff --git a/docs/zh/agent-integrations/05-other-plugins.md b/docs/zh/agent-integrations/05-other-plugins.md
index 130d96c34..210140d20 100644
--- a/docs/zh/agent-integrations/05-other-plugins.md
+++ b/docs/zh/agent-integrations/05-other-plugins.md
@@ -2,6 +2,23 @@
仓库里还附带了几个未在 Claude Code、Codex 和 OpenClaw 主集成中介绍的社区/实验性插件。它们在目标 runtime、集成深度和维护状态上各有差异,使用前请先阅读各自的 README。
+## AstrBot 插件
+
+[AstrBot](https://github.com/AstrBotDevs/AstrBot) 是一个多平台 IM Bot 框架,支持 QQ(AIOCQHTTP)、Telegram、Discord、飞书等 20+ 平台。
+
+源码:[astrbot_plugin_openviking_memory](https://github.com/t0saki/astrbot_plugin_openviking_memory)
+
+为 AstrBot 提供 OpenViking 长期记忆能力:自动捕获群聊/私聊对话,LLM 请求前语义召回相关记忆,支持三档 venue 记忆隔离。
+
+**安装**:在 AstrBot WebUI → 插件市场搜索 **OpenViking Memory** 并安装;或从链接安装:`https://github.com/t0saki/astrbot_plugin_openviking_memory.git`
+
+**主要特性**:
+
+- 基于 hooks 的自动召回与捕获,模型不需要主动调用工具
+- 三档隔离模式:`venue_user`(群/私聊各自独立)、`venue_user_fanout`(跨群共享)、`global_user`(全局共享)
+- 四触发器自动 commit:消息计数、token 阈值、空闲超时、进程退出 flush
+- 首次接入群聊时自动拉取平台历史消息入库
+
## OpenCode 插件
OpenCode 有两个设计路径不同的插件变体。请按你的使用方式自行选择,我们不替你决定。