diff --git a/README.md b/README.md
index db54ad16..b6255670 100644
--- a/README.md
+++ b/README.md
@@ -24,9 +24,7 @@
-
-
-Memoh is a AI agent system platform. Users can create their own AI bots and chat with them via Telegram, Discord, Lark(Feishu), etc. Every bot has independent container and memory system which allows them to edit files, execute commands and build themselves - Like [OpenClaw](https://openclaw.ai), Memoh provides a more secure, flexible and scalable solution for multi-bot management.
+Memoh is an always-on, containerized AI agent system. Create multiple AI bots, each running in its own isolated container with persistent memory, and interact with them across Telegram, Discord, Lark (Feishu), or the built-in Web/CLI. Bots can execute commands, edit files, browse the web, call external tools via MCP, and remember everything — like giving each bot its own computer and brain.
## Quick Start
@@ -54,28 +52,73 @@ See [DEPLOYMENT.md](DEPLOYMENT.md) for custom configuration and production setup
## Why Memoh?
-OpenClaw, Clawdbot, and Moltbot are impressive, but they have notable drawbacks: stability issues, security concerns, cumbersome configuration, and high token costs. If you're looking for a stable, secure Bot SaaS solution, consider our open-source Memoh.
+OpenClaw is impressive, but it has notable drawbacks: stability issues, security concerns, cumbersome configuration, and high token costs. If you're looking for a stable, secure solution, consider Memoh.
Memoh is a multi-bot agent service built with Golang. It offers full graphical configuration for bots, Channels, MCP, and Skills. We use Containerd to provide container-level isolation for each bot and draw heavily from OpenClaw's Agent design.
-Memoh Bot features a deeply engineered memory layer inspired by Mem0. By storing knowledge from each conversation turn, it enables more precise memory retrieval.
-
Memoh Bot can distinguish and remember requests from multiple humans and bots, working seamlessly in any group chat. You can use Memoh to build bot teams, or set up accounts for family members to manage daily household tasks with bots.
## Features
-- **Multi-bot Management**: Create multiple bots; humans and bots, or bots with each other, can chat privately, in groups, or collaborate.
-- **Containerized**: Each bot runs in its own isolated container. Bots can freely execute commands, edit files, and access the network within their containers—like having their own computer.
-- **Memory Engineering**: Every chat is stored in the database, with the last 24 hours of context loaded by default. Each conversation turn is stored as memory and can be retrieved by bots through semantic search.
-- **Various Platforms**: Supports Telegram, Lark (Feishu), and more.
-- **Simple and Easy to Use**: Configure bots and settings for Provider, Model, Memory, Channel, MCP, and Skills through a graphical interface—no coding required to set up your own AI bot.
-- **Scheduled Tasks**: Schedule tasks with cron expressions to run commands at specified times.
-- More...
+
+- 🤖 **Multi-Bot Management**: Create multiple bots; humans and bots, or bots with each other, can chat privately, in groups, or collaborate. Supports role-based access control (owner / admin / member) with ownership transfer.
+- 👥 **Multi-User & Identity Recognition**: Bots can distinguish individual users in group chats, remember each person's context separately, and send direct messages to specific users. Cross-platform identity binding unifies the same person across Telegram, Discord, Lark, and Web.
+- 📦 **Containerized**: Each bot runs in its own isolated containerd container. Bots can freely execute commands, edit files, and access the network within their containers — like having their own computer. Supports container snapshots for save/restore.
+- 🧠 **Memory Engineering**: Hybrid retrieval (dense vector search + BM25 keyword search) with LLM-driven fact extraction. Last 24 hours of context loaded by default, with memory compaction and rebuild capabilities.
+- 💬 **Multi-Platform**: Supports Telegram, Discord, Lark (Feishu), and built-in Web/CLI. Unified message format with rich text, media attachments, reactions, and streaming across all platforms. Cross-platform identity binding.
+- 🔧 **MCP (Model Context Protocol)**: Full MCP support (HTTP / SSE / Stdio). Built-in tools for container operations, memory search, web search, scheduling, messaging, and more. Connect external MCP servers for extensibility.
+- 🧩 **Subagents**: Create specialized sub-agents per bot with independent context and skills, enabling multi-agent collaboration.
+- 🎭 **Skills & Identity**: Define bot personality via IDENTITY.md, SOUL.md, and modular skill files that bots can enable/disable at runtime.
+- 🔍 **Web Search**: Configurable search providers (Brave Search, etc.) for web search and URL content fetching.
+- ⏰ **Scheduled Tasks**: Cron-based scheduling with max-call limits. Bots can autonomously run commands or tools at specified intervals.
+- 📥 **Inbox**: Cross-channel inbox — messages from other channels are queued and surfaced in the system prompt so the bot never misses context.
+- 🧪 **Multi-Model**: Works with any OpenAI-compatible, Anthropic, or Google Generative AI provider. Per-bot model assignment for chat, memory, and embedding.
+- 🖥️ **Web UI**: Modern dashboard (Vue 3 + Tailwind CSS) with real-time streaming chat, tool call visualization, container filesystem browser, and visual configuration for all settings. Dark/light theme, i18n.
+- 🚀 **One-Click Deploy**: Docker Compose with automatic migration, containerd setup, and CNI networking. Interactive install script included.
+
+## Tech Stack
+
+| Layer | Stack |
+|-------|-------|
+| Backend | Go, Echo, sqlc, Uber FX, pgx/v5, containerd v2 |
+| Agent Gateway | Bun, Elysia |
+| Frontend | Vue 3, Vite, Pinia, Tailwind CSS, Reka UI |
+| Storage | PostgreSQL, Qdrant |
+| Infra | Docker, containerd, CNI |
+| Tooling | mise, pnpm, swaggo, sqlc |
+
+## Architecture
+
+```
+┌─────────────┐ ┌─────────────────┐ ┌──────────────┐
+│ Channels │ │ Web UI │ │ CLI │
+│ (TG/DC/FS) │ │ (Vue 3 :8082) │ │ │
+└──────┬───────┘ └────────┬────────┘ └──────┬───────┘
+ │ │ │
+ ▼ ▼ ▼
+┌──────────────────────────────────────────────────────────┐
+│ Server (Go :8080) │
+│ Auth · Bots · Channels · Memory · Containers · MCP │
+└──────────────────────┬───────────────────────────────────┘
+ │
+ ┌───────────┼───────────┐
+ ▼ ▼ ▼
+ ┌──────────┐ ┌─────────┐ ┌──────────────────┐
+ │ PostgreSQL│ │ Qdrant │ │ Agent Gateway │
+ │ │ │ (Vector)│ │ (Bun/Elysia :8081)│
+ └──────────┘ └─────────┘ └────────┬──────────┘
+ │
+ ┌───────┼───────┐
+ ▼ ▼ ▼
+ ┌─────┐ ┌─────┐ ┌─────┐
+ │Bot A│ │Bot B│ │Bot C│ ← containerd
+ └─────┘ └─────┘ └─────┘
+```
## Roadmap
-Please refer to the [Roadmap Version 0.1](https://github.com/memohai/Memoh/issues/2) for more details.
+Please refer to the [Roadmap](https://github.com/memohai/Memoh/issues/86) for more details.
-### Development
+## Development
Refer to [CONTRIBUTING.md](CONTRIBUTING.md) for development setup.
diff --git a/README_CN.md b/README_CN.md
index 6f3035f0..957692b7 100644
--- a/README_CN.md
+++ b/README_CN.md
@@ -24,7 +24,7 @@
-Memoh 是一个 AI Agent 系统平台。用户可通过 Telegram、Discord、飞书(Lark) 等创建自己的 AI 机器人并与之对话。每个 bot 拥有独立的容器与记忆系统,可编辑文件、执行命令并自我构建——与 [OpenClaw](https://openclaw.ai) 类似,Memoh 为多 bot 管理提供更安全、灵活、可扩展的解决方案。
+Memoh 是一个常驻运行的容器化 AI Agent 系统。你可以创建多个 AI 机器人,每个机器人运行在独立的容器中,拥有持久化记忆,并通过 Telegram、Discord、飞书(Lark) 或内置的 Web/CLI 与之交互。机器人可以执行命令、编辑文件、浏览网页、通过 MCP 调用外部工具,并记住一切 —— 就像给每个 Bot 一台自己的电脑和大脑。
## 快速开始
@@ -56,24 +56,69 @@ OpenClaw、Clawdbot、Moltbot 固然出色,但在稳定性、安全性、配
Memoh 是基于 Golang 的多 bot agent 服务,提供 bot、Channel、MCP、Skills 等的完整图形化配置。我们使用 Containerd 为每个 bot 提供容器级隔离,并大量借鉴 OpenClaw 的 Agent 设计。
-Memoh Bot 具备深度工程化的记忆层,灵感来自 Mem0:对每轮对话进行知识存储,实现更精准的记忆检索。
-
Memoh Bot 能区分并记忆多人与多 bot 的请求,在任意群聊中无缝协作。你可以用 Memoh 组建 bot 团队,或为家人配置账号,用 bot 管理日常家务。
## 特性
-- **多 Bot 管理**:创建多个 bot;人与 bot、bot 与 bot 可私聊、群聊或协作。
-- **容器化**:每个 bot 运行在独立容器中,可在容器内自由执行命令、编辑文件、访问网络,宛如各自拥有一台电脑。
-- **记忆工程**:每次对话存入数据库,默认加载最近 24 小时上下文;每轮对话会存储为记忆,供 bot 通过语义检索召回。
-- **多平台**:支持 Telegram、飞书(Lark) 等。
-- **简单易用**:通过图形界面配置 Provider、Model、Memory、Channel、MCP、Skills 等,无需编码即可搭建自己的 AI 机器人。
-- **定时任务**:使用 cron 表达式在指定时间执行命令。
-- 更多…
+
+- 🤖 **多 Bot 管理**:创建多个 bot;人与 bot、bot 与 bot 可私聊、群聊或协作。支持角色权限控制(owner / admin / member)与所有权转让。
+- 👥 **多用户与身份识别**:Bot 可在群聊中区分不同用户,分别记忆每个人的上下文,并支持向特定用户单独发送消息。跨平台身份绑定将同一用户在 Telegram、Discord、飞书、Web 上的身份统一关联。
+- 📦 **容器化**:每个 bot 运行在独立的 containerd 容器中,可在容器内自由执行命令、编辑文件、访问网络,宛如各自拥有一台电脑。支持容器快照保存与恢复。
+- 🧠 **记忆工程**:混合检索(稠密向量搜索 + BM25 关键词搜索),LLM 驱动的知识抽取。默认加载最近 24 小时上下文,支持记忆压缩与重建。
+- 💬 **多平台**:支持 Telegram、Discord、飞书(Lark) 及内置 Web/CLI。跨平台统一消息格式,支持富文本、媒体附件、表情回应和流式输出。跨平台身份绑定。
+- 🔧 **MCP(模型上下文协议)**:完整 MCP 支持(HTTP / SSE / Stdio)。内置容器操作、记忆搜索、网络搜索、定时任务、消息发送等工具,可连接外部 MCP 服务器扩展。
+- 🧩 **子代理**:为每个 bot 创建专用子代理,拥有独立上下文与技能,实现多代理协作。
+- 🎭 **技能与身份**:通过 IDENTITY.md、SOUL.md 定义 bot 人格,模块化技能文件可在运行时启用/禁用。
+- 🔍 **网络搜索**:可配置搜索提供商(Brave Search 等),支持网页搜索与 URL 内容抓取。
+- ⏰ **定时任务**:基于 Cron 的任务调度,支持最大调用次数限制。Bot 可自主在指定时间执行命令或工具。
+- 📥 **收件箱**:跨渠道收件箱,其他渠道的消息会排入收件箱并呈现在系统提示词中,确保 bot 不遗漏上下文。
+- 🧪 **多模型**:兼容任何 OpenAI 兼容、Anthropic 或 Google Generative AI 提供商。每个 bot 可独立配置聊天、记忆和嵌入模型。
+- 🖥️ **Web 管理界面**:基于 Vue 3 + Tailwind CSS 的现代面板,实时流式聊天、工具调用可视化、容器文件浏览器,所有配置可视化操作。深色/浅色主题,中英文支持。
+- 🚀 **一键部署**:Docker Compose 编排,自动迁移、containerd 初始化与网络配置,一条命令启动全栈。附带交互式安装脚本。
+
+## 技术栈
+
+| 层级 | 技术 |
+|------|------|
+| 后端 | Go, Echo, sqlc, Uber FX, pgx/v5, containerd v2 |
+| Agent 网关 | Bun, Elysia |
+| 前端 | Vue 3, Vite, Pinia, Tailwind CSS, Reka UI |
+| 存储 | PostgreSQL, Qdrant |
+| 基础设施 | Docker, containerd, CNI |
+| 工具链 | mise, pnpm, swaggo, sqlc |
+
+## 架构
+
+```
+┌─────────────┐ ┌─────────────────┐ ┌──────────────┐
+│ Channels │ │ Web UI │ │ CLI │
+│ (TG/DC/FS) │ │ (Vue 3 :8082) │ │ │
+└──────┬───────┘ └────────┬────────┘ └──────┬───────┘
+ │ │ │
+ ▼ ▼ ▼
+┌──────────────────────────────────────────────────────────┐
+│ Server (Go :8080) │
+│ Auth · Bots · Channels · Memory · Containers · MCP │
+└──────────────────────┬───────────────────────────────────┘
+ │
+ ┌───────────┼───────────┐
+ ▼ ▼ ▼
+ ┌──────────┐ ┌─────────┐ ┌──────────────────┐
+ │ PostgreSQL│ │ Qdrant │ │ Agent Gateway │
+ │ │ │ (向量库) │ │ (Bun/Elysia :8081)│
+ └──────────┘ └─────────┘ └────────┬──────────┘
+ │
+ ┌───────┼───────┐
+ ▼ ▼ ▼
+ ┌─────┐ ┌─────┐ ┌─────┐
+ │Bot A│ │Bot B│ │Bot C│ ← containerd
+ └─────┘ └─────┘ └─────┘
+```
## 路线图
-详见 [Roadmap Version 0.1](https://github.com/memohai/Memoh/issues/2)。
+详见 [Roadmap Version 0.1.0](https://github.com/memohai/Memoh/issues/86)。
-### 开发
+## 开发
开发环境配置请参阅 [CONTRIBUTING.md](CONTRIBUTING.md)。