aios-agent-management-cli

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

功能

• 通过 MQTT 接收管理请求，并返回统一 JSON 响应
• 提供 GET /health 健康检查接口
• 管理 OpenClaw Agent 生命周期，包括创建、启用、停用、删除、模型更新和 AGENTS.md 更新
• 管理全局 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_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"
OC_MANAGEMENT_HOST="0.0.0.0"
OC_MANAGEMENT_PORT="3000"
OC_MANAGEMENT_GATEWAY_RESTART_MODE="container"

如果需要使用 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

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

• HTTP 健康检查：http://0.0.0.0:3000/health
• MQTT 请求主题：默认 aios/admin/inbound
• MQTT 响应主题：默认 aios/admin/outbound

3. 发送管理请求

请求消息格式：

{
  "requestId": "req-001",
  "action": "service.ping",
  "replyTo": "aios/admin/outbound",
  "params": {}
}

响应消息格式：

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

支持的动作包括：

• service.ping
• service.status
• agent.list
• agent.create
• agent.enable
• agent.disable
• agent.delete
• agent.usage
• agent.model.set
• agent.docs.update
• skills.global.list
• skills.global.install
• skills.global.update
• skills.global.delete
• ontology.list
• ontology.create
• ontology.delete
• logs.query
• diagnostics.run
• gateway.status
• gateway.restart

4. 健康检查

curl http://127.0.0.1:3000/health

当配置合法、MQTT 已连接并完成订阅时返回 200，否则返回 503。