🔧 开源框架

nanoMuse 快速入门:先在一台设备跑通,再连接你的其他设备

开源个人智能体,手机、桌面与网页通过可自托管 relay 连接,同账号设备可接续任务;提供 shell、浏览器、MCP、Hands 和可读记忆,具体能力受平台、模型和权限限制。

📅 收录: 2026-11-18 🔄 更新: 2026-11-18

nanoMuse 快速入门

nanoMuse 是开源个人智能体项目,不只是一个聊天窗口。 手机端、桌面端、网页控制台与 relay 中继都在同一个仓库里;各设备运行自己的 agent,再按账号互相连接。 官方提供 shell、浏览器、MCP 与技能,打开 Hands 后可操作支持平台的屏幕。 它还提供记忆、定时目标和例行任务,但设备运行、联网和模型服务仍是前提。

核验日期:2026-11-18。 本文基于官方文档和公开资料整理,AI辅助生成,MagicNetWorld 尚未完成独立实测。 本文没有安装客户端、登录演示、连接设备或验证 Sentinel 拦截效果。

这是什么?适合谁?

  • 希望手机发起任务、电脑接续执行,并保留同一组对话的个人用户。
  • 愿意理解模型能力、文件权限和数据同步区别的进阶用户。
  • 希望自行运行 relay,而不是只依赖公共托管服务的开发者。
  • 不适合期待所有平台都能自动操作屏幕,或者期待关机后本地任务继续执行的人。

项目采用 GPL-3.0-or-later,Android 线基于 OpenMinis 1.13。 它是独立社区项目,不能因为名字相近就当成 Meta Muse 的官方版本。

准备工作

  1. 先选一台设备,不要第一次就同时配置手机、电脑和自建中继。
  2. Windows 需要 10+ x64,macOS 需要 12+ 并选对 Apple Silicon/Intel 包,Linux 提供 x64 包。
  3. Android 安装包要求 8.0+ arm64;iPhone/iPad 走 TestFlight 测试渠道。
  4. 准备一个无敏感内容的任务目录,只挂载练习文件。
  5. 选择社区 relay 的起始额度,或自己已有的模型 key/兼容订阅。

官方说社区 relay 提供免费起始用量,具体可用额度以账号界面当时显示为准。 自己的模型 key、订阅和自托管主机各有成本,不等于免费无限调用。

官方下载与安装

核验时官网与 GitHub latest release 都指向 1.0.9「Tiller」。 从官网首页下载区选择你的系统,再打开对应发行文件。 如果 GitHub 下载慢,可使用官网列出的同版本镜像目录。 不要把猜测的 /download 地址当成下载入口;本站核验时该地址返回 404。

Windows 官方安装包链接可直接复制到浏览器:

https://github.com/nano-muse/nanoMuse/releases/download/v1.0.9/nanoMuse-Desktop-1.0.9-win-x64.exe

Android 对应文件是:

https://github.com/nano-muse/nanoMuse/releases/download/v1.0.9/nanoMuse-1.0.9-arm64.apk

安装前对照发行页版本与校验文件;本文未下载二进制,也未验证其哈希。 官方说明桌面包存在无证书/未公证提示,Windows 可能弹 SmartScreen,macOS 需要手动允许打开。 这不是安全认证:先核对来源与校验值,并遵守所在组织的软件安装政策;不要为了安装关闭整机防护。

启动后可选示例任务、连接模型或先跳过配置。 登录 nanoMuse Cloud 可连接账号设备;若只用自己的 key 运行本机任务,官方也提供不依赖社区账号的路径。

模型启用:四个能力分开选

在 Settings → Models 查看四行:Chat、Operating the screen、Making pictures、Making clips。 网页控制台则在 Connections 中配置。

  • Chat 是对话模型;能聊天不代表能看截图。
  • Operating the screen 需要有视觉输入能力的模型,iPhone 上该行不可用。
  • Making pictures 面向形象与图片生成,不由所有聊天提供商覆盖。
  • Making clips 需要已接入的视频能力,不能用「支持视频模型」推断任意供应商都兼容。

自己的 key 只填进对应设置表单,不发送到聊天、截图或反馈 issue。 保存 key 后核对各能力实际选中了哪个 provider/model,不要只看提供商名称。

首个任务:整理三份练习笔记

在独立练习目录放三份无隐私的文本笔记,授权它访问该目录。 下面是建议任务,不是官方命令,也不是已跑通的案例:

只读取我指定的三份练习笔记,不联网、不安装软件、不删除文件。
按文件名整理标题与待办,输出一个新的 summary.md,保留原文件。
遇到读不了的文件写出原因,不要补造内容。
完成后列出读取的路径、输出路径与需要我确认的事项。

首轮可先要求只返回计划,确认范围后再允许写新文件。 如果出现权限卡,检查具体操作、目标目录和许可持续范围,不要习惯性选永久允许。

成功判定由你实际检查:

  • 原三份笔记未被改动,新增文件只在授权目录内。
  • 汇总中的标题与待办能逐条回到原文件。
  • 失败项被明确列出,没有被「任务完成」掩盖。
  • 客户端显示的模型、用量与本次任务相符。

收到流畅回复不等于执行成功;输出文件与来源对应才是验收对象。

初级用法

1. 把模型与操作能力分开排查

先做只读文本任务,确认 Chat 配置能返回内容。 随后才测试 Hands 的截图识别与动作,不要把模型鉴权失败误认成桌面权限问题。 先选非敏感窗口,避免把密码管理器或私人消息暴露给视觉模型。

2. 管理可读的记忆

官方把身份、偏好与唤醒安排放在可读写的 Markdown 文件中。 先检查它记住了什么,再决定保留哪些长期信息;不要把临时测试指令写成永久偏好。 记忆功能不意味着内容永远只在本地,模型请求仍可能包含相关上下文。

3. 用小范围审批代替长期全开放

Sentinel 是官方描述的工具调用把关层,发送、删除与付款有不同的确认规则。 从单次许可开始,在 Settings → Permissions → Remembered approvals 检查并撤销不再需要的授权。 官方说明部分软件安装可以先执行再告知,因此不能理解为「所有副作用都会先问」。

高级玩法

1. Reach:让另一台在线设备接任务

先让两台设备登录同一 relay 的同一账号,在 Devices 确认目标设备在线。 官方示例用消息开头的 @Mac … 把任务交给相应设备;实际名称以设备列表为准。 先让对方列出测试目录的文件,再尝试修改文件,不要第一条远程任务就操作重要软件。 审批回到手边设备并不代表远端已完成,仍要检查远端产物。

2. Hands:屏幕操作的独立验收

桌面 Hands 用截图和动作工具连接屏幕,macOS 等平台还需相应系统权限。 用一个允许操作的练习窗口测试「看到了什么→准备做什么→动作后的画面」三步。 iOS 不提供本机屏幕自动操作,不能用 Android 或桌面端演示推断 iPhone 也能完成。

3. 自建 relay 与模型 key 是两件事

自己的模型 key 改变推理提供商,不会自动更换账号 relay。 自建 relay 需要独立部署、HTTPS、账号和维护;原公共 relay 的账号不会自动变成新服务的账号。 官方源码入口是完整仓库,初学者不必先部署服务器才能用客户端。

官方 README 给出的自建 relay 本地入口如下,仅供具备 Docker/服务运维知识的人继续阅读:

git clone https://github.com/nano-muse/nanoMuse.git
cd nanoMuse
bash scripts/self-host.sh --local

该脚本会改变运行环境,本文没有执行;运行前应完整阅读 self-hosting 文档,不要在生产服务器上直接试。

具体功能学习:把设备、模型与数据路径拆开

先学 Chat 和 Operating the screen 的能力差异,再学 Hands 与 Reach 的执行位置差异。 最后查看 Data controls:同步、执行记录和训练许可并非同一个开关。 用自己的 key 只能说明推理请求改走该提供商,不能推出已登录 relay 不保存对话。

官方隐私说明写明:登录后会话同步默认开启;新账号的社区模型改进开关也可能默认开启,需在界面确认。 同步文字、执行记录与提供商收到的请求内容各有不同范围,敏感任务前逐项读清。 如果目标是全部本地处理,需要连模型端点、设备通信、MCP 和外部网站一起评估,不能只部署 relay 就宣称离线。

五个具体踩坑

1. 找到了下载页却下错架构

症状:安装包无法运行,或 Mac 上安装失败。 原因:Windows/Linux x64、Mac arm64/x64、Android arm64 不能互换。 解决:回官网按系统和架构选同版本包,并对照校验文件,不从陌生镜像找替代品。

2. 旧桌面版卡在 Starting

症状:已登录的 1.0.8 一直启动中。 原因:1.0.9 发布说明记录了旧版本启动阶段的等待问题。 解决:按官方发布说明退出并覆盖安装 1.0.9;这是官方修复说明,不是本站已复现或已验证的修复结果。

3. 能聊天却不能操作屏幕

症状:Hands 不可用或没有截图模型。 原因:选中的 provider/model 不支持视觉,系统权限未给,或平台是 iOS。 解决:检查 Operating the screen 与系统权限;iOS 的限制不要用反复重装规避。

4. 自带 key 后仍看到 relay 上的对话

症状:误以为自带 key 就完全绕过云端数据保存。 原因:推理路由、会话同步和训练许可相互独立。 解决:检查 Data controls 的同步、记录与模型改进设置,并按隐私页删除已有保留数据。

5. 远端任务没有动静

症状:手机发出了 @设备请求,但电脑没有产物。 原因:目标不在线、账号或 relay 不同、权限等待,或电脑已休眠。 解决:先核对 Devices 的在线状态和审批,再检查目标目录;关闭 App 与机器关机不是同一回事。

五个使用技巧

  1. 第一轮只挂载练习目录,别把整个用户主目录当工作区。
  2. 给设备起清楚的名字,远程任务前确认型号与在线状态。
  3. 对发送或删除先用单次审批,定期清理 remembered approvals。
  4. 使用 own key 前在供应商侧设置预算,再检查四种能力实际选择的模型。
  5. 报错时保留版本、平台和脱敏步骤,不上传 key、私人对话或完整截图。

常见问题 FAQ

Q1: 开源免费是不是模型免费无限用?

A: 不是。社区提供起始额度,自己的 key、订阅和服务器都有各自计费与限制。

Q2: iPhone 能像 Android 一样操作其他 App 吗?

A: 不能直接这样推断。官方明确 iOS 不支持本机 Hands 屏幕操作,可用能力应看平台说明。

Q3: 关掉窗口后一定继续运行吗?

A: 后台任务依赖客户端/运行时仍在工作、机器在线和权限可用,不等于关机也继续执行。

Q4: 用自己的 key 就不需要检查隐私开关了吗?

A: 仍需要。推理端点与 relay 的同步、执行记录、训练许可是不同的数据路径。

Q5: Sentinel 能保证不会误操作吗?

A: 不能保证。这里仅核对了官方设计说明,没有独立测试拦截能力,仍应限制目录并人工检查产物。

参考链接

📊 评分与标签

核验口径:已按现行口径通过,待按新证据契约复核 · 证据状态:仅公开资料 · 核验日期:

评分说明

总分 7.7/10 · S_入选

核验日期:2026-11-18。评分依据可追溯至官网、文档、下载目录、README、Desktop、Own key、Privacy 与 1.0.9 发布说明。 未安装、未登录、未连接设备,未测试 Hands、Sentinel、同步或自托管;全部能力判断是 doc-only,非独立实测结果。 安全机制与后台能力按官方说明表达,不推断为绝对防护、保证成功或机器关机后继续运行。

可观测社区指标

采集日期:2026-11-18。仓库 API 返回 stars 3,555、forks 423、open issues 173(包含 PR)、未归档,pushed_at 为 2026-11-13T06:49:04Z。 最新发行 API 为 v1.0.9,发布于 2026-10-29T15:07:55Z,与官网 Tiller 下载版本一致。 许可表述采用 README 的 GPL-3.0-or-later;API 机器分类为 GPL-3.0,不把机器标签当作删去 or-later 的依据。 星数不是用户规模或任务成功率,未引用未核实的下载量、排行榜或贡献者数字。

🤖 Agent 能力 1.6/2.0

  • 证据:提供 shell、浏览器、MCP、技能、Hands、可读记忆与例行任务;执行位置依设备,iOS 不支持本机屏幕操作。来源:README。
  • 竞品对比 1(OpenMinis):OpenMinis 以原生移动 agent 与端侧 Linux 环境为核心;nanoMuse 在继承移动线基础上扩展桌面、网页和 relay,不能把两者当成互不相关的实现。
  • 竞品对比 2(Open Interpreter):Open Interpreter 当前 README 聚焦终端编码代理、可切换 harness 和 computer-use 技能;nanoMuse 强调个人设备与记忆/例行任务的整体体验,未比较任务完成率。
  • 扣分:跨设备与屏幕动作只有官方设计/示例,缺少本站端到端运行证据;不同平台能力不齐。

🖐️ 易用性 1.2/1.5

  • 证据:官网按平台给出 1.0.9 安装包与镜像,模型设置按 Chat、Operating the screen、Making pictures、Making clips 分开。来源:下载与文档、Own key。
  • 竞品对比 1(OpenMinis):OpenMinis 同样提供移动安装与原生界面;nanoMuse 的入口更多,但模型、账号和设备配置也更复杂。
  • 竞品对比 2(Open Interpreter):Open Interpreter 从终端命令进入,nanoMuse 提供图形客户端,非终端用户有更直观的入口,但系统权限和模型能力仍需学习。
  • 扣分:桌面包存在证书/公证提示;iOS 走 TestFlight,不能按稳定应用商店版本预期可用性。

🔌 生态集成 1.8/2.0

  • 证据:Android、iOS、Windows、macOS、Linux、网页与 Docker 路径公开;支持自有模型、MCP、技能与设备 relay。来源:README、Desktop。
  • 竞品对比 1(OpenMinis):OpenMinis 官方 README 强调 iOS/Android 和原生 offload;nanoMuse 把桌面与同账号设备通信放进产品范围,覆盖面更广但验证面也更大。
  • 竞品对比 2(Open Interpreter):Open Interpreter 明确支持 ACP、MCP 与 Codex exec 协议;nanoMuse 的重点是设备级接续,不能用「跨设备」推断也覆盖全部开发客户端协议。
  • 扣分:提供商支持聊天不代表支持 Hands、图片或视频;自有模型端点和自建账号 relay 也不是同一项配置。

👥 社区支持 1.0/1.5

  • 证据:官方 README 有多语言入口、贡献说明、Issues、Discussions 与 Discord;近期仍有推送。来源:仓库与贡献入口。
  • 竞品对比 1(OpenMinis):OpenMinis 提供社区与构建说明;nanoMuse 另外维护整套 relay 与多客户端文档,问题报告需精确到平台,不能只用 stars 比支持质量。
  • 竞品对比 2(Open Interpreter):Open Interpreter 公开终端、provider 与 sandbox 文档;nanoMuse 同样有官方文档,但跨设备问题可能需要多个组件的日志,未核实支持响应时间。
  • 扣分:项目较新,未验证第三方长期采用或实际答疑质量;173 个 open issues 含 PR,不能解释为 173 个故障。

💡 创新程度 1.3/1.5

  • 证据:同账号下各设备运行自己的 agent,Reach 接续、Hands 操作、Markdown 记忆与审批联动形成个人 agent 组合。来源:官网、README。
  • 竞品对比 1(OpenMinis):端侧 shell 与移动 agent 已有上游基础,nanoMuse 的增量主要在多设备与 relay 协作,不把上游功能全算作原创。
  • 竞品对比 2(Open Interpreter):代码执行和 computer use 并非 nanoMuse 独有;它的区别是把这些能力放入设备、身份与长期任务的同一体验里。
  • 扣分:核心组件大量建立在现有项目上,组合设计可取但真实协作收益尚未独立验证。

🔒 稳定性 0.8/1.5

  • 证据:1.0.9 说明修复已登录桌面 1.0.8 卡启动和 relay 大记录查询问题,公开升级与回归边界。来源:Tiller 发布说明。
  • 竞品对比 1(OpenMinis):移动端单机运行与 nanoMuse 多端/relay 的故障面不同,继承上游不等于整套跨设备链路继承了稳定性保证。
  • 竞品对比 2(Open Interpreter):Open Interpreter 的终端执行、协议和工具也有环境依赖;nanoMuse 多出 relay、同步与平台权限,维护复杂度更高,但本文未测故障率。
  • 扣分:已有用户升级曾暴露新安装检查未覆盖的问题;Sentinel 未经本站测试。隐私说明披露同步和模型改进默认项,不能把 own key 当成不留云端记录的保证。来源:Privacy。

维度求和核对

1.6 + 1.2 + 1.8 + 1.0 + 1.3 + 0.8 = 7.7,与 JSON rating 一致。

标签说明

  • 个人智能体:以个人任务、记忆与例行为核心,不只是模型聊天客户端。来源:官网。
  • 跨设备:同账号连接手机、桌面与网页,但各平台可执行能力有差异。来源:README。
  • 自带密钥:提供 Own key 路径与能力分项设置,不表示所有数据自动绕过 relay。来源:Own key。
  • 开源:README 声明 GPL-3.0-or-later,客户端与 relay 在同仓库;依赖第三方许可仍需遵守。来源:README 许可。

来源核实与局限

  • 直连读取官网、docs、同版本下载目录、README、Desktop、Own key、Privacy、仓库/发行 API;未做浏览器交互验证。
  • /download 返回 404,改用首页明确链接的 /#download 与 /dl/v1.0.9/,未把失败路径当可用下载页。
  • 已读取 OpenMinis 与 Open Interpreter 官方 README,比较仅限文档中的产品结构,没有速度、质量或安全排行榜结论。
  • 未独立实测安装、审批、远程任务、数据删除和自建 relay;社区额度与供应商费用以实际账号与当前规则为准。

同分类推荐

开源框架 分类下的其他 Agent