乐于分享
好东西不私藏

正式开源!opsRobot:OpenClaw 可观测性平台

正式开源!opsRobot:OpenClaw 可观测性平台

点击 KWeaver

设为星标

今天这个项目是 opsRobot,来自爱数集团。

opsRobot 是什么?

opsRobot:OpenClaw 可观测性平台,基于 KWeaver Core 框架开发,使用 OTel 协议、eBPF 技术对智能体进行全链路追踪与监管,提供故障快速排查、安全合规管控及算力精益运营的管理能力,护航 AI 赋能业务的高质量增长

核心特性

全天候观测:让 OpenClaw 的执行过程“白盒化”

  • 核心能力: 构建贯穿全局的观测体系,提供事前(预前自动巡检)、事中(实时监控告警)、事后(精准故障排查)的全生命周期保障。

  • 业务价值 (赋能 IT 运维):全流程透明,彻底告别黑盒排障,确保系统运行状态 100% 可视可控。

风险感知:为 OpenClaw 挂载企业级“刹车系统”

  • 核心能力:建立坚固的安全防线,涵盖实时控制(越权管控、合规校验、风暴拦截)与闭环审计(审计溯源)两大核心机制。

  • 业务价值 (赋能 CIO):坚守系统底线,消除越权调用与数据安全隐患,实现业务执行与安全合规的完美闭环。

生产力评估:让每一分算力投资都清清楚楚

  • 核心能力:依托多维业务核算模型,精准拆解并追踪基础算力、员工个体及业务部门维度的费用消耗情况。

  • 业务价值 (赋能 CEO / CFO):驱动精细化运营,拒绝算力“糊涂账”,将抽象的大模型 Token 直观转化为清晰的业务 ROI。

快速开始

1、环境要求

- Docker Desktop 及 Docker Compose 插件

- Node.js 18+

2、克隆项目

git clone https://github.com/opsrobot-observability/openclaw-observability-platform.git

cd openclaw-observability-platform

3、基于镜像部署后台服务

docker compose -f docker-compose.yml up -d

4、配置 OpenClaw 数据采集

说明:在每个 OpenClaw 运行的机器上安装配置采集器

MacOS 环境的采集器安装:

brew tap vectordotdev/brew && brew install vector

Linux 环境的采集器安装:

CentOS 系统使用 yum 命令安装:

bash -c "$(curl -L https://setup.vector.dev)"

sudo yum install vector

Ubuntu 系统使用 apt-get 命令安装:

bash -c "$(curl -L https://setup.vector.dev)"

sudo apt-get install vector

修改 vector.yaml 采集配置文件:

指向后端服务器 IP 地址(如果与 OpenClaw 在同一台服务中,无需修改):

sinks:

session_to_doris: &sink_template

uri: "http://127.0.0.1:8040/api/opsRobot/agent_sessions/_stream_load"

session_logs_to_doris:

uri: "http://127.0.0.1:8040/api/opsRobot/agent_sessions_logs/_stream_load"

gateway_logs_to_doris:

uri: "http://127.0.0.1:8040/api/opsRobot/gateway_logs/_stream_load"

audit_logs_to_doris:

uri: "http://127.0.0.1:8040/api/opsRobot/audit_logs/_stream_load"

指向实际的 OpenClaw 日志目录,实现日志采集监听:

sources:

 sessions:

  command:

- "sh"

- "-c"

- 'for f in ~/.openclaw/agents/*/sessions/sessions.json; do if [ -f "$$f" ]; then tr -d "\n" < "$$f"; echo ""; fi; done'

 session_logs:

  include:

- "~/.openclaw/agents/*/sessions/*.jsonl"

 gateway_logs:

  include:

- "~/.openclaw/logs/gateway.log"

- "~/.openclaw/logs/gateway.err.log"

 audit_logs:

  include:

- "~/.openclaw/logs/config-audit.jsonl"

启动 Vector 采集器服务

vector --config vector.yaml

5、查看 OpenClaw 的所有观测数据

  • 在 OpenClaw 界面进行对话互动

  • 在 opsRobot 产品界面中查看采集数据:http://localhost:3000

OpenClaw 版本兼容性

本项目目前已基于 OpenClaw 最新版本 完成了开发、功能验证及稳定性测试。为确保各项可观测性指标的准确抓取与展示,建议在以下环境中使用:

支持的部署方式

  • 本地执行 :直接在宿主机上运行

  • Docker 执行 :隔离的 Docker 容器里运行

项目地址

欢迎访问 GitHub 地址:

https://github.com/opsrobot-observability/openclaw-observability-platform

我们欢迎并鼓励任何形式的贡献!无论是提交 Bug 反馈、完善文档,还是提交核心代码的 PR,都是对 opsRobot 开源项目的巨大支持。

欢迎扫码,加入技术交流群~

点击 阅读原文,即可访问 GitHub 项目地址~

点“在看”给我一朵小黄花