支持的 Agent

灵光爸爸 的 aura CLI 是一个 Agent 管控工具——它在本地机器上发现、注册并执行 AI 编码 Agent。守护进程扫描 PATH 上已安装的 Agent CLI，运行版本检测（支持时使用 <binary> --version），并将每个有效的 Agent 注册为工作区中的运行时。

下表列出已确认完整流程可用的 Agent：守护进程能检测到二进制、版本检测通过、运行时成功注册。

已验证可用

以下 8 种 Agent 已确认通过完整流程：守护进程能检测到二进制、版本检测通过、运行时成功注册。可用于生产环境。

Agent 参考

安装后验证

前置准备：如果还没有把本机接入 灵光爸爸，请先打开 灵光爸爸 工作区（网页端或桌面端）里的**「添加设备」**弹窗，依次执行弹窗中展示的两条命令：

1. 安装 aura CLI（macOS / Linux）：curl -fsSL https://aurababa.com/scripts/install.sh | bash（Windows 用户在弹窗中复制对应的 PowerShell / cmd 命令）
2. 连接设备：aura setup --token <token> --yes

如果你已经装过 aura CLI，先执行 aura update 升级到最新版本，再执行第 2 条命令。两条命令执行完成后，本机会作为设备出现在设备列表中。

安装 Agent 后，确认 Aura 完整流程正常工作。下文中的"二进制"指的是你安装的、交给 灵光爸爸 管理的那个 Agent 的可执行文件（例如 claude、codex、kimi）：

# 1. 确认你安装的 Agent 的二进制在 PATH 上，且 --version 输出 semver 格式
<binary> --version

# 2. 如果守护进程已在运行，重启以检测新的二进制
aura daemon restart

# 3. 确认守护进程已检测到 Agent
aura daemon status
# 在 "Agents:" 行中查找 Agent 名称

# 4. 确认运行时已注册
aura runtime list
# 查找对应 provider 类型且状态为 "online" 的运行时

如果 <binary> --version 正常但 Agent 未出现在 aura daemon status 中，可能是守护进程的 PATH 与当前终端不同。在 macOS/Linux 上，通过 GUI 启动的守护进程可能找不到由版本管理器（fnm、nvm、mise）安装的二进制。通过对应的 AURA_<AGENT>_PATH 环境变量设置显式路径（参见配置），重启守护进程后再次检查。

Windows 自动 PATH 处理

在 Windows 上，守护进程会自动处理常见的安装路径问题：

• 跳过 Microsoft Store 别名（%LOCALAPPDATA%\Microsoft\WindowsApps\*.exe）——Store 应用无法被可靠启动，守护进程会跳过它们去寻找真实安装（例如 npm 全局目录）。
• 自动识别 npm 全局安装（%APPDATA%\npm）——即使该目录不在 PATH 中也能找到 Agent，并自动把该目录加入用户 PATH，让 CLI 在新终端中也可用。
• 自动发现已安装应用——通过 Windows 注册表（例如 OpenClacky 安装在 E:\OpenClacky）发现 Agent，并自动把安装目录加入用户 PATH。

守护进程修复 PATH 后，重启一次（aura daemon restart）即可重新检测所有 Agent。

已知不支持

以下工具不是基于 CLI 的编码 Agent。它们无法被 Aura 守护进程检测或管理，也没有对应的代码适配器。不要期望它们出现在 aura daemon status 或 aura runtime list 中。

检测和注册原理

PATH 扫描 → exec.LookPath → 版本检测（--version） → 最低版本检查 → 服务端注册

1. PATH 扫描：守护进程在 PATH（以及 macOS/Linux 上的登录 shell PATH）中探测每个已知二进制名称。
2. 版本检测：运行 <binary> --version 并从输出中解析符合 semver 格式的字符串（如 2.1.98）。如果 --version 失败或输出中没有 semver 标记，跳过该 Agent。
3. 最低版本检查：少数 Agent 有最低 CLI 版本要求（见下方）。大多数 Agent 没有最低版本限制。
4. 服务端注册：守护进程将 Agent 名称、版本和设备信息发送到 灵光爸爸 服务端，服务端创建或更新运行时记录。

Agent 也可以通过自定义运行时配置文件（aura profile）注册，你可以定义 protocol_family（匹配任意支持的 Agent 类型）和自定义 command_name。这是内置列表之外 Agent 的扩展入口。

最低版本要求

配置

Agent 二进制路径

默认情况下，守护进程在 PATH 上发现 Agent CLI。可通过环境变量为任何 Agent 覆盖路径：

模型覆盖

每个 Agent 的模型可通过 AURA_<AGENT>_MODEL 覆盖（如 AURA_CLAUDE_MODEL=claude-sonnet-4-6）。该值会传递给 Agent 的 --model 参数。完整变量列表见上表。

默认 CLI 参数

部分 Agent 支持通过 AURA_<AGENT>_ARGS 设置默认额外参数：

参数按 POSIX shellword 解析后按以下顺序应用：灵光爸爸 硬编码默认值 → 守护进程环境默认值 → 任务的 custom_args。

快速开始

1. 打开 灵光爸爸 工作区里的**「添加设备」**弹窗，依次执行弹窗中展示的两条命令：先运行安装命令安装 aura CLI，再运行 aura setup --token <token> --yes 把本机连接为设备（如果你已经装过 aura CLI，先执行 aura update 升级到最新版本）。完成后，本机会出现在设备列表中。
2. 在你的机器上安装一个或多个 Agent CLI（建议从已验证可用列表开始）。
3. 通过 aura daemon status 确认检测结果，通过 aura runtime list 确认注册结果。
4. 在 灵光爸爸 工作区中将任务分配给 Agent。

完整的 CLI 安装和守护进程配置详情，请参阅 CLI 和守护进程指南。

架构概览

灵光爸爸 是管理 Agent 的平台：你在网页端或桌面端定义任务、分配数字伙伴、跟踪进度；每台接入设备上的 aura CLI 守护进程负责发现、注册并执行你安装的 Agent。

• 灵光爸爸 平台：统一管理任务、数字伙伴和进度，不直接运行 Agent。
• aura CLI 守护进程：运行在你的设备上，向平台注册运行时，并在接到任务时执行对应的 Agent。
• Agent CLI：你安装的编码 Agent，由平台通过守护进程统一调度。

把 OpenClaw 作为统一管理入口

如果你希望在自己已有的 OpenClaw 中统一管理一切（而不只是使用 灵光爸爸 的网页端），可以通过开放平台把 灵光爸爸 嵌入你的 OpenClaw：安装 灵光爸爸 Platform Skill 后，你就能直接在 OpenClaw 里管理任务、分布在多台机器上的 Agent 以及人机协作。详见 开放平台。