NORNR MCP 控制插件（OpenClaw 专用）

该技能的用途

在 OpenClaw 技能或本地 MCP 连接的动作触发支出、供应商操作或其他具有后续影响的关键步骤之前，使用 NORNR 作为控制层。

最简明准确的理解是：

• 一次本地工具请求 → 对应一个 NORNR 意图
• NORNR 决定该意图是否被批准、进入队列或被拦截
• 进入队列的任务将附带上下文信息，进入指定的审核流程
• 同一动作仍会完整保留在后续的凭证验证（proof）、财务包（finance packet）及审计导出（audit export）中

适用场景

• 技能即将触发采购、订阅或供应商侧付费操作前
• 自主流程需在执行前暂停并等待人工审批时
• 财务或运营团队需要在动作完成后生成一份可追溯、可辩护的决策记录时
• 当提示指令存在可疑特征，或支出行为异常时，应将其标记为待审核状态，而非静默执行

安装

• python -m pip install -r requirements.txt

Hello world

1. 设置环境变量 NORNR_API_KEY。
2. 运行命令： python nornr_governance.py preflight --action purchase --amount-usd 25 --counterparty openai --purpose "Run the paid research action"
3. 若 NORNR 返回 approved，则可继续执行该自主动作。
4. 若 NORNR 返回 approval_required 或 blocked，请立即中止自主流程，并将任务路由至人工审核环节。

一键复制粘贴：MCP / 桌面端配置

在关键本地工具执行前，将 NORNR 设为默认控制层：

• Claude Desktop： nornr mcp claude-config --server-name nornr --agent-id openclaw-agent
• Cursor： nornr mcp cursor-config --server-name nornr --agent-id openclaw-agent

Cursor 规则配置

若允许 Cursor 通过 NORNR 调用本地工具，请将以下内容添加至 .cursorrules 文件中：

在执行关键工具调用前，须经 NORNR 控制层校验。
不得在 NORNR 返回 approved，或指定操作员显式批准已入队意图前，执行任何付费、供应商侧或策略敏感类操作。
将 queued、blocked、anomalous 或 review-required 状态视为自主执行的终止态。

首次运行

1. 设置 NORNR_API_KEY；如需，同时设置 NORNR_AGENT_ID。
2. 运行命令： python nornr_governance.py preflight --action purchase --amount-usd 25 --counterparty openai --purpose "Run the paid research action"
3. 若 NORNR 返回 approved，则可继续执行该动作。
4. 若 NORNR 返回 approval_required 或 blocked，请停止自主流程，并将任务路由至审核环节。

环境变量

仅需以下变量：

• NORNR_API_KEY

以下为可选变量：

• NORNR_BASE_URL（可选，默认为 https://nornr.com）
• NORNR_AGENT_ID 或已保存的 NORNR 登录配置文件

OpenClaw 默认策略包

当 OpenClaw 动作可能触发支出、供应商操作或策略敏感型工具执行时，请从 mcp-local-tools-guarded 策略包起步。目标并非重新设计一套 OpenClaw 专属策略语言，而是将 NORNR 明确确立为自主执行前的默认控制层。

推荐的 API 密钥权限范围

覆盖全部技能功能所需的最小权限集：

• payments:write
• workspace:read
• approvals:write
• events:read
• audit:read

如需支持财务关账（finance-close）路径，请额外添加：

• reports:read
• webhooks:read

依赖项溯源

本技能将治理决策委托给官方 NORNR Python SDK：agentpay。

• 公开 MCP 包仓库：https://github.com/NORNR/nornr-mcp-control
• 安装来源：requirements.txt
• 锁定的 PyPI 包版本：nornr-agentpay==0.1.0
• 本地桥接脚本：nornr_governance.py

如您的环境要求对依赖项进行审查，请在使用前核查所锁定的 SDK 版本。

命令列表

• python nornr_governance.py preflight --action purchase --amount-usd 25 --counterparty openai --purpose "Run the paid research action"
• python nornr_governance.py approvals
• python nornr_governance.py approve --payment-intent-id pi_123 --comment "Approved after review"
• python nornr_governance.py reject --payment-intent-id pi_123 --comment "Rejected pending review"
• python nornr_governance.py anomalies --counterparty openai
• python nornr_governance.py timeline
• python nornr_governance.py finance-packet
• python nornr_governance.py audit-export
• python nornr_governance.py weekly-review
• python nornr_governance.py monthly-close --provider quickbooks
• python nornr_governance.py review-bundle --counterparty openai

为何原始工具执行不足以满足治理需求

原始的 OpenClaw 或 MCP 工具执行仅暴露能力（capability）。NORNR 在能力之上补全了缺失的关键治理层：

• 该动作是否符合当前授权范围（active mandate）？
• 当动作需入队时，应由谁负责审核？
• 后续财务或审计人员可查验哪些信息？

入队（queued）后的处理流程

“入队”不等于“稍后大概率通过”，其真实含义是：

1. 立即中止自主动作执行
2. 检查 review-bundle、anomalies 或 timeline 等输出结果
3. 由指定操作员执行 approve 或 reject
4. 该动作仍将完整保留在后续的 finance-packet、audit-export 或 monthly-close 流程中

建议的演示 GIF 场景

最清晰直观的首次演示应包含以下步骤：

1. 本地智能体提出一项关键动作
2. NORNR 返回 approval_required
3. 客户端主动暂停，而非继续执行
4. 操作员完成人工批准
5. 动作恢复执行，并生成一条具备完整辩护依据的记录

运行规则

除非 NORNR 明确返回 approved，或操作员对已入队意图作出显式批准，否则不得允许 OpenClaw 继续执行该自主动作。所有 queued、blocked、anomalous 或 prompt-risk 状态均应视为需人工审核的状态，而非自主执行的绿灯信号。