memi-agent
v1.3.0
Published
本地 AI 助手 — 终端 + 网页双模式,65+ 工具(含浏览器自动化、向量记忆搜索),80+ 模型商,4 个消息渠道,ClawHub 兼容,Docker 支持
Downloads
2,572
Readme
Memi 是一个运行在你本机的个人 AI 助手。它在终端里跟你聊天,在网页上给你看板,还打通了 Telegram / 飞书 / 企业微信 / QQ —— 所有渠道共享同一个会话和记忆。
支持 80+ AI 模型商(DeepSeek / OpenAI / Anthropic / 通义千问 / Moonshot / 智谱 …),自带 60+ 工具,兼容 ClawHub 技能生态。
快速开始
# 全局安装
npm install -g memi-agent
memi onboard
# 或者一行搞定(无需安装)
npx memi-agent onboard
# macOS / Linux 一键脚本
curl -fsSL https://raw.githubusercontent.com/memi-ai/memi/main/install.sh | bash
# Windows PowerShell 一键脚本
irm https://raw.githubusercontent.com/memi-ai/memi/main/install.ps1 | iexmemi onboard 会引导你完成模型配置、工作区初始化、渠道接入,macOS / Linux / Windows 都支持。
启动后:
memi chat # 终端对话
memi dashboard # 打开网页控制台 → http://localhost:3001/dashboard
memi status # 查看当前状态亮点
- 双界面 — 终端 CLI + 网页 Dashboard,同一个后端,无缝切换。
- 多渠道收件箱 — Telegram、飞书/Lark、企业微信、QQ,消息统一路由到 Agent 处理。
- 60+ 工具 — 文件读写、命令执行、网络搜索、图片生成、HTTP 请求、系统信息、向量记忆搜索、浏览器自动化、网页抓取、定时提醒……
- ClawHub 兼容 — 直接安装 OpenClaw 社区的 Skill,
clawhub install即装即用。 - 多 Agent 协作 —
@agent语法切换/协作,每个 Agent 可以有独立的 system prompt 和模型。 - 12 步新手引导 — 交互式 onboard,配模型、装守护进程、接渠道,一条龙。
- 系统守护进程 — schtasks (Windows) / launchd (macOS) / systemd (Linux) 一键安装,开机自启。
- 网关安全 —
MEMI_GATEWAY_TOKEN鉴权,DM 白名单,避免未授权访问。 - 工作区文档 — SOUL.md / MEMORY.md / USER.md / IDENTITY.md / TOOLS.md 每日注入 system prompt,保持记忆连续性。
- 语音对话 — Dashboard 点击 🎤 说话,Agent 用 TTS 朗读回复。基于 OpenAI Whisper + TTS。
- 安全审批 — 危险操作(命令执行/文件删除)前弹窗确认,安全可控。
- MCP 协议 — 接入 Model Context Protocol 生态,连接外部 MCP Server,工具无限扩展。
- 插件系统 —
memi-config/plugins/自定义工具和中间件,扩展无限。 - 长期记忆 — 自动对话摘要、跨会话记忆检索、知识库拖拽上传 PDF/TXT/MD。
- 定时任务 —
memi cron add设置定时触发,Agent 自动执行。 - 浏览器自动化 — Agent 可操控真实浏览器,打开网页、点击、截图。基于 Playwright。
- Docker 沙箱 — Agent 命令在容器中执行,网络隔离、内存限制、进程限制,安全可靠。
- 中英双语 — Dashboard 一键切换,CLI 运行
memi lang en全英文。 - PWA 可安装 — Dashboard 可安装到手机/电脑桌面,像原生 App 一样使用。
- 图片管道 — 文生图 → 视觉审查 → 自动重试,直到满意。
- 会话管理 — 保存/加载/重命名会话,支持
/stats统计 Token 用量和费用。 - 80+ 模型商 — 兼容 OpenAI API 格式的所有提供商,一键切换。
渠道支持
| 渠道 | 接入方式 | 配置命令 |
|---|---|---|
| Telegram | Webhook | memi telegram <token> |
| 飞书 / Lark | Webhook + WebSocket 长连接 | memi feishu <token> |
| 企业微信 | Webhook | memi wecom <key> |
| QQ | Webhook (go-cqhttp) | memi qq <token> |
| Discord | Interactions Endpoint | memi discord <token> |
| Slack | Events API | memi slack <token> |
| 钉钉 | Outgoing Webhook | memi dingtalk <token> |
所有渠道共享同一个 Agent 会话,在 Dashboard 里可以实时看到每条消息和工具调用。
安全提示:对外暴露前务必设置
MEMI_GATEWAY_TOKEN环境变量,并配置渠道白名单。
命令参考
CLI 命令
| 命令 | 说明 |
|---|---|
| memi chat | 进入交互对话 |
| memi onboard | 12 步新手引导(模型/守护/渠道) |
| memi dashboard | 打开网页控制台 |
| memi status | 查看模型、端点、会话数、技能数 |
| memi skills | 列出已安装技能 |
| memi sessions | 列出所有会话 |
| memi doctor | 系统诊断(Node 版本、API 连通性、服务状态) |
| memi agent | 显示当前 Agent 信息 |
| memi config | 查看配置;memi config edit 重新配置 |
| memi update | 检查 GitHub Release 更新 |
| memi server start | 启动后端服务 |
| memi voice | 语音对话模式 |
| memi mcp add <name> <cmd> | 接入 MCP Server |
| memi browser install | 安装 Playwright + Chromium |
| memi sandbox enable | 启用 Docker 沙箱 |
| memi rag index | 索引工作区文档为向量库 |
| memi rag search <query> | 语义搜索工作区记忆 |
| memi memory summary | 生成对话记忆摘要 |
| memi memory upload <file> | 上传知识库文档 |
| memi cron add "<expr>" "<任务>" | 添加定时任务 |
| memi plugin list | 列出已安装插件 |
| memi lang en | 切换为英文 |
| memi daemon install | 安装系统守护进程(开机自启) |
| memi version | 显示版本号 |
对话内斜杠命令
| 命令 | 说明 |
|---|---|
| /help | 帮助信息 |
| /history | 查看对话历史 |
| /sessions | 会话列表 |
| /new | 新建会话 |
| /load <name> | 加载会话 |
| /save | 保存当前会话 |
| /rename <name> | 重命名会话 |
| /tools | 工具调用记录 |
| /stats | Token 用量与费用估算 |
| /balance | API 余额查询 |
| /think off\|low\|medium\|high\|max | 思考强度 |
| /currency | 切换币种 (¥/$) |
| /clear | 清空当前会话 |
| /agent list\|use\|add | 多 Agent 管理 |
| /exit | 退出对话 |
配置
最小配置(memi-config/config.json):
{
endpoint: "https://api.deepseek.com/v1",
apiKey: "sk-...",
model: "deepseek-chat",
port: 3001
}memi onboard 会交互式生成完整配置,包括渠道 Token、技能目录、工作区路径等。
ClawHub 技能
Memi 兼容 ClawHub 技能生态:
npm install -g clawhub
clawhub install weather # 安装天气技能
memi skills # 自动识别并加载也可以在对话中用 /import_skill <url> 从 GitHub 直接导入。
工作区文档
这些文件放在 memi-config/workspace/,每天自动注入 Agent 的 system prompt,并支持向量搜索:
| 文件 | 作用 |
|---|---|
| SOUL.md | Agent 人格定义 |
| MEMORY.md | 长期记忆 |
| USER.md | 用户偏好 |
| IDENTITY.md | 身份设定 |
| TOOLS.md | 工具使用说明 |
Agent 可通过 rag_search 工具随时检索这些文档,无需占用每次对话的上下文窗口。
从源码运行
git clone https://github.com/memi-ai/memi.git
cd memi
npm install --prefix memi-server
# 启动后端
npm start --prefix memi-server
# 新开终端,启动 CLI
node memi-agent.js chatDocker
# 克隆仓库
git clone https://github.com/memi-ai/memi.git
cd memi
# 一键启动
docker compose up -d
# 或者单独构建
docker build -t memi-agent .
docker run -d -p 3001:3001 -v memi-config:/app/memi-config memi-agent访问 http://localhost:3001/dashboard。
技术栈
| 层 | 技术 |
|---|---|
| CLI | Node.js (CommonJS) |
| 后端 | Express + WebSocket |
| 前端 | React (memi-client) + 原生 HTML Dashboard |
| AI 协议 | OpenAI-compatible /v1/chat/completions |
| 沙箱 | Docker 容器隔离 |
| 定时 | Cron 调度器 + Agent 自动触发 |
| 国际化 | 中英双语 (Dashboard + CLI) |
| PWA | Service Worker + manifest.json |
| 浏览器 | Playwright (Chromium) — 可选,按需安装 |
| 图片 | pollinations.ai + 视觉审查循环 |
| 平台 | Windows / macOS / Linux |
Star History
社区
- Issues & PR: github.com/memi-ai/memi
- AI/vibe-coded PRs welcome! 🤖
- 📧 联系邮箱: [email protected]
- 本项目使用deepseek-V4pro开发,框架为reaonix
- memiAI的即刻:https://web.okjike.com/u/6cb55457-5724-4410-bb26-7315d537c9f8
- memiAI的掘金:https://juejin.cn/user/903124233517066
MIT © 2025 Memi
