Beta
ZH
English 简体中文

注册 Self-owned computer

把自己的笔记本、台式机或 homelab 接入 Manyfold 作为运行环境。

Self-owned computer 让 Manyfold 把任务路由到你自己的机器，而不是云端 sandbox。mf CLI 会在该机器上运行本地 daemon，上报已安装的 coding agent（Claude Code、Codex、Gemini CLI），并按需承接 agent 会话。

适合使用 self-owned computer 的场景：

  • 需要直接访问本地仓库或文件系统。
  • 机器上已经装好了 CLI 工具链。
  • 想用自己的 GPU、网络或算力环境。

准备工作

  • 在要注册的机器上安装 mf CLI。参考 安装 CLI。
  • 选择要持有这份注册信息的 CLI profile。
  • 登录：mf login。如果是通过 SSH 连接的无浏览器机器，用 mf login --no-launch-browser，然后在任意一台机器的浏览器里完成授权。

最短路径是 mf setup：它会完成登录、签发机器 token、注册 host、安装 autostart，并等待 daemon 健康。SSH 环境使用 mf setup --no-launch-browser。如果 token 由管理员代为签发，再使用下方的手动流程。

第 1 步：申请 token

在网页应用打开 设置 → Self-owned computers。在 注册新机器 区域给机器起个名字（比如 laptop 或 homelab-1），点击 Issue token。

页面会显示一条可直接粘贴的命令：

mf daemon register --token ldt_xxxxxxxxxxxxxxxxxxxxxxxxxx

Token 只显示一次。立即复制整条命令。如果丢了，先撤销旧 token 再申请新的。

第 2 步：在目标机器上运行命令

把命令粘贴到要注册的机器的终端里。CLI 会：

  1. 在 ~/.manyfold/profiles/<profile>/daemon/daemon.id 生成稳定的 daemon UUID。
  2. 检测已安装的 coding 框架（Claude Code、Codex、Gemini CLI、Pi —— PATH 上的 pi，需要 Node 22.19 或更新版本 —— 以及 Antigravity CLI，即 PATH 上的 agy）。
  3. 向 API 注册这台机器。
  4. 把 daemon 配置写到 ~/.manyfold/profiles/<profile>/daemon/config.json。

这份注册属于当前选择的 profile。运行 mf profile show 可查看 active profile 和准确路径。

输出大致如下：

✓ daemon registered
  daemonId: dmh_…
  apiUrl:   https://api.manyfold.ai/api
  detected: claude-code 1.2.3
Start the daemon now? It will auto-start on login. [Y/n]

按 Enter 或 y 启动 daemon。mf daemon start 会安装一份自启单元（macOS 的 launchd LaunchAgent / Linux 的 systemd user unit），之后每次登录都会自动拉起 daemon，崩溃后由系统自动重启 —— 不需要保持终端打开。

无人值守或脚本化场景，加 -y 一次性跳过 prompt 并直接启动：

mf daemon register --token ldt_xxxxxxxx -y

第 3 步：确认机器上线

回到网页应用的 设置 → Self-owned computers。这台机器会出现在 Connected machines 列表里，前面是绿点。如果 daemon 超过 45 秒没发心跳，绿点会变灰。

每台机器还会显示当前 CLI 版本 和 启动方式，例如 Mac 上通过 LaunchAgent 启动会显示 cli 0.7.0 · autostart · login (launchd)；如果是从终端直接拉起而没装自启单元，则显示 cli 0.7.0 · manual。

在该机器上也可以直接查：

mf daemon status
mf daemon logs

第 4 步：在这台机器上创建 Agent

在 Connected machines 列表里，点击在线机器旁的 + Create agent →，新建 agent 流程会自动选好这台机器作为 runtime。

也可以打开 New agent，选好框架后，把 runtime 选成 Self-owned computer。

已保存的 MCP 与平台上下文

Claude Code、Codex 和 Gemini CLI Agent 的 daemon 重连后，Manyfold 会重试已保存的 MCP 配置和平台上下文。电脑离线期间保存的修改会保持待交付状态，直到写入成功。连接账号变更也会刷新上下文，不要求模板版本先升级。

自动交付需要当前 CLI。较旧 daemon 会显示升级提示；请更新并重启，或在 Agent 设置中显式推送。写入失败会保留可见状态，之后可以重试。Manyfold 保留托管引用块之外的自定义指令。

管理 daemon

mf daemon status              # 进程 + 心跳状态，以及自启单元状态
mf daemon logs                # tail 本地日志
mf daemon start               # 安装自启单元并启动（默认登录级）
mf daemon stop                # 停止 daemon（连同它拥有的 exec）并移除自启单元
mf daemon stop --keep-execs   # 只停 daemon，留下正在跑的 exec 给下一个 daemon 接管
mf daemon doctor              # 诊断注册 / 框架检测问题
mf doctor                     # 检查每个 profile 的 daemon、登录与 API，并给出修复方法
mf daemon hooks status        # claude / codex / pi / agy 的 session hook（见下）

Daemon 日志在 ~/.manyfold/profiles/<profile>/daemon/daemon.log。 mf daemon logs 会自动解析当前 profile 对应的路径。

mf daemon start 和 mf daemon stop 都支持 scope selector：

  • --system —— 把单元装到系统级路径，daemon 在开机时就会拉起（不依赖用户登录）。会用到 /Library/LaunchDaemons（macOS）或 /etc/systemd/system（Linux），需要 sudo。
  • --user —— 显式安装或移除登录时启动的 user unit。

只有 mf daemon start 额外支持 --foreground。它会在当前终端内联运行， 不修改 autostart unit；关掉终端进程就退出。可用于调试、Windows，或没有 launchd/systemd 的环境（如 WSL1、最小化容器）。自动安装 daemon 目前只支持 macOS 和 Linux；Windows 需要前台进程或自行配置 service manager。

执行 mf update 升级 CLI 后，先 mf daemon stop 再 mf daemon start，让自启单元重新写入新的二进制路径。否则 launchd / systemd 在你手动重启单元前会一直用旧路径。

Session hook

从 web 打开某个对话的终端（TUI resume）之后，Manyfold 需要知道终端里的 claude / codex / pi / agy 进程正在哪个对话上：它有没有换掉 session id、有没有 /clear、有没有另起新会话。这些由 CLI 自己的会话事件上报，所以 mf daemon register 会问一次是否安装 hook（-y 视为同意，--no-hooks 视为拒绝）。Claude Code 与 Codex 的 hook 是一个脚本，加上 ~/.claude/settings.json 与 ~/.codex/hooks.json 里每个事件一条带 Manyfold 标记的条目，和你已有的 hook 并存；Pi 的 hook 是一个扩展文件 ~/.pi/agent/extensions/mf-session.ts，由 Pi 自己加载；Antigravity CLI 的 hook 是一个脚本，加上 ~/.gemini/config/hooks.json 里一个名为 manyfold-session 的块，和文件里其他块并存。agy 没有会话结束事件，所以它的 hook 会在 agy 进程上留一个后台小进程，agy 退出时由它上报对话。

hook 只在 Manyfold 打开的终端里生效（shell 带有 MF_TERMINAL_ID），并且不输出任何内容（agy 的 hook 只回一个空的 {}，不改变任何东西），所以你自己的 shell 和模型上下文都不受影响。Codex 对新装的 hook 需要你在它的 TUI 里用 /hooks 批准一次才会执行。

mf daemon hooks install       # 为本机已有的框架安装，并在 daemon 启动时保持最新
mf daemon hooks status        # 按框架查看安装状态
mf daemon hooks uninstall     # 只移除 Manyfold 加的内容

没有 hook 终端照样能用：从 web 打开的对话会在你关掉终端或点 Back to web 时交还；只是 TUI 内部发生的事（/clear、新会话）不会被跟踪。

每个 profile 只运行一个 daemon

同一 profile 只允许一个 daemon 进程。重叠的 foreground 启动会在建立连接或 发送 heartbeat 前退出。即使 PID 文件缺失，仍在服务的 control socket 也会阻止 第二个进程启动。进程停止或崩溃后，下次启动会回收其归属记录；电脑休眠期间， 仍存活的进程继续持有归属。

如果旧 CLI 已经运行了多个副本，先让当前任务结束，关闭你为该 profile 启动的 foreground 进程，再停止、升级并重启目标 profile：

mf --profile default daemon stop
mf update
mf --profile default daemon start
mf --profile default daemon status

保留原 profile 和注册信息。不要通过删除 PID、socket 或归属文件来绕过 already-running 错误；先检查 mf daemon status 和该 profile 的日志。 不同 profile 仍可分别运行 daemon。

自启动级别

默认的 mf daemon start 把 daemon 注册在登录级（user scope）：

系统路径启动时机
macOS~/Library/LaunchAgents/ai.manyfold.daemon.<profile>.plist登录时启动
Linux~/.config/systemd/user/mf-daemon-<profile>.service登录时启动

mf daemon start --system 装到系统级，开机即起，无需登录：

系统路径启动时机
macOS/Library/LaunchDaemons/ai.manyfold.daemon.<profile>.plist开机时启动
Linux/etc/systemd/system/mf-daemon-<profile>.service开机时启动

Unit 名包含 profile，因此 production 和 staging daemon 可以同时运行：

mf --profile default daemon status
mf --profile staging daemon status

系统只会在 daemon 崩溃（非 0 退出）时自动重启它。mf daemon stop 正常退出后 daemon 会一直停着，想再次启动跑 mf daemon start 即可。

Linux 登录级 scope 下，daemon 默认在登录时启动。如果希望开机即起（不依赖登录会话），给当前用户开启 lingering：loginctl enable-linger $USER。

Workspace 和 skill 存储

Profile 隔离的是 daemon control plane，不隔离 Agent data。默认情况下所有 profile 共享：

~/.manyfold/workspaces
~/.manyfold/skills

如果 host 需要隔离的 root，请在注册时声明：

mf daemon register --token - \
  --workspace-root /srv/manyfold/workspaces \
  --skills-dir /srv/manyfold/skills

这些 root 属于对应 host registration，并会报告给 Manyfold；仅切换 profile 不会移动已有 Agent data。

自动更新

由 init unit 管理、连接官方 API 的 standalone daemon 每六小时检查一次所属 release channel，并且只在 idle 时更新。Daemon 忙碌时不会中断 session，而会稍后 重试。可在 daemon 环境中设置 MF_DAEMON_AUTO_UPDATE=0 禁用，或设置为 1 让自定义部署强制启用。手动运行 mf update 后仍需重启 daemon，才能让 init unit 加载新 binary。

在任意一台机器上，mf updates list --kind cli 可以看到哪些电脑的 CLI 落后了， mf updates apply --kind cli 会更新其中由 init unit 管理的那些。Daemon 忙碌时， 等它的 session 结束后才会换上新版本；手动启动的 daemon 显示为 by hand，并给出 要在那台机器上运行的命令。

预览：让 exec 活过 daemon 重启

默认情况下，一次 chat turn 的进程是 daemon 的子进程，daemon 重启（崩溃或更新）就会把它带走。在 macOS 和 Linux 上，给 daemon 环境设置 MF_DAEMON_EXEC_FILES=1，普通 exec 会改为 detached 启动，输入输出都落在 daemon exec 目录下的文件里：重启后的 daemon 会把还在跑的进程接回来，turn 继续。这个开关在逐个框架验证完之前默认关闭；mf daemon start 的日志会显示它是否开启。走 runtime auth profile 的 exec 重启后同样保留 profile 租约：新 daemon 会在重连之前先把租约接过来，中间不会有别的东西跑到这个 profile 上。

exec 能不能真的活过重启，取决于管着 daemon 的是谁：launchd 从不碰它；mf daemon start 写的 systemd user unit 现在带 KillMode=process，效果一样（旧 unit 用 mf daemon stop && mf daemon start 重装）；system unit 归运维管，mf daemon doctor 会报告它的行为。mf daemon start 会记 exec survival: yes|no，更新只等那些会随 daemon 一起死的 session。普通的 mf daemon stop 会把 daemon 拥有的 exec 一起结束；--keep-execs 则留给下一个 daemon 接管。

终端留在 daemon 上

在 workbench 里给 daemon agent 打开的终端属于 daemon，而不是显示它的那个浏览器标签页。标签页断线（网络抖动、平台发布）或者被关掉时，shell 以及里面跑着的东西——包括 resume 进来的 claude / codex 会话——都留在机器上继续运行。workbench 下次打开这个终端时会接回同一个 shell：先把屏幕原样恢复，再继续实时输出。给一个已经被这样的 shell 持有的会话打开终端，同样会接到它上面，并从其它正在显示它的标签页手里接管过来（那个标签页会提示，并提供重新连接）。

没有人连着的终端 30 分钟后关闭；跑在 runtime auth profile 下的终端是 5 分钟，因为它一直占着这个 profile 的锁。chat 视图里的”回到 web”会立即结束它。mf daemon status 会显示 daemon 保留了多少个终端、其中多少个有人在看；一个 daemon 最多保留 8 个。daemon 重启仍然会结束它的终端。

排错

先运行 mf doctor。它会检查每个 profile 的注册、daemon 进程和自启单元、daemon 是否仍运行着磁盘上的那份二进制，以及它为什么 offline，并为每个问题给出修复方法。 下面的大多数情况它都能直接识别。

  • daemon register requires --token <token> — 没传 token。回到网页应用重新复制完整命令。
  • token must start with ldt_ — token 被截断了。重新复制。
  • 机器一直 offline — 在机器上跑 mf daemon status 确认进程在；同时确认该机器能访问 api.manyfold.ai 的 HTTPS 出站。
  • Token already bound — 一个 token 只能绑一台机器。再注册新机器请申请新的 token。
  • 退役机器 — 在 设置 → Self-owned computers 点击 Retire。绑在这台机器上的 agent 会变为不可用；机器上的工作目录文件不会被删。那台机器上仍在运行的 daemon 会在日志里写明被拒绝的原因，并把重连退避到每 15 分钟一次；用 mf daemon stop 停掉它。退役的机器不能重新启用：申请新 token 并重新注册这台机器，它会作为一台新机器加入。
  • Linux 上报 systemd not available — 当前环境没有可用的 user systemd 会话（常见于 WSL1 和精简容器）。可以在长会话里跑 mf daemon start --foreground，或加 --system（需要 sudo 和系统级 systemd）。
  • Connected machines 显示 manual — daemon 不是通过 mf daemon start 启动的（比如用了 --foreground 或旧版本 CLI）。跑 mf daemon stop && mf daemon start 重新注册一份自启单元即可。
  • mf update 升级后 Connected machines 还显示旧的 CLI 版本 — 系统当前跑的还是已加载到内存的旧二进制。跑 mf daemon stop && mf daemon start 让 daemon 在新二进制下重启。
  • 从 CLI 0.21 或更早版本升级后机器变成未注册 — CLI 0.22 移除了 pre-profile config 和 daemon fallback。请在目标 profile 中重新运行 mf login，签发新的机器 token，并执行 mf daemon register。~/.manyfold/workspaces 中已有的 Agent workspace 不会被删除。
  • manual 的 daemon 远程升级：standalone 的 manual daemon 也能从控制台升级：它自己换掉二进制、拉起继任者并把正在跑的 exec 交过去，继任者起不来就把旧二进制放回去（这个版本随后不会再试，除非换一个目标）。
这个页面有帮助吗？