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

定位：给已经安装或准备安装 Cumora 的个人用户使用。 https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.cumora https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.lightos.entry ## 一、开始前：Cumora 与懒猫微服各自负责什么 - Cumora：网页协作界面、对话、Agent、任务与持久化数据。 - LightOS 设备：运行本机 Codex/Claude 等 CLI 的 Computer daemon。 - 核心原则：浏览器走懒猫 SSO；盒内 daemon 优先走 `.lzcapp` 内网地址，不把本地 Agent 的工作目录或登录态交给服务器。 - 适用范围：当前（20260824）应用版本号为 `0.1.4`（对齐社区版本 `v0.2.0`，支持了中文、支持 Grok、Cursor) - 本应用的项目代码也放到了 [Github](https://github.com/gogotanc/cumora) 上，有兴趣可以提 PR 共同维护。 ## 二、安装并打开 Cumora 1. 在懒猫应用商店安装 Cumora，首次打开通过懒猫 SSO 自动进入。  3. 打开之后中会自动创建工作空间、进入 Computer 管理页。 5. 点击“添加 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 实例中执行： ```bash 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 等示例。 配对成功后安装为用户常驻服务： ```bash npx cumora@latest agent computer \ --install-service \ --server http://cumora.cloud.lazycat.app.cumora.lzcapp:5181 ``` 日常检查和重启： ```bash 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 能够访问即可。 https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.forward 如下图所示，把 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 端（或者大屏设备）上操作，左上角才能看到自己的头像并点击进入（移动端我也没有找到入口。。）