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 提供一個自架設、基於檔案的知識儲存，並透過 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 同伴、並能即時生成微型自訂應用的使用者設計。