在懒猫微服上使用 Cumora：从安装到本地 Agent 配对

定位：给已经安装或准备安装 Cumora 的个人用户使用。

一、开始前：Cumora 与懒猫微服各自负责什么

• Cumora：网页协作界面、对话、Agent、任务与持久化数据。
• LightOS 设备：运行本机 Codex/Claude 等 CLI 的 Computer daemon。
• 核心原则：浏览器走懒猫 SSO；盒内 daemon 优先走 .lzcapp 内网地址，不把本地 Agent 的工作目录或登录态交给服务器。
• 适用范围：当前（20260824）应用版本号为 0.1.4（对齐社区版本 v0.2.0，支持了中文、支持 Grok、Cursor)
• 本应用的项目代码也放到了 Github 上，有兴趣可以提 PR 共同维护。

二、安装并打开 Cumora

1. 在懒猫应用商店安装 Cumora，首次打开通过懒猫 SSO 自动进入。

3. 打开之后中会自动创建工作空间、进入 Computer 管理页。

4. 点击“添加 Computer”，复制一次性的配对令牌。

--server 后面的 url 参数是可以修改的，根据你 computer 的所处环境，比如懒猫内的 LightOS 连接，直接复制执行就行。懒猫外的设备，可以通过转发工具转发端口，然后通过懒猫 IP 进行配置。

执行的 Harness 目前新版本支持了 Grok Build 和 Cursor，本人目前只自测了 Claude Code 和 Codex。

三、最重要的地址选择：浏览器地址与 daemon 地址不同

• 应用访问地址（或者你懒猫里面打开可以不用管这个）：使用懒猫为应用分配的 HTTPS 域名。

npx cumora@latest agent computer \
  --pair PAIR_TOKEN_HERE \
  --server https://cumora.hitanc.heiyu.space \
  --install-service

四、在 LightOS 实例中配对

先确认本机已安装并登录要使用的 CLI，例如 Codex，LightOS 实例中执行：

npx cumora@latest agent computer \
  --pair PAIR_TOKEN_HERE \
  --server http://cumora.cloud.lazycat.app.cumora.lzcapp:5181 \
  --engine codex

说明每个参数：

• --pair：页面刚生成的一次性令牌；正文标记为必须替换。
• --server：自托管 Cumora 的内网服务地址；遗漏后会连到默认服务，属于最常见错误。
• --engine codex：按实际本地引擎替换；可补充 Claude 等示例。

配对成功后安装为用户常驻服务：

npx cumora@latest agent computer \
  --install-service \
  --server http://cumora.cloud.lazycat.app.cumora.lzcapp:5181

日常检查和重启：

npx cumora@latest agent computer --status
journalctl --user -u cumora -f
systemctl --user restart cumora

正式成文前会按当前 CLI 实际版本再复核 --status 与服务名，避免命令漂移。

五、完成后的最小验收

1. Computer 页面显示设备在线。
2. 为 Agent 指定该 Computer，发送一条简单消息。
3. 确认本机 CLI 被唤醒并且网页收到回复。
4. 重启用户服务后确认自动上线；再验证历史对话仍在。

六、其他设备连接

其他设备（非懒猫设备）如果需要连接 Cumora 服务端，最简单的一个方式是通过端口转发工具，暴露出来接口，确保你要配对的 computer 能够访问即可。

如下图所示，把 cumora 的 5181 端口转发出来即可。

比如我局域网其他机器配对的时候，命令如下

npx cumora@latest agent computer \
  --pair <页面的 token> \
  --server http://<你懒猫的 IP>:5181 \
  --engine codex --install-service

参考我的：

~ ❯ npx cumora@latest agent computer --pair xxxx --server http://192.168.100.175:5181 --engine codex --install-service
[computer] paired as xxxx (default engine: codex; available: codex, claude) — starting…
[computer] installed LaunchAgent io.cumora.daemon — auto-start, auto-restart, auto-update. Logs: /Users/xxx/.cumora/daemon.log
[computer] you can now close this terminal; the service is running in the background.
~ ❯

连上之后，默认会创建几个 Agent，可以愉快玩耍了。

最后有个点需要注意一下，管理 Computer 的操作页面需要在 PC 端（或者大屏设备）上操作，左上角才能看到自己的头像并点击进入（移动端我也没有找到入口。。）