Harness 与 Agent 工程 · MCP与框架接入 · 2026-06-21

OpenClaw不仅仅是聊天框,还是Agent后台引擎,通过API接入现有平台

OpenClaw 作为后台 Agent 引擎,通过 API 无缝集成现有平台,实现告警处理的自动化编排。

核心内容:

  1. API调度模式的适用场景与优势
  2. 在现有平台中直接调用OpenClaw API的实践
  3. Supervisor-Worker模式与MCP工具注册机制的应用

OpenClaw 通常的用法是独立部署——在自己的机器上跑,通过对话框或 Cron 和 Agent 交互。但 OpenClaw 也可以换一种方式用:作为后台 Agent 引擎,由现有业务平台通过 HTTP API 调度它。

一套运维平台,Prometheus 采集指标、AlertManager 发告警、自研 CMDB 管设备,已经稳定运行多年。现在想让告警处理自动化——来了告警自动查设备、算影响、出建议。方案不是把整个平台迁到 OpenClaw,而是在现有平台的告警回调里加一段 HTTP 调用,让平台去调 OpenClaw 的 API。下面讲具体做法。

一、什么场景应该用 API 调度,什么场景不用

应该用的场景

不应该用的场景

二、在现有平台中调度 OpenClaw Agent

2.1 平台端直接调 OpenClaw API

OpenClaw 启动后,Gateway 监听 18789 端口,提供 HTTP API。现有平台不需要中间层,直接 POST 过来:

import requestsOPENCLAW_GATEWAY = "http://localhost:18789"def on_alert(alert_msg: str): """告警回调。直接调 OpenClaw API""" # 创建一个 Session,OpenClaw 会返回 session_id,后续追问可以复用 resp = requests.post( f"{OPENCLAW_GATEWAY}/api/sessions", json={"label": f"告警-{alert_msg[:30]}"}, timeout=10, ) session_id = resp.json()["id"] # 向 Agent 发送消息,OpenClaw 内部走 ReAct Loop 处理 resp = requests.post( f"{OPENCLAW_GATEWAY}/api/sessions/{session_id}/messages", json={ "content": alert_msg, "tools": ["get_device_info", "calculate_impact", "get_topology", "send_wework"], }, timeout=60, ) data = resp.json() # data["reply"] → Agent 的最终回复 # data["tool_calls"] → Agent 调了哪些工具、各返回了什么 return data

平台端不引入 OpenClaw 依赖,不引入 Agent 框架,就是标准 HTTP 调用。

2.2 OpenClaw 端的 Agent 配置

OpenClaw 启动时加载配置文件,定义 Agent 的角色、可用工具和系统提示词:``

## openclaw.config.yamlagents: supervisor: name: 告警调度员 model: claude-sonnet-4-6 system_prompt: | 你是一个告警处理调度器。收到告警后: 1. 分析告警内容,判断需要哪些信息 2. 调用 get_device_info 获取设备详情 3. 调用 get_topology + calculate_impact 评估影响范围 4. 综合以上信息,生成处理建议 5. 调用 send_wework 推送到运维群 工具调用顺序遵循:先查信息,再计算,最后发通知。 tools: - get_device_info - get_topology - calculate_impact - send_wework max_tool_rounds: 5

Agent 的行为全部由 system_prompt 和 tools 列表决定。工具注册在 OpenClaw 的工具目录中,启动时自动加载。

2.3 在 OpenClaw 中注册工具,打通现有平台接口

OpenClaw 的工具是 MCP 协议的标准实现。每个工具一个 Python 文件,放在 tools/目录下:

## tools/get_device_info.pyimport requestsdef run(device_id: str) -> dict: """根据设备ID查询设备详情、历史告警""" resp = requests.get( f"http://cmdb.internal/api/devi…
— 以上为试看内容(约 40%),开通会员后阅读全文 —

原文出处:https://www.53ai.com/news/Openclaw/2026062168250.html