Agent 管理

概述#

Agent 页面是所有 OpenClaw Agent 的中央注册表。同步连接器时会自动发现 Agent。每个 Agent 显示其健康状态、运行时配置、模型设置、技能和工作区文件。

你可以启用/禁用 Agent、触发紧急停机开关、查看核心配置标签以及 evaluation、scorecard、governance 视图，并编辑工作区文件（带冲突检测）。

前置条件#

OpenClaw 侧配置#

Agent 在 OpenClaw 配置中定义。每个 Agent 具有身份、模型配置、技能、工具、通道和定时任务。

OpenClaw 中的关键配置项：

• -Agent 身份：在 OpenClaw 配置 YAML 中定义的名称、描述、图标和角色
• -模型配置：主模型和可选的备用模型（如 anthropic/claude-sonnet-4-6）
• -技能：可以启用/禁用的 Agent 能力
• -工作区文件：Agent 工作目录中的自定义指令和数据文件

ClawButler 侧配置#

从连接器同步后，Agent 会自动出现。你可以：

• -启用/禁用：切换 Agent 可用性。禁用的 Agent 将停止接收任务。
• -紧急停机：立即停止 Agent，同时在本地和 OpenClaw 中生效。恢复需要明确确认。
• -删除：从 ClawButler 中移除 Agent（不影响 OpenClaw）。

使用反馈#

同步后，Agent 页面显示：

• -网格或列表视图，带健康状态圆点（绿色=健康，橙色=需关注，红色=错误）
• -Agent 头像（身份图标）和名称
• -运行状态指示器（在线、已禁用、已停机）
• -已连接实例名称和 Agent 数量徽章

点击任意 Agent 可查看配置标签，以及 evaluation、scorecard、governance 视图。

Web 端操作#

Agent 页面支持两种视图模式：

网格视图（默认）

卡片显示头像、名称、健康状态和描述。适合快速浏览大量 Agent。

列表视图

紧凑行显示头像、名称、连接器和健康圆点。适合密集列表。通过视图切换按钮切换。

筛选

使用健康筛选标签（全部 / 健康 / 需关注 / 错误）缩小列表范围。视图模式保存在 localStorage 中。

Agent 详情

点击 Agent 卡片查看配置标签和 governance 视图。Governance 标签会汇总最近的 decision、activity、traces，并提供 pause / resume / retire 生命周期动作。文件标签页可以查看和编辑工作区文件（带冲突检测）。

CLI 端操作#

列出所有 Agent，可选健康状态筛选

$ ap agent list

显示指定 Agent 的详情

$ ap agent show <id>

查看单个 Agent 最近的 decision、activity 和 trace 摘要

$ ap agent governance <id>

通过 lifecycle controller 对 Agent 执行 pause、resume 或 retire

$ ap agent pause <id> --reason "Maintenance window"
ap agent resume <id> --reason "Window closed"
ap agent retire <id> --reason "Decommissioned"

启用已禁用的 Agent

$ ap agent enable <id>

禁用 Agent

$ ap agent disable <id>

查看 Agent 配置（概览、文件、工具、技能、通道、定时任务）

$ ap agent config show <id>

查看或更新模型配置

$ ap agent config models show <id>

移动端操作#

Agent 标签页是底部导航的第二个标签。功能包括：

• -搜索栏，支持按名称或平台筛选
• -健康筛选标签（全部 / 健康 / 需关注 / 错误）
• -点击任意 Agent 查看详细信息
• -下拉刷新重新加载 Agent 数据

常见问题#