clavion (Clavion Xyz)

Clavion/ISCL

为自主代理提供安全的加密运行时

______________________________________________________________________

Clavion是什么？

人工智能代理越来越需要执行链上操作——代币转移、交换、批准和合同交互。但是，让代理直接访问私钥是一个根本的安全风险。一个提示注入、一个恶意技能或一个受损的依赖关系可能会在几秒钟内耗尽钱包。该行业需要一种让代理商在链上操作而无需接触按键的方法。

克拉维昂 （也称为 ISCL——独立安全加密层)通过引入位于代理和区块链之间的本地安全运行时来解决这个问题。它强制执行严格的三域信任架构：代理代码在不受信任的沙箱中运行，没有密钥访问权限，所有交易在签名前都会通过策略引擎和风险评分器，每个操作都会被审计记录，并带有高价值操作的人工批准门。

结果是一个代理可以表达的系统 *意图* （例如，“将100美元兑换成0x……”），而无需构建原始交易或访问私钥。ISCL根据可配置的策略验证意图，模拟风险，在需要时提示人工批准，然后签字并广播。这种架构作为执行后端与OpenClaw和其他代理框架兼容。

建筑

Clavion强制执行三个严格的信任域。每个组件只属于一个域，任何组件都不能跨越边界。

+------------------------------------------------------------------+
|                    Domain A (Untrusted)                           |
|                                                                  |
|   OpenClaw Agent / External Agent Framework                      |
|   +---------------------------+                                  |
|   | Skill Wrappers            |  No keys, no RPC, no signing    |
|   | (adapter-openclaw)        |  Communicates via localhost HTTP |
|   +---------------------------+                                  |
|               | TxIntent (JSON)                                  |
+---------------|--------------------------------------------------+
                v
+------------------------------------------------------------------+
|                    Domain B (Trusted)                             |
|                                                                  |
|   ISCL Core                                                      |
|   +-----------+  +-----------+  +-----------+  +-------------+  |
|   | API       |  | Policy    |  | Preflight |  | Approval    |  |
|   | Server    |  | Engine    |  | Simulator |  | Service     |  |
|   | (Fastify) |  |           |  | + Risk    |  |             |  |
|   +-----------+  +-----------+  +-----------+  +-------------+  |
|   +-----------+  +-----------+  +-----------+  +-------------+  |
|   | Wallet    |  | Tx        |  | Audit     |  | Skill       |  |
|   | Service   |  | Builders  |  | Trace     |  | Registry    |  |
|   | (Keystore)|  |           |  | (SQLite)  |  |             |  |
|   +-----------+  +-----------+  +-----------+  +-------------+  |
|                                                                  |
+------------------------------------------------------------------+
                |
                v
+------------------------------------------------------------------+
|                    Domain C (Limited Trust)                       |
|                                                                  |
|   Sandbox Runner (Docker)                                        |
|   +---------------------------+                                  |
|   | Container Isolation       |  No keys, no network             |
|   | Read-only filesystem      |  API-only communication          |
|   | Seccomp + cap-drop ALL    |  with Domain B                   |
|   +---------------------------+                                  |
|                                                                  |
+------------------------------------------------------------------+

数据流：

Agent Skill -> TxIntent -> /tx/build -> Preflight Simulation
-> Approval Request -> User Confirmation -> WalletService.sign
-> Broadcast -> Receipt -> AuditTrace

主要特点

• 加密密钥库 --使用scrypt+AES-256-GCM加密存储的私钥，从不暴露在域B之外
• 策略引擎 --价值限制、合约/代币分配、链限制和速率限制的可配置规则
• 交易建设者 --根据类型化意图对转移、批准和互换交易进行确定性构造
• 飞行前模拟 --签署前，使用风险评分（7条附加规则，0-100分制）进行交易模拟
• 人类审批门 --具有TTL的一次性批准令牌，用于超过可配置阈值的资金影响操作
• 仅附加审计跟踪 --每个关键步骤都记录到SQLite中，并通过以下方式进行关联 intentId
• 技能注册表 --清单验证、ECDSA签名验证、文件哈希完整性和静态分析扫描
• Docker沙盒 --禁用网络、只读文件系统、seccomp配置文件和所有功能的容器隔离
• 原生ETH和ERC-20支持 --本地ETH和ERC-20代币的转移、批准和交换操作
• 多链支持 --以太坊、乐观主义、Arbitrum和Base，采用每链RPC路由
• Web审批仪表板 --基于浏览器的审批界面，具有风险可视化、余额差异和交易历史记录
• DEX聚合 --Uniswap V3内置，1英寸Swap API v6可选，可自动回退
• 代理集成 --MCP服务器（克劳德桌面，光标），ElizaOS插件，电报机器人，OpenClaw适配器
• 速率限制 --在所有影响基金的端点强制执行每个钱包的交易费率限制

封装结构

Clavion被组织为一个包含以下包的monorepo：

快速开始

单线安装

curl -fsSL https://clavion.xyz/install.sh | bash

或者使用Docker

docker compose up -d clavion

源自源头

先决条件：Node.js 20+，Docker（用于沙箱和安全测试）

git clone https://github.com/clavion-xyz/clavion.git
cd clavion
npm install
npm run build

运行测试

# All tests
npm test

# Unit tests only
npm run test:unit

# Integration tests
npm run test:integration

# Security tests (requires Docker)
npm run test:security

# E2E tests (requires testnet or Anvil fork)
npm run test:e2e

运行开发服务器

# Start the ISCL Core API server (development)
npm run dev

# Start from compiled output (production)
npm start

Docker编写（演示）

# Start all services: Anvil fork, ISCL Core, OpenClaw
docker compose --profile demo up -d

API终点

文档

详细文档可在 docs/ 目录：

• 快速开始 --5分钟后开始跑步
• 安装指南 --环境变量、策略、Docker
• API 参考 --所有带有示例的端点
• 建筑 --三域信任模型
• 工程规范 --主技术规范
• 威胁模型 --安全分析和缓解措施
• 白皮书 --项目愿景和设计原理
• 集成路线图 --MCP、Telegram、ElizaOS、1英寸及以上
• 用例 --现实世界场景和示例
• 测试指导 --如何运行每个测试类别

安全

Clavion的设计将安全性作为核心架构约束。三域信任模型确保私钥永远不会离开域B，所有事务都经过策略评估和飞行前模拟，沙箱执行完全隔离。

有关报告漏洞和项目安全模型的详细信息，请参阅 安全.md.

贡献

欢迎捐款。请阅读 贡献.md 有关代码风格、测试要求和拉取请求过程的指导方针。

另请参见： 代码_OF_CONDUCT.md 和 总经理.

许可证

麻省理工学院——见 许可证 了解详情。

版权所有（c）2024-2026 Clavion贡献者