企微 Agent Ops Center

企微 AI Agent 可观测性工具 — 心跳监控、进程守护、敏感信息扫描、网络白名单，2 分钟接入

在企微群里看到你的 AI Agent 在做什么。 实时心跳监控、异常秒级告警、进程自动守护、敏感信息拦截——让 AI 从「黑盒」变「透明」。

WorkBuddy / OpenClaw 用户 2 分钟接入，0 学习成本。

解决什么痛点

你的问题	我们怎么解决
Agent 挂了没人知道，第二天才发现	心跳检测 + 企微群自动告警
不知道 Agent 今天处理了什么任务	任务进度直播 + 每日健康报告
Agent 崩溃后没人重启	进程守护 + 指数退避自动重启
担心 Agent 泄露 API Key	19 种敏感信息规则实时扫描拦截
不确定 Agent 访问了哪些外部服务	网络请求白名单守卫
多个用户/团队的 Agent 数据混在一起	多租户隔离（按 WorkBuddy/OpenClaw 用户 ID 自动分区）
分不清 Agent 来自哪个平台	自动识别平台来源（WorkBuddy / OpenClaw），支持分类统计

v2.4 核心特性

• 🧠 Agent 自动发现：安装 Skill 后自动扫描 ~/.workbuddy/skills/ 下的所有 Agent，批量注册到 Ops Center，零手动配置
• 👥 多租户隔离：按 WorkBuddy/OpenClaw 用户 ID 自动分区，不同用户/团队的 Agent 数据完全隔离
• 🏷️ 平台自动识别：自动检测当前平台（WorkBuddy / OpenClaw），Agent 打上 platform 标签，支持分类统计
• 🛡️ 进程守护：Agent 崩溃后自动重启（指数退避，最多 10 次）
• 🔒 Secrets 扫描：19 种敏感信息规则（API Key / 私钥 / 密码），支持 block / redact / warn 三种模式
• 🌐 网络守卫：Monkey-patch http/https 模块，域名 / IP / CIDR 白名单，阻断非法外联

快速开始

1. 安装

bash

# ClawHub 安装（推荐）
clawhub install wecom-agent-ops-center

# 或本地启动
git clone <repo> && cd wecom-agent-ops-center
npm install

2. 获取企微凭证

text

企微管理后台 → 应用管理 → 智能机器人
→ 创建应用（或选择已有）
→ 复制 Bot ID 和 Bot Secret

3. 配置

bash

cp config.yaml.example config.yaml
# 编辑 config.yaml，填入 bot_id、bot_secret

最小配置（WorkBuddy 用户）：

yaml

wecom:
  bot_id: "你的BotID"
  bot_secret: "你的BotSecret"
# agent-scanner 会自动扫描 ~/.workbuddy/skills/ 并批量注册！

最小配置（OpenClaw 用户）：

yaml

wecom:
  bot_id: "你的BotID"
  bot_secret: "你的BotSecret"
# agent-scanner 会自动扫描 ~/.openclaw/ 并批量注册！

💡 不需要手动注册 Agent。安装后 scanner 自动扫描本地所有 Agent，批量上报到 Ops Center。平台类型（WorkBuddy/OpenClaw）和租户 ID（按用户隔离）全部自动识别。

4. 启动

bash

# 本地开发
node connector.js

# 服务器部署（推荐，开机自启）
sudo systemctl enable --now wecom-agent-ops-center

5. 验证

• 在企微里 @机器人 你好 → Agent 应回复
• 浏览器打开 http://localhost:9527 → 查看 Agent 健康状态
• Agent 离线 3 次心跳后 → 企微群收到告警卡片

命令行

bash

node connector.js              # 启动（监控 + 消息转发）
node connector.js pair         # 生成 P2P 配对码
node connector.js join <CODE>  # 加入 P2P 配对
node connector.js status       # 查看连接状态
node connector.js peers       # 查看已配对节点

环境变量（免配置文件）

bash

export WECOM_BOT_ID=xxx
export WECOM_BOT_SECRET=xxx
export AGENT_ENDPOINT=http://...
export MONITOR_NOTIFY_CHATID=群聊ID
node connector.js

常见问题

Q：和企微自带的 AI 有什么区别？ A：企微自带的是「AI 聊天」。我们是「Agent 运维工具」——不管你的 AI 是谁家的，我们帮你监控它是否正常运行。

Q：我的 Agent 不是 HTTP 端点怎么办？ A：只需提供一个 health check URL（返回 200 即可）。消息转发可以走其他方式，监控走 HTTP。

Q：消息内容会经过你们的服务器吗？ A：消息转换（企微格式 ↔ 标准格式）走云端 API（www.hermesai.ltd），不存储明文。监控数据全部存在本地。也可以设置 converter.enabled: false 完全本地运行。

Q：不用你们监控，我只要消息转发行不行？ A：可以。设置 monitor.enabled: false 降级为纯消息转发模式。

Q：bot_id 和 bot_secret 去哪找？ A：企微管理后台 → 应用管理 → 智能机器人 → 点击应用名称 → 复制「机器人ID」和「Secret」。

Q：notify_chatid 怎么填？ A：企微群里右键群名 → 复制群聊 ID（格式：wrkSFfCgAA...）。填到 config.yaml 的 monitor.notify_chatid。

Q：端口 9527 被占用了怎么办？ A：修改 config.yaml 的 connector.port 为其他端口（如 9528），重启即可。

Q：多个用户共用一个 Ops Center，Agent 数据会混在一起吗？ A：不会。系统按 WorkBuddy/OpenClaw 的用户 ID 自动做多租户隔离，每个用户只能看到自己的 Agent。平台来源（WorkBuddy / OpenClaw）也会自动打标签，方便分类统计。

技术栈

• 语言： Node.js 18+
• WebSocket： ws 库（企微官方智能机器人协议）
• 监控： 自建 AgentMonitor + NotifyEngine（无外部依赖）
• 持久化： 本地 JSON 文件（StateStore）
• 消息转换： 云端 API（www.hermesai.ltd）或本地降级

链接

• 状态面板：http://localhost:9527
• 健康检查：http://localhost:9527/health
• 云端转换 API：https://www.hermesai.ltd/health
• 问题反馈：GitHub Issues

---

🚀 ClawHub 首发：安装后 2 分钟，你的企微群里就能看到 AI Agent 的健康状态。

---

📬 更多资源

📬 更多 AI 企业落地实战案例 → 关注公众号：咕嘟AI
💬 1v1 免费诊断（AI岗位匹配）→ 加微信：GuduTech
🚀 完整 ACE 体系课 + AI 内容系统搭建 → https://hermesai.ltd

用 Ops Center 管好了企微 Agent？欢迎加微信分享你的部署经验 🤖