Memmy
开始使用

入门指南

本页带你从零完成 Memmy 的安装、首次配置和第一轮对话。

你需要准备

  • macOS 或 Windows 桌面环境（桌面端路径）。
  • 或 Node.js >=22 + npm（CLI / 源码路径）。
  • API Key 模式需要至少一个模型 Provider 的 API Key。

不确定选哪种模式？账号模式开箱即用并附带平台体验 Token；API Key 模式的数据与额度完全由你掌控。两种模式的数据都以本地优先方式保存。

快速设置

下载并安装 Memmy 桌面应用。首次启动会自动完成：

  1. 设置 MEMMY_HOME 和 MEMMY_CONFIG。
  2. 安装内置 CLI 与 Agent skills。
  3. 准备 ~/.memmy/config.yaml、workspace 和 Memory SQLite。
  4. 启动 Memory 服务和 Agent gateway。
cd App/memmy-agent
npm install
npm run build
node dist/main.js --help

在欢迎页选择：

  • 账号模式：手机号或邮箱验证码登录，使用平台体验 Token。
  • API Key 模式：分三步配置主模型 + Embedding、记忆相关模型、可选的 ASR 与图像生成模型，每一步都提供真实连接测试。
memmy onboard          # 初始化配置和 workspace
memmy onboard --wizard # 终端菜单式配置模型、Provider、工具
memmy status           # 检查配置与运行状态

进入主工作台，在输入框发送第一条消息。Enter 发送，Shift + Enter 换行，输入 / 可打开 Slash command 面板。

memmy agent --message "你好，介绍一下当前工作区"
# 或直接进入交互式聊天
memmy

打开「记忆管理 → 来源」，扫描 Cursor、Claude Code、Codex、Opencode、OpenClaw、Hermes 的历史对话并入库。首次引导时也会弹出扫描权限选择：不扫描 / 仅扫描 / 扫描并写入 Skill。

打开「工具」页：

  • 消息渠道：Telegram、Discord、iMessage、WeChat、Feishu、DingTalk。
  • 托管集成：GitHub、Gmail、Notion、Slack、Linear、Jira 等，走 OAuth 授权。

高级：把 Memmy 当本地 API 用

memmy serve

默认监听 http://127.0.0.1:18990，提供 GET /health、GET /v1/models、POST /v1/chat/completions，可被任何支持 OpenAI Chat Completions 协议的工具复用。

高级：环境变量

变量作用
MEMMY_HOMEMemmy 数据主目录（默认 ~/.memmy）
MEMMY_CONFIG主配置文件路径（默认 ~/.memmy/config.yaml）
MEMMY_MEMORY_TOKEN / MEMORY_SERVICE_TOKENMemory HTTP 服务的 bearer token

配置文件中的 ${ENV_NAME} 会被自动解析，避免把 API Key 写死在配置里。

接下来做什么

会话、附件、语音与 Slash command扫描与 Skill 安装三步配置详解常驻桌面的轻量入口

相关内容

Memmy

主工作台

本页目录

你需要准备快速设置高级：把 Memmy 当本地 API 用高级：环境变量接下来做什么相关内容