人工智能AI AgentAgent 工作流Agent 编排RAG工具调用后端前端【免费下载链接】mateclaw MateClaw — Your second brain with Multi-Agent Orchestration, MCP Protocol, Skills Memory, Dream, and Multi-Channel Support. Built on Spring AI Alibaba.项目地址https://gitcode.com/gh_mirrors/mat/mateclaw点击查看免费下载让 AI 智能体执行 Shell 命令、写文件、连数据库爽是爽但AI 会不会手滑是每个使用者的顾虑。MateClaw 安全配置正是为了解决这个问题它通过Tool Guard工具防护、RBAC 工作区角色、审批流与审计日志四件套给多智能体系统的每一次工具调用划定清晰边界让权限可收敛、危险操作可拦截、全程可追溯。本篇指南带你 5 分钟看懂并配好 MateClaw 的完整安全体系。MateClaw 控制台界面总览左侧 SYSTEM 区域可进入 Security 安全管理模块为什么 AI 智能体必须配安全边界传统软件的行为是写死的而 MateClaw 这类多智能体编排平台的行为是 LLM 动态生成的——Agent 会在运行时自己决定调用哪个工具、传什么参数。这意味着提示注入风险外部网页、文档内容可能教唆Agent 执行危险命令误操作风险rm -rf、DROP TABLE这类命令一旦执行不可逆越权风险访客渠道webchat或团队成员可能碰到不该碰的资源MateClaw 的答案是纵深防御先挡Tool Guard→ 再问审批流→ 少问自动放行白名单→ 最后记下来审计日志并用 RBAC 控制谁能改这些策略。Tool Guard 工具防护两级拦截策略详解核心实现位于 DefaultToolGuard.java所有工具调用在执行前都会经过检查策略分两级拦截级别触发示例处理方式绝对拦截 BLOCKrm -rf /、mkfs、dd of/dev/、curl \| sh直接拒绝任何审批都无法覆盖⚠️需审批 NEEDS_APPROVALgit push --force、chmod 777、DROP TABLE、eval(生成审批请求由人工决定放行✅默认放行 ALLOW其余普通调用正常执行此外还有两条默认策略所有 Shell 命令类工具如run_command无论内容如何都需要审批文件写入类工具write_file、edit_file等同样走审批流。规则管理内置规则 自定义规则工具防护的规则引擎由 ToolGuardEngine.java 编排内置多个专职 Guardian 检查器ShellCommandGuardian命令行危险模式检测WorkspaceBoundaryGuardian/FilePathGuardian路径越界检测FileWriteGuardian文件写入防护CredentialExposureGuardian凭据泄露检测如参数中出现passwordxxxDbRuleGuardian数据库规则匹配每个 Guardian 只负责产出风险发现findings最终裁决由 PolicyResolver 统一做出——检查项互相独立单个 Guardian 异常也不会中断整体防护。在界面安全管理 → 工具防护SecurityController.java 提供全部接口中你可以开关 Guard 总开关配置守护工具范围guardScope与禁用工具名单管理内置规则与自定义规则按类别、严重级别筛选一键导出/导入规则 JSON方便团队间同步安全策略文件防护保护敏感目录File Guard 可独立开关通过sensitivePaths敏感路径配置圈定绝对禁区Agent 的文件写入/编辑操作触碰这些路径会被拦截。配置结构见 ToolGuardConfigEntity.java。建议至少把系统目录、密钥目录如~/.ssh加入敏感路径列表。RBAC 工作区角色四级权限体系MateClaw 的权限模型定义在 RequireWorkspaceRole.java角色等级owner所有者 admin管理员 member成员 viewer查看者角色能力速查角色典型权限所有者 owner工作区全部权限 成员管理管理员 admin管理 Agent/频道/技能修改安全配置Guard 配置、规则、查看审计日志成员 member创建资源、发起对话查看者 viewer只读访问关键设计所有安全接口都标注了RequireWorkspaceRole(admin)也就是说普通成员连看一眼审计日志都不行策略本身不会被低权限用户篡改。管理入口在安全管理 → 成员管理页支持添加成员、调整角色、移除成员。访问控制的底层加固除角色体系外MateClaw 在 SecurityConfig.java 中还做了这些隐形防护JWT 无状态认证除登录、webhook、webchat 等少数公开端点外所有/api/**接口必须携带有效 TokenBCrypt 密码哈希密码不可逆存储且序列化时只写不出杜绝哈希泄露登录限流LoginRateLimitFilter.java 限制同一 IP 每分钟最多 5 次登录尝试防暴力破解SSO 单点登录支持飞书等企业身份源并可通过 Personal Access Token 管理 API 访问凭据审批流危险操作先问人再执行当 Tool Guard 判定为 NEEDS_APPROVAL 时工具调用不会被丢弃而是进入审批流程ApprovalService.java创建待审批记录携带完整调用参数与原因说明在聊天窗口或企业微信/飞书等渠道弹出审批卡片显示要执行的工具与参数人工点批准后调用原样重放执行点拒绝则终止待审批项30 分钟过期自动清理已解决记录保留 1 小时供查询这套状态机刻意做了数据库 消息元数据 内存三方同步ApprovalWorkflowService.java避免服务重启后出现指向已删除会话的幽灵审批。管理端还可以在全局视角查看当前所有待审批项GET /api/v1/security/approvals。自动放行白名单对重复操作说免问每次审批都点一遍很烦MateClaw 提供了**自动审批授权Approval Grant**机制批准某次调用时可以选择记住此操作同类工具调用之后自动放行。但这里有一道不可逾越的底线——AutoGrantSafetyFloor.java 中的冻结安全底线HARD_BLOCK灾难级命令rm -rf /、mkfs、fork 炸弹、系统关机任何授权路径都无法执行FORCE_HUMAN危险但偶有合法用途的操作管道执行脚本、无WHERE的DELETE授权对其无效必须人工审批更有意思的细节参数匹配前会先做归一化处理剥离 ANSI 转义、全角字符转半角、NFKC 规范化即使用r -rf /全角 m或带颜色转义的命令来伪装也会被识别并拦截。审计日志谁在何时做了什么安全体系的最后一环是事后能查。MateClaw 有两层审计能力1. 工具防护审计每次 Guard 裁决都会写入审计日志auditEnabled开关控制可按最低记录等级INFO/LOW/MEDIUM/HIGH/CRITICAL过滤并支持配置保留天数。在安全管理 → 审计日志页可按工具名、裁决结果、会话 ID 检索还能查看统计概览。2. 全局操作审计AuditEventService.java 异步记录所有关键动作——创建/更新/删除 Agent、频道、技能登录登出审批通过/拒绝等每条记录自动附带操作人、时间、IP、User-Agent、所属工作区。两个值得注意的设计异步写入不阻塞业务登录等必须确保落库的场景走同步通道webchat 访客的写操作也被记录actor 形如webchat:channelId:visitorId未登录访客的行为同样可追溯最终所有事件在安全管理 → 活动页合并为一条统一时间线谁在何时对什么资源做了什么点开任意一行即可看到改动 diff 与原始数据。安全配置快速上手清单按这个顺序操作即可从零搭好 MateClaw 的安全基线确认登录入口受保护默认已启用 JWT 认证 登录限流无需额外配置进入安全管理Security 模块界面骨架见 Security/Layout.vue包含工具防护、文件防护、审计日志等分区打开 Tool Guard 与 File Guard把 SSH 目录、密钥文件加入敏感路径审批流保持开启Shell 命令、文件写入默认走审批不建议关闭为高频可信操作配置自动放行冻结安全底线会自动兜底无需担心越权定期查看审计统计与活动时间线把HIGH以上发现当作安全巡检输入总结MateClaw 的安全设计遵循一条清晰的递进链路身份登录/JWT→ 角色RBAC→ 工具边界Tool Guard→ 人工把关审批流 安全底线→ 全程留痕审计日志。对新手而言最重要的认知是这四件套不是孤立的开关而是一套联动机制——Guard 拦下的危险调用会流到审批审批结果会被审计而能修改这些策略的只有工作区管理员。配置一次长期受益。赞分享人工智能AI AgentAgent 工作流Agent 编排RAG工具调用后端前端【免费下载链接】mateclaw MateClaw — Your second brain with Multi-Agent Orchestration, MCP Protocol, Skills Memory, Dream, and Multi-Channel Support. Built on Spring AI Alibaba.项目地址https://gitcode.com/gh_mirrors/mat/mateclaw点击查看免费下载相关推荐CMAK安全最佳实践RBAC权限控制与审计日志配置CMAK安全最佳实践RBAC权限控制与审计日志配置 引言CMAK安全挑战与解决方案 在企业级Kafka集群管理中CMAKCluster Manageme后端消息队列运维开发工具Metallb安全审计API访问控制与审计日志配置Metallb安全审计API访问控制与审计日志配置 在Kubernetes集群中网络负载均衡器的安全性直接关系到整个集群的稳定性和数据安全。Metallb作云原生网络Openblocks安全配置IP白名单和审计日志的完整设置指南Openblocks安全配置IP白名单和审计日志的完整设置指南 Openblocks作为开源的低代码开发平台为企业提供了强大的应用构建能力但 安全配置 始低代码后端前端开发工具创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考