一台服务器，多人各用各的 MochiBot

家人、同事或朋友可以共用一台服务器，每人一个独立助手。先完成Ubuntu 首次部署 ↗，由管理员配置好模型并确认聊天可用；下面的命令都在这台服务器终端执行。

1. 新手机先安装 App

各自在手机浏览器打开MochiBot 下载区 ↗，下载安装最新 APK。需要1.0.0构建19或以上；安装后打开“设置”。不需要 USB 调试，也不用各自注册 Ubuntu 登录账户。

2. 创建第一个成员并扫码

以下以 Alice 为例；alice 是成员代号，Alice 是显示名称。代号用小写英文字母、数字或短横线，最多20位：

sudo mochibotctl member-add alice --name Alice

作用：创建这个成员的专用系统账户、助手服务、独立数据目录，并显示配对二维码。成员不需要用这个系统账户登录 SSH。

看到二维码后，让 Alice 在自己的手机点“设置 → 扫码连接”，扫描并核对服务器、确认绑定。Alice 直接聊天即可，不填写模型 Key。不要把 Alice 的码给 Bob 扫描。

3. 再创建其他成员

Alice 绑定后，再执行：

sudo mochibotctl member-add bob --name Bob

让 Bob 扫自己的码。每位不同的人使用不同代号；不能仅靠手机显示名称区分。

查看已有成员：

sudo mochibotctl member-list

结果中应看到 Alice、Bob，启用状态和服务状态正常。已经创建过同一代号时，不要为了重新扫码再建一份账户。

4. 二维码过期或增加同一个人的第二台手机

sudo mochibotctl member-pair alice

作用：给已存在的 Alice 生成新配对码，不重新创建助手。二维码5分钟内有效，首次绑定限一台设备；已绑定手机继续有效。Alice 的第二台手机扫描后，共用 Alice 的助手和服务端记录。给另一个人用时，应按第3步创建新成员。

5. 检查各人的工作区是否隔离

sudo mochibotctl member-check
sudo mochibotctl doctor

member-check 应输出各成员 passed: true；doctor 应显示服务健康、模型已配置。出现 false 就先处理终端提示，不邀请更多成员。

让两人分别发不同测试消息、上传不同的无敏感小文件，各自要求助手总结；检查聊天历史、回复和文件没有串到另一人。分别创建本机提醒，确认只在对应手机出现。

6. 停用或恢复某位成员

停用 Bob：

sudo mochibotctl member-disable bob
sudo mochibotctl member-list

Bob 的入口和助手服务被停用；Alice 仍应正常使用。停用保留服务端数据和手机已有缓存，不是删除数据。

恢复 Bob：

sudo mochibotctl member-enable bob
sudo mochibotctl member-list

服务恢复后，Bob 原来已绑定的手机可继续使用，不必重新创建成员。

模型、费用与隐私

管理员在 App“设置 → 模型管理”统一选择模型。成员使用同一模型服务，但聊天、文件、会话、记忆和连接凭据分开存储；共享模型不等于共享聊天记录。切换模型会影响所有成员后续请求，执行中的任务结束后才能切换。

模型 API 费用由管理员的服务商账户支付，成员不需要获得管理员 Key。当前不提供按成员金额限额，请在模型服务商设置预算和用量提醒。

隔离针对成员之间；服务器管理员仍有系统维护和数据访问权限。请求内容也会交给所选云端模型服务商处理。

当前支持最多8位额外成员，实际并发取决于服务器资源和模型额度。初期成员工具限工作区文件处理，不提供主机终端、任意软件安装或跨成员工具。微信和 TG 可以作为其他 OpenClaw 渠道，但当前部署包没有自动配置这些渠道；MochiBot 配对码只用于 MochiBot。

某位成员连不上

先用 member-list 确认未停用，再执行 member-check。需要查看 Bob 的服务错误时：

sudo systemctl status mochibot-member-bob.service --no-pager
sudo journalctl -u mochibot-member-bob.service -n 50 --no-pager

第一条看服务状态，第二条看最近50条日志。重新扫码用 member-pair bob；不要重装整台服务器，也不要公开配对码和连接令牌。