Memoh

✨ 一个自托管、常驻运行的容器化 AI Agent 平台。你可以创建多个具备长短期记忆的机器人，并将它们连接到 Telegram、Discord、飞书 (Lark)、Matrix 等平台（类似 OpenClaw）。

[English] | [简体中文]

---

Memoh 是一个常驻运行的容器化 AI Agent 系统。你可以创建多个 AI 机器人，每个机器人都在各自隔离的容器中运行，拥有持久化记忆。你可以通过 Telegram、Discord、飞书 (Lark)、QQ、Matrix、企业微信、微信、邮件或内置的 Web UI 与它们交互。机器人可以执行命令、编辑文件、浏览网页、通过 MCP 调用外部工具，并记住一切——就像为每个机器人配备了独立的计算机和大脑一样。

快速开始

一键安装（需要安装 Docker）：

curl -fsSL https://memoh.sh | sudo sh

静默安装（使用默认配置）：curl -fsSL ... | sudo sh -s -- -y

或手动安装：

git clone --depth 1 https://github.com/memohai/Memoh.git
cd Memoh
cp conf/app.docker.toml config.toml
# 编辑 config.toml
sudo docker compose up -d

安装特定版本：

curl -fsSL https://memoh.sh | sudo MEMOH_VERSION=v0.6.0 sh

使用国内镜像加速镜像下载：

curl -fsSL https://memoh.sh | sudo USE_CN_MIRROR=true sh

如果是在 macOS 上或你的用户已加入 docker 用户组，则无需使用 sudo。

启动后请访问 http://localhost:8080。默认登录信息：admin / admin123

有关自定义配置和生产环境部署，请参阅 DEPLOYMENT.md。

为什么选择 Memoh？

Memoh 专为**持续在线（Always-on）**而生——让 AI 保持在线，让记忆完全属于你。

• 轻量且快速：基于 Go 构建，作为家庭/工作室基础设施，在边缘设备上也能高效运行。
• 默认容器化：每个机器人都在一个隔离的容器中运行，拥有独立的文件系统、网络和工具。
• 混合部署模式：利用云端推理能力获得最强模型效果，同时通过本地优先的存储和索引保障隐私。
• 多用户优先：在不同用户和机器人之间提供明确的共享权限与隐私边界。
• 全图形化配置：无需编程，通过现代化的 Web UI 即可配置机器人、通信渠道、MCP、技能及所有设置。

功能特性

核心功能

• 🤖 多机器人与多用户：创建多个机器人，支持私聊、群聊或机器人间对话。机器人在群聊中能区分不同用户，记住每个人的上下文，并支持跨平台身份绑定。
• 📦 容器化部署：每个机器人都在其独立的 containerd 容器中运行，拥有专用的文件系统和网络，如同拥有一台独立的计算机。支持快照、数据导入/导出及版本控制。
• 🧠 记忆工程：基于 LLM 的事实提取、混合检索（稠密向量 + 稀疏向量 + BM25）、24 小时上下文加载、记忆压缩与重构。支持插件化后端：内置存储（Off/Sparse/Dense）、Mem0、OpenViking。
• 💬 9 种通信渠道：支持 Telegram、Discord、飞书 (Lark)、QQ、Matrix、企业微信、微信、邮件 (Mailgun / SMTP / Gmail OAuth) 以及内置 Web UI，提供统一的流式传输、富文本和附件支持。

Agent 能力

• 🔧 MCP (Model Context Protocol)：全面支持 MCP (HTTP / SSE / Stdio / OAuth)。可连接外部工具服务器以实现无限扩展；每个机器人独立管理其 MCP 连接。
• 🌐 浏览器自动化：通过 Playwright 实现无头 Chromium/Firefox 控制——执行导航、点击、表单填写、截图、读取辅助功能树、管理标签页等操作。
• 🎭 技能与子 Agent：通过模块化技能文件定义机器人人格；可将复杂任务委托给拥有独立上下文的子 Agent。
• ⏰ 自动化：支持基于 Cron 的定时任务和周期性心跳检测，实现机器人的自主活动。

管理功能

• 🖥️ Web UI：现代化仪表盘（Vue 3 + Tailwind CSS）——提供流式对话、工具调用可视化、文件管理器以及全功能的可视化配置界面。支持深色/浅色主题及国际化 (i18n)。
• 🔐 访问控制：基于优先级的 ACL（访问控制列表）规则，支持允许/拒绝策略，范围可限定为通信渠道身份、渠道类型或特定对话。
• 🧪 多模型支持：支持任何 OpenAI 兼容的 API、Anthropic 或 Google 模型。支持按机器人分配模型、提供商 OAuth 及自动模型导入。
• 🚀 一键部署：通过 Docker Compose 实现自动迁移、containerd 设置和 CNI 网络配置。

记忆系统

Memoh 的记忆系统围绕 Memory Providers（记忆提供商） 构建——即插件化的后端，用于控制机器人如何存储、检索和管理长期记忆。

提供商	描述
内置 (Built-in)	自托管，随 Memoh 附带。支持三种模式：Off（基于文件，无向量搜索）、Sparse（通过本地模型进行神经稀疏向量搜索，无 API 成本）、Dense（通过 Qdrant 进行基于 Embedding 的语义搜索）。
Mem0	通过 Mem0 API 提供 SaaS 记忆服务。
OpenViking	自托管或 SaaS 记忆服务，拥有独立的 API。

每个机器人绑定一个提供商。在对话过程中，机器人会自动提取关键信息。