receptron/mulmoclaude

Nurture your own AI assistant on your own computer. Local-first and MIT: memories, data and apps stay as plain files in your workspace. Chat summons the right GUI — wiki, spreadsheet, chart, form, 3D. Build small apps for an audience of one, no programming required.

MulmoClaude – 本地运行的AI原生个人助手平台

是什么 – MulmoClaude 是一个开源应用，允许你在自己的电脑上运行基于 Claude 的 AI 助手。助手存在于一个 工作区（磁盘上的普通文件）中，存储个人维基、数据集合、自动化任务和 Claude 可按需为你生成的微型自定义应用。所有 AI 驱动的逻辑均在本地（或 Docker 容器沙箱内）运行，永远不会离开你的设备。

为何重要 – 个人助手的价值在于其积累的关于你的知识，而不仅仅是语言模型。MulmoClaude 提供一个自托管、基于文件的知识存储，以及一个 UI，让你可以通过 Web 聊天或数十种消息桥接器与 Claude 交互，让 Claude 跨插件（维基、会计、信息流、图像生成等）协作。

快速入门（一行命令）

npx mulmoclaude@latest   # 启动服务器并打开 http://localhost:3001

保持终端打开，或使用 npx mulmoclaude@latest create-shortcut 创建桌面快捷方式。

核心组件

组件	作用
服务器	Node.js 20+ 进程，托管 UI、REST API 和 socket.io 桥接。
Claude Code CLI	后端大模型；提供工具调用、Bash 访问和技能执行。
Docker 沙箱（可选）	在容器内运行 Claude，仅暴露工作区和 Claude 配置。
插件 / 注册表	内置功能，如个人维基、会计系统、SEC 文件阅读器、数据流等。
角色	预设人格（通用、办公、向导 & 计划师、艺术家、导师、故事讲述者），可切换工具面板以实现更快、更专注的响应。
桥接器	独立的 npm 包（`@mulmobridge/*`），通过 socket.io 连接 Telegram、Slack、Discord、WhatsApp、邮件、短信等。
技能	可复用的 Claude Code 技能文件夹（`~/.claude/skills/…`），可在 UI 中一键列出并执行。

可以做什么（示例提示）

“写一份项目提案” → 丰富的 Markdown 文档。
“绘制上季度的收入图表” → 交互式 ECharts 图表。
“为京都旅行制定计划” → 带图片的图文指南。
“设置一个待办事项列表” → 基于模式驱动集合的看板板。
“导入这篇文章：<URL>” → 带永久 [[链接]] 的维基页面。
“生成一张日落的图片” → Gemini 3.1 Flash 图像生成（需 Gemini API 密钥）。
“订阅这个 RSS 流” → 数据流存储在 /feeds 下，并按计划刷新。

所有这些功能均可通过专用页面（/wiki、/feeds、/collections、/automations、/files 等）访问，每个页面都有自己的聊天编辑器，可自动提供相关上下文。

安装与前置条件

要求	获取方式
Node.js 20+	从 nodejs.org 下载。
Claude Code CLI	`npm i -g @anthropic/claude-code`（或参考 README 链接）安装，并运行一次 `claude` 完成 OAuth。
ffmpeg（可选，用于视频生成）	`brew install ffmpeg` / `apt install ffmpeg` / `winget install Gyan.FFmpeg`。
Docker Desktop（推荐）	从 docker.com 安装 – 自动启用沙箱模式。
Gemini API 密钥（可选，用于图像生成）	在 Google AI Studio 创建，并将 `GEMINI_API_KEY=…` 添加到 `.env`。
whisper.cpp（仅 macOS，可选）	用于本地语音输入。

安装前置条件后，运行上述一行命令，或克隆仓库用于开发：

git clone https://github.com/receptron/mulmoclaude.git
cd mulmoclaude && yarn install
cp .env.example .env   # 如需图像生成，请添加 GEMINI_API_KEY
yarn dev               # UI 访问地址：http://localhost:5173

安全模型

Claude Code 拥有完整的 Bash 访问权限；未使用 Docker 时，可读写你用户可访问的任何文件（包括 SSH 密钥）。使用 Docker 沙箱可将其限制在工作区和 ~/.claude 配置目录内。
Bearer 令牌认证 保护所有 /api/* 端点；令牌在服务器启动时生成，并通过 <meta> 标签注入浏览器。
凭证转发 通过 SANDBOX_SSH_AGENT_FORWARD 和 SANDBOX_MOUNT_CONFIGS 选择性启用。
文件日志 – 可读的控制台日志 + 每日轮转的 JSON 日志，存储于 server/system/logs/。

生态系统与可扩展性

桥接包（@mulmobridge/*）可将助手暴露给任何你使用的聊天平台。它们作为子进程运行，并在服务器重启后自动重新连接。
技能 – 任何包含 SKILL.md 的 ~/.claude/skills/ 下的文件夹均可被 UI 发现、列出并一键执行。项目级技能位于工作区中，会覆盖同名的用户级技能。
插件 – 通过遵循开发者文档，可扩展平台注册表，添加更多原生插件（如更多会计工具、自定义数据解析器）。

许可证与社区

许可证：MIT（参见 LICENSE）。
更新与公告 – 由项目所有者 Satoshi Nakajima 和“Singularity Society”账号（日语）在 X（原 Twitter）发布。仓库包含 CI 指示灯、星标数和 MANIFEST.md，解释底层的“AI 原生应用”哲学。

简而言之： MulmoClaude 提供一个自托管、可扩展的 AI 助手，将所有记忆以普通文件形式存储，可通过 Web UI 或你偏好的任何消息工具与之对话，并通过可选的 Docker 沙箱模式确保你的数据完全受控。它不是一个单一用途的聊天机器人，而是一个全栈平台，专为希望拥有隐私优先的个人 AI 同伴、并能即时生成微型自定义应用的用户设计。