sidclaw-governance-mcp

你的 Agent 会在无人监管的情况下调用工具。SidClaw 会拦截每次工具调用，根据你的策略进行检查，并在高风险操作执行前将其暂缓，等待人工审核。

本地试用（10 秒，无需注册）

npx sidclaw-demo

这会在 http://localhost:3030 打开本地治理仪表板，其中预先加载了四个场景（Claude Code rm -rf、金融科技交易、DevOps 缩容至零、临床实验室医嘱）。无需注册、无需 Docker、无需 API 密钥——只需在浏览器中运行审批卡片界面。

查看实际效果

Agent 想要发送电子邮件 → 策略标记该操作 → 审核者查看完整上下文 → 批准或拒绝 → 记录追踪信息。

适用于你的技术栈

SidClaw 可集成 18 多种框架和平台——包括 OpenClaw（拥有 329K 多名用户）、LangChain、OpenAI、MCP、Claude Agent SDK、Google ADK、NemoClaw、Copilot Studio、GitHub Copilot 等。只需一行代码即可添加治理功能。查看所有集成 →

查看实际效果

客户支持 Agent（金融服务）

AI Agent 想要给客户发送电子邮件。策略将其标记为需要审核。审核者可以查看完整上下文——涉及谁、什么操作、原因——并一键批准。每个步骤都会被追踪。

基础设施自动化（DevOps）

AI Agent 想要扩展生产服务。高风险部署需要人工批准。只读监控可立即进行。

临床决策支持（医疗保健）

AI 助手建议开具实验室检查医嘱。医生审核临床上下文后予以批准。策略会阻止开具药物处方——只有医生可以开处方。

工作原理

Agent wants to act → SidClaw evaluates → Policy decides → Human approves (if needed) → Action executes → Trace recorded

四项基本规则管理每个 Agent 操作：

┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐
│ Identity │ →  │  Policy  │ →  │ Approval │ →  │  Trace   │
│          │    │          │    │          │    │          │
│ Every    │    │ Every    │    │ High-risk│    │ Every    │
│ agent    │    │ action   │    │ actions  │    │ decision │
│ has an   │    │ evaluated│    │ get human│    │ creates  │
│ owner &  │    │ against  │    │ review   │    │ tamper-  │
│ scoped   │    │ explicit │    │ with rich│    │ evident  │
│ perms    │    │ rules    │    │ context  │    │ audit    │
└──────────┘    └──────────┘    └──────────┘    └──────────┘

• allow → 操作立即执行，并记录追踪信息
• approval_required → 人工查看上下文卡片并批准或拒绝，然后记录追踪信息
• deny → 执行前拦截，不访问任何数据，并记录追踪信息

部署你自己的 SidClaw 实例（$0）

Railway 是推荐的一键部署方式——它会同时启动 Postgres、API 和 Dashboard。Vercel 仅托管 Next.js Dashboard；需搭配托管的 API 使用。

https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fsidclawhq%2Fplatform&root-directory=apps%2Fdashboard&env=NEXT_PUBLIC_API_URL&envDescription=Your%20SidClaw%20API%20base%20URL%20(e.g.%20https%3A%2F%2Fapi.sidclaw.com)

不到 3 分钟，即可在 Railway 上启动可用实例。

快速开始 — 选择适合你的方式

选项 1：Claude Code Hooks（零代码）

适用于 Claude Code 用户。每次 Bash、Write、Agent、mcp__* 工具调用都会受到 SidClaw 管控：

# In the SidClaw platform repo
npm run hooks:install

# Then set two env vars
export SIDCLAW_BASE_URL=https://api.sidclaw.com
export SIDCLAW_API_KEY=ai_your_key_here

重启 Claude Code。rm -rf 会暂停并等待批准，git push --force 会被标记，每次工具调用都会记录在哈希链式审计日志中。参见 hooks/README.md。

选项 2：create-sidclaw-app（交互式脚手架）

npx create-sidclaw-app my-agent
cd my-agent
npm start

选项 3：MCP 治理代理（零代码，可包装任意 MCP 服务）

跳转到下方的 MCP 治理代理部分。

选项 4：SDK 包装器（每个工具一行）

// Before: the agent decides, nobody reviews
await sendEmail({ to: "[email protected]", subject: "Follow-up", body: "..." });

// After: wrap with SidClaw — now policies apply
const sendEmail = withGovernance(client, {
  operation: 'send_email',
  data_classification: 'confidential',
}, sendEmailFn);

await sendEmail({ to: "[email protected]", subject: "Follow-up", body: "..." });
// → allow (executes) | approval_required (human reviews) | deny (blocked)

@with_governance(client, GovernanceConfig(
    operation="send_email",
    data_classification="confidential",
))
def send_email(to, subject, body):
    email_service.send(to=to, subject=subject, body=body)

npm install @sidclaw/sdk

import { AgentIdentityClient, withGovernance } from '@sidclaw/sdk';

const client = new AgentIdentityClient({
  apiKey: process.env.SIDCLAW_API_KEY,
  apiUrl: 'https://api.sidclaw.com',
  agentId: process.env.SIDCLAW_AGENT_ID,
});

const sendEmail = withGovernance(client, {
  operation: 'send_email',
  target_integration: 'email_service',
  resource_scope: 'customer_emails',
  data_classification: 'confidential',
}, async (to, subject, body) => {
  await emailService.send({ to, subject, body });
});

await sendEmail('[email protected]', 'Follow-up', 'Hello...');
// allow → executes | approval_required → waits for human | deny → throws

pip install sidclaw

import os
from sidclaw import SidClaw
from sidclaw.middleware.generic import with_governance, GovernanceConfig

client = SidClaw(
    api_key=os.environ["SIDCLAW_API_KEY"],
    agent_id=os.environ["SIDCLAW_AGENT_ID"],
)

@with_governance(client, GovernanceConfig(
    operation="send_email",
    target_integration="email_service",
    data_classification="confidential",
))
def send_email(to, subject, body):
    email_service.send(to=to, subject=subject, body=body)

MCP 治理代理

用策略评估和审批工作流包装任意 MCP 服务。适用于 Claude Desktop、Cursor、VS Code、GitHub Copilot——任何 MCP 客户端。已列入官方 MCP Registry。

添加到你的 .mcp.json：

{
  "mcpServers": {
    "postgres-governed": {
      "command": "npx",
      "args": ["-y", "@sidclaw/sdk", "sidclaw-mcp-proxy", "--transport", "stdio"],
      "env": {
        "SIDCLAW_API_KEY": "ai_your_key",
        "SIDCLAW_AGENT_ID": "your-agent-id",
        "SIDCLAW_UPSTREAM_CMD": "npx",
        "SIDCLAW_UPSTREAM_ARGS": "-y,@modelcontextprotocol/server-postgres,postgresql://localhost/mydb"
      }
    }
  }
}

• SELECT * FROM customers → 允许（额外开销约 50 毫秒）
• DELETE FROM customers WHERE id = 5 → 暂缓，等待人工审批
• DROP TABLE customers → 被策略拒绝

查看完整 MCP 治理文档 →

为什么不直接使用身份验证／沙盒／日志记录？

SidClaw 位于工具调用层：也就是 Agent 决定在现实世界中采取行动的那一刻。

集成

SidClaw 可包装你现有的 Agent 工具——无需更改 Agent 逻辑。

Agent 框架

平台集成

通知渠道

审批请求会发送到团队首选的渠道。审核人员可以直接在聊天中批准或拒绝。

许可

只从 SDK 开始使用？ 你不需要平台。SDK 可独立配合免费的托管 API 使用，地址为 app.sidclaw.com；你也可以自行托管所有组件。

为什么需要 SidClaw

AI Agent 正在投入生产环境，但治理层仍然缺失：

• 73% 的 CISO 担心 AI Agent 带来的风险，但只有 30% 做好了准备（NeuralTrust 2026）
• 79% 的企业 存在盲区，Agent 在无人监督的情况下采取行动
• FINRA 2026 明确要求金融服务领域的 AI Agent 操作必须设置“有记录的人类检查点”
• 《欧盟 AI 法案》 要求高风险 AI 系统实施人工监督、自动日志记录和风险管理——相关义务将分别从 2027 年 12 月 2 日（附件 III）和 2028 年 8 月 2 日（嵌入产品的系统）起适用；这些要求原定于 2026 年 8 月生效，后经 2026 年《数字综合法案》延期
• OpenClaw 拥有 329K+ 个星标和 13,700+ 个技能，但在 ClawHavoc 行动中发现了 1,184 个恶意技能。目前没有策略层来约束技能可以执行的操作。

大型厂商（Okta、SailPoint、WorkOS）负责身份和授权，但它们都没有提供审批环节——也就是在人类看到丰富的上下文并做出知情决策后，Agent 才能采取行动的环节。

合规

SidClaw 对应美国、欧盟、瑞士和新加坡的监管要求：

🇺🇸 FINRA 2026 · 🇪🇺 《欧盟 AI 法案》 · 🇨🇭 FINMA · 🇸🇬 MAS TRM · 🇺🇸 NIST AI RMF · 🌐 OWASP Agentic

平台功能

面向开发者

• 60 秒完成设置——npx create-sidclaw-app 可搭建可运行的受治理 Agent
• 评估开销 <50ms——治理层对用户不可见
• 5 分钟完成集成——封装现有工具，无需更改代码
• 原生支持 MCP——适用于任何 MCP 服务的治理代理
• 框架无关——支持 LangChain、Vercel AI、OpenAI、CrewAI、Pydantic AI、Composio、Claude Agent SDK、Google ADK、LlamaIndex、NemoClaw，或普通函数
• 类型化 SDK——TypeScript（npm）+ Python（PyPI）

面向安全与合规团队

• 策略引擎——按优先级排序和分类层级执行 allow / approval_required / deny
• 审批工作流——提供上下文丰富的卡片，包含 Agent 推理、风险分类和职责分离
• 审计跟踪——包含完整性哈希链的关联追踪（可检测篡改）
• SIEM 导出——支持 JSON 和 CSV，并通过 webhook 持续交付

面向平台团队

• RBAC——设有管理员、审核者、查看者角色，并强制执行相应权限
• 租户隔离——自动为每次查询设置租户范围
• API 密钥管理——支持设置权限范围和轮换密钥
• 速率限制——按租户和端点类别限制
• Webhooks——实时通知审批、追踪和生命周期事件
• 聊天集成——无需打开仪表板，即可通过 Slack、Teams 或 Telegram 批准或拒绝
• 自助注册——支持 GitHub、Google 和电子邮件/密码注册

架构

┌─────────────┐     ┌──────────────┐     ┌──────────────────┐
│ Your Agent  │     │  SidClaw SDK │     │  SidClaw API     │
│             │ ──► │              │ ──► │                  │
│ LangChain   │     │ evaluate()   │     │ Policy Engine    │
│ MCP Server  │     │ withGovern() │     │ Approval Service │
│ OpenAI SDK  │     │ governTools()│     │ Trace Store      │
│ Any tool    │     │              │     │ Webhook Delivery │
└─────────────┘     └──────────────┘     └──────────────────┘
                                                   │
                                          ┌────────┴────────┐
                                          ▼                 ▼
                                ┌──────────────┐  ┌──────────────┐
                                │  Dashboard   │  │ Notifications│
                                │              │  │              │
                                │ Agents       │  │ Slack        │
                                │ Policies     │  │ Teams        │
                                │ Approvals    │  │ Telegram     │
                                │ Traces       │  │ Email        │
                                │ Settings     │  │ Webhooks     │
                                └──────────────┘  └──────────────┘

部署

一键部署

从 GitHub 仓库部署到 Railway。添加 PostgreSQL 数据库，配置环境变量，即可上线。

将仪表板部署到 Vercel（需要单独托管 API）。

自托管（Docker）

curl -sSL https://raw.githubusercontent.com/sidclawhq/platform/main/deploy/self-host/setup.sh | bash

或者手动部署：

git clone https://github.com/sidclawhq/platform.git
cd platform
cp deployment/env.example .env  # edit with your values
docker compose -f docker-compose.production.yml up -d

开发凭据：

• 邮箱：[email protected] / 密码：admin
• 或在登录页面点击 “使用 SSO 登录”，无需密码即可自动登录

托管云服务

无需管理基础设施。前往 app.sidclaw.com 免费开始

请参阅部署文档，了解生产环境配置、环境变量和升级指南。

文档

• 快速入门 — 2 分钟即可完成第一个受治理的操作
• SDK 参考 — 完整记录所有方法
• 集成 — MCP、OpenClaw、NemoClaw、LangChain、OpenAI、Claude Agent SDK、Google ADK、Copilot Studio、GitHub Copilot 等
• 策略指南 — 编写、版本管理和测试
• 合规 — 🇺🇸 FINRA · 🇪🇺 EU AI Act · 🇨🇭 FINMA · 🇸🇬 MAS TRM · 🇺🇸 NIST AI RMF · 🌐 OWASP
• API 参考 — 完整记录所有端点

参与贡献

欢迎贡献！请参阅 CONTRIBUTING.md 了解指南。

SDK（packages/sdk/）采用 Apache 2.0 许可。平台（apps/）采用 FSL 1.1 许可。

许可证

• SDK（packages/sdk/、packages/shared/）：Apache License 2.0 — 可自由用于任何用途
• 平台（apps/api/、apps/dashboard/、apps/docs/、apps/landing/、apps/demo*/）：Functional Source License 1.1 — 源代码可用。不得将其作为竞争性的托管服务提供。2 年后（2028 年 3 月）转为 Apache 2.0。

Links

• Website
• Documentation
• Dashboard
• TypeScript SDK (npm)
• Python SDK (PyPI)
• Python SDK (GitHub)
• create-sidclaw-app (npm)
• GitHub Action
• GitHub App
• Contact