aios-agent-management-cli

aios-agent-management-cli 是一个面向 AIOS / OpenClaw 网关的 MQTT 管理服务。它监听管理主题接收 JSON 请求，把常见运维动作统一封装为可调用接口，避免直接登录网关执行命令。

功能

• 通过 MQTT 接收管理请求，并返回统一 JSON 响应
• 管理 OpenClaw Agent 生命周期，包括创建、启用、停用、删除、模型更新和 AGENTS.md 更新
• 管理业务系统元数据与调用审计，动作前缀为 apps.*
• 管理全局 Skills，包括查询、安装、升级和删除
• 管理 Ontology，包括从 S3 兼容存储导入和删除
• 提供日志查询、诊断执行、网关状态查询和重启能力

安装

要求：

• Node.js >= 20
• 运行环境中可直接调用 openclaw

安装：

npm install aios-agent-management-cli

全局安装：

npm install -g aios-agent-management-cli

用法

1. 配置环境变量

最小必需环境变量：

AIOS_DATA_DIR="/var/aios/data"
AIOS_ONTOLOGY_DIR="/var/aios/ontology"
AIOS_OPENCLAW_HOME="/var/aios/.openclaw"
AIOS_RUN_MODE="container"
AIOS_WORKSPACE_TEMPLATES_DIR="/var/aios/workspace-templates"
AIOS_MQTT_CHANNEL_BROKER="mqtt://172.16.12.2:1883"
AIOS_MQTT_CHANNEL_USERNAME="user"
AIOS_MQTT_CHANNEL_PASSWORD="pass"
AIOS_ADMIN_INBOUND_TOPIC="aios/admin/inbound"
AIOS_ADMIN_OUTBOUND_TOPIC="aios/admin/outbound"
AIOS_AGENT_CHANNEL_INBOUND_TOPIC_TEMPLATE="aios/agent/{agentId}/inbound"
AIOS_AGENT_CHANNEL_OUTBOUND_TOPIC_TEMPLATE="aios/agent/{agentId}/outbound"

标准 Docker 部署下，这些拓扑变量通常由 docker-image 入口脚本固定提供，不需要再从 env.json 回传给 CLI。 agent.create 支持 templateName 参数，默认值为 default。创建时会从 AIOS_WORKSPACE_TEMPLATES_DIR/<templateName> 复制整个模板目录到目标 workspace，然后再调用 openclaw agents add 补齐其余 bootstrap 文件，并把 workspace 下的 AGENTS.md 权限收敛为 agents 只读、agents-admin 可写。

如果需要使用 ontology.create，还需要配置 S3 兼容存储：

AIOS_S3_ENDPOINT="http://172.16.12.2:9000"
AIOS_S3_REGION="local"
AIOS_S3_ACCESS_KEY_ID="minioadmin"
AIOS_S3_SECRET_ACCESS_KEY="minioadmin"
AIOS_S3_FORCE_PATH_STYLE="true"

2. 启动服务

全局安装后可直接启动：

aios-agent-management-cli

或者在项目内通过 Node.js 启动：

node ./node_modules/aios-agent-management-cli/dist/cli.js

启动成功后，服务会监听：

• MQTT 请求主题：默认 aios/admin/inbound
• MQTT 响应主题：默认 aios/admin/outbound

3. 发送管理请求

请求消息格式：

{
  "requestId": "req-001",
  "action": "service.ping",
  "params": {}
}

管理响应主题由服务直接从环境变量 AIOS_ADMIN_OUTBOUND_TOPIC 读取并发布。

响应消息格式：

{
  "requestId": "req-001",
  "action": "service.ping",
  "ok": true,
  "result": {
    "pong": true
  },
  "timestamp": "2026-05-15T00:00:00.000Z"
}

完整动作清单和请求示例见 docs/capacity-list.md。