octoguard-openclaw-security-governance

OctoGuard 是 ara.so 的 Security Skills 集合中面向 OpenClaw（Lobster AI）的安全治理与审计系统。它作为透明代理运行，不修改 OpenClaw 的核心功能，实时监控用户对话、工具调用和执行结果，在检测到高风险行为时执行安全策略并发送告警。

用途 OctoGuard 用于对 OpenClaw 智能体的运行过程进行安全监管，包括策略拦截、Token 监控、审计记录、告警通知以及网关控制。

主要能力

基于策略的拦截：在执行前阻止敏感文件访问、危险操作和高风险命令。
Token 监控：跟踪各会话的 Token 消耗，并基于阈值触发告警。
审计日志：记录通过 OpenClaw 处理的所有事件，包括被允许和被阻止的操作。
告警通知：在发生安全事件时通过钉钉、企业微信和邮件发送通知。
可视化仪表盘：提供安全态势可视化与 OpenClaw 网关控制。
非侵入式设计：与 OpenClaw 并行工作，无需修改代码。

架构 OctoGuard 由以下部分组成：

后端：基于 Node.js 的策略引擎和 API 服务器。
前端：用于策略管理和监控的 Vue.js 仪表盘。
数据库：存储策略、审计日志和 Token 指标。
安全代理：拦截并评估 OpenClaw 请求。

安装与配置前置条件：需要 Node.js 14+、MySQL/PostgreSQL 数据库，以及已安装且可访问的 OpenClaw。

后端安装：

git clone https://github.com/O-ozzz/OctoGuard--Free-OpenClaw-Security-Supervision-System.git
cd OctoGuard--Free-OpenClaw-Security-Supervision-System/backend
npm install
cp .env.example .env

环境配置（backend/.env）包含服务器端口、数据库连接、OpenClaw 集成、告警通知（钉钉、企业微信、邮件 SMTP）以及 Token 监控阈值等参数。

数据库初始化：

npm run migrate
npm run seed

启动服务：

cd backend
npm start

前端需在单独终端中安装依赖并运行：

cd frontend
npm install
npm run serve

生产部署可使用 PM2 启动后端，并构建前端：

cd frontend
npm run build
npm install -g pm2
cd backend
pm2 start server.js --name octoguard
pm2 save
pm2 startup

代理设置：需配置 OpenClaw 通过 OctoGuard 路由，示例配置包含 proxy 的 host、port、path 以及 security 的 auditEnabled、blockingMode 等字段。

策略引擎配置：可通过 API 或仪表盘创建安全策略，示例包括阻止敏感文件访问（如 /etc/passwd、.env、.ssh 路径）和阻止危险命令（如 rm -rf、curl 管道 bash、chmod 777 等）。

API 使用

创建安全策略：向 /api/policies 发送 POST 请求，包含 name、type、enabled、rules、alertOnBlock、notificationChannels 等字段。
查询审计日志：向 /api/audit/logs 发送 GET 请求，支持 page、limit、action、severity、startDate、endDate 等过滤参数。
监控 Token 使用：向 /api/tokens/metrics 发送 GET 请求，返回 total、sessions、threshold、alerts 等数据。
控制 OpenClaw 网关：向 /api/gateway/control 发送 POST 请求，action 可为 stop、start、restart、status。

常见模式

实时请求监控：通过 WebSocket 连接 /api/monitor/stream，处理 request、blocked、token_threshold 等事件类型。
动态策略更新：通过 PATCH /api/policies/{policyId} 更新规则。
自定义告警处理：通过 POST /api/alerts/webhook 配置自定义 Webhook，接收 blocked、critical 等事件。
批量策略管理：通过 POST /api/policies/bulk 执行 enable、disable、delete 操作。

仪表盘访问 Web 界面默认地址为 http://localhost:8080，初始凭据在初始设置时设定，建议立即通过 /api/auth/change-password 修改密码。

故障排查文档涵盖策略未拦截、Token 消耗过高、告警未发送、数据库连接问题、OpenClaw 网关无响应等常见问题的排查方法，包括验证策略启用状态、检查正则表达式、确认阻塞模式、识别高消耗会话、测试通知渠道、测试数据库连接以及诊断网关健康状态。

安全最佳实践部署后立即更改默认凭据；所有敏感配置使用环境变量；生产环境启用 HTTPS；定期轮换 API 密钥；每日监控审计日志；根据使用模式设置合适的 Token 阈值；在强制执行前以非阻塞模式测试策略；定期备份策略和审计日志。

支持问题与功能请求可通过 GitHub Issues（https://github.com/O-ozzz/OctoGuard--Free-OpenClaw-Security-Supervision-System/issues）、邮箱 1710628464@qq.com 或 X/Twitter @LYtow9610 反馈。

限制资料未提供关于收费、价格、平台兼容性、性能效果或具体使用步骤的更多信息。

技能介绍