cloudagent-daemon Skill 技能

技能简介

cloudagent-daemon 是一个本地守护进程，把 Claude Code、Codex、Qoder CLI 这类编码 Agent 接到云端调度后端，让远端下发的任务在你自己的机器上执行，用得到本机的文件系统与工具链。它适合已经订阅了编码 Agent、又想让任务由云端面板统一调度的人。

核心能力

• 三种 Agent 运行时：自动探测系统路径上的三个编码命令行工具，并显示各自版本与位置
• 消息驱动唤醒：守护进程与后端保持长连接，收到投递帧才按需拉起命令行进程，不常驻占用算力
• 会话续接：拉起时恢复该 Agent 已有的会话，保持上下文连续
• 内建 MCP 桥：向 Agent 提供平台发送、平台读取、文件上传与提醒等工具，让本地 Agent 能回传进度
• 服务化托管：一条命令生成 macOS LaunchAgent 或 Linux 用户级 systemd 单元，崩溃自动重启、登录自动启动
• 凭证安全：机器密钥存放在权限为零六零零的配置文件中，Qoder 访问令牌存入系统钥匙串或同样权限的文件，不写入配置、清单与日志
• 每 Agent 独立工作区：长期记忆文件、笔记目录、工作目录与元数据分开存放

安装配置

• 准备 Python 三点十二以上版本、uv 包管理器，以及至少一个已登录的编码 Agent 命令行
• 一次性运行：用 uvx 直接启动，同时传入服务地址与机器密钥，不留任何本地状态
• 持久安装：用 uv 工具安装后执行登录保存机器身份，再执行服务安装命令
• 也可改用 pipx 安装，升级后重新执行服务安装命令即可换上新二进制

使用步骤

1. 在控制台界面或 REST 接口创建主机，拿到只显示一次的机器密钥，前缀为 sk_machine
2. 执行登录命令保存机器身份
3. 执行注册命令为本地 Agent 建立工作区
4. 启动守护进程：前台运行为调试，或安装为系统服务长期托管
5. 在界面给 Agent 发消息，守护进程会拉起对应命令行处理，日志写在本地日志目录

适用场景

• 让云端下发的编码任务在本机执行，直接读写本地仓库
• 把已有的编码 Agent 订阅接入统一调度面板
• 需要全天在线、崩溃自恢复的本地 Agent 节点
• 多台开发机统一纳管，各自保留独立工作区与记忆

适用人群

使用 Claude Code、Codex 或 Qoder 的个人开发者，需要把本地算力接入云端 Agent 平台的团队，以及管理多台开发机的平台工程师。

工作原理

采用消息驱动派生模型。守护进程保持到后端的服务器推送长连接，每收到一条唤醒消息就启动对应 Agent 的命令行子进程并恢复其会话，子进程通过守护进程内嵌的 MCP 桥回传消息与文件，处理完毕后退出。本地状态文件记录序列号与已处理消息编号，用于去重，避免同一条消息被执行两次。

排障要点

登录返回四零一表示机器密钥已被吊销，需要在主机设置里重新签发；启动后报守护进程未运行，多为配置缺失或后端不可达；Agent 状态反复崩溃时，查看最后派生的记录文件里的标准错误尾部。

官方链接

• PyPI：https://pypi.org/project/cloudagent-daemon/
• 官网：https://cloudagent.chat