使用说明
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：
| 包 | 名称 | 描述 |
|---|---|---|
packages/types |
@clavion/types |
共享的TypeScript类型、TxIntent和SkillManifest模式 |
packages/audit |
@clavion/audit |
仅附加审计跟踪服务（SQLite） |
packages/policy |
@clavion/policy |
策略引擎、配置模式、规则评估 |
packages/signer |
@clavion/signer |
钱包服务、加密密钥库、签名管道 |
packages/preflight |
@clavion/preflight |
交易模拟、风险评分 |
packages/registry |
@clavion/registry |
技能清单验证、签名、静态扫描 |
packages/sandbox |
@clavion/sandbox |
基于Docker的容器隔离运行器 |
packages/core |
@clavion/core |
Fastify API服务器、路由处理程序、服务接线 |
packages/adapter-openclaw |
@clavion/adapter-openclaw |
OpenClaw技能包装器和ISCL客户端 |
packages/adapter-mcp |
@clavion/adapter-mcp |
用于Claude Desktop、Cursor和IDE的MCP服务器 |
packages/plugin-eliza |
@clavion/plugin-eliza |
ElizaOS（ai16z）插件，具有5个安全操作 |
packages/adapter-telegram |
@clavion/adapter-telegram |
带有内联审批UI的Telegram机器人 |
packages/cli |
@clavion/cli |
密钥管理CLI（导入、生成、列表） |
packages/sdk |
@clavion/sdk |
用于外部集成的SDK |
快速开始
单线安装
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终点
| 方法 | 路径 | 描述 |
|---|---|---|
GET |
/v1/health |
版本和状态检查 |
POST |
/v1/tx/build |
从TxIntent构建交易 |
POST |
/v1/tx/preflight |
模拟交易并对风险进行评分 |
POST |
/v1/tx/approve-request |
请求人工批准，发放令牌 |
POST |
/v1/tx/sign-and-send |
签名和广播（需要批准令牌） |
GET |
/v1/tx/:hash |
获取交易收据 |
GET |
/v1/balance/:token/:account |
ERC-20或本地余额查询 |
GET |
/v1/approvals/pending |
列出待处理的web审批请求 |
POST |
/v1/approvals/:id/decide |
提交批准/拒绝决定 |
GET |
/v1/approvals/history |
最近的审计事件 |
GET |
/approval-ui |
Web审批仪表板（HTML） |
POST |
/v1/skills/register |
注册技能清单 |
GET |
/v1/skills |
列出已注册的技能 |
GET |
/v1/skills/:name |
按名称获取技能 |
DELETE |
/v1/skills/:name |
撤销已注册的技能 |
文档
详细文档可在 docs/ 目录：
- 快速开始 --5分钟后开始跑步
- 安装指南 --环境变量、策略、Docker
- API 参考 --所有带有示例的端点
- 建筑 --三域信任模型
- 工程规范 --主技术规范
- 威胁模型 --安全分析和缓解措施
- 白皮书 --项目愿景和设计原理
- 集成路线图 --MCP、Telegram、ElizaOS、1英寸及以上
- 用例 --现实世界场景和示例
- 测试指导 --如何运行每个测试类别
安全
Clavion的设计将安全性作为核心架构约束。三域信任模型确保私钥永远不会离开域B，所有事务都经过策略评估和飞行前模拟，沙箱执行完全隔离。
有关报告漏洞和项目安全模型的详细信息，请参阅 安全.md.
贡献
欢迎捐款。请阅读 贡献.md 有关代码风格、测试要求和拉取请求过程的指导方针。
另请参见： 代码_OF_CONDUCT.md 和 总经理.
许可证
麻省理工学院——见 许可证 了解详情。
版权所有（c）2024-2026 Clavion贡献者
