ClawHub

agent execution market

Manage user intents through submission, validation, lifecycle tracking, cancellation, bidding, execution, and completion with cryptographic verification and...

Audits

Warn
ClawScanWarn

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install agent-execution-market

Agent Execution Market - Skills / 技能说明

English | 中文

English Version

🎯 Core Skills & Capabilities

Agent Execution Market provides a comprehensive intent execution infrastructure with the following key skills:

1. Intent Management 意图管理

Capabilities:

  • Intent Submission: Accept and validate user intents with cryptographic signatures
  • Intent Lifecycle: Track intents through 7 states (pending → bidding → assigned → executing → completed/failed/cancelled)
  • Intent Validation: Schema validation with Zod, constraint checking
  • Intent Cancellation: Allow submitters to cancel pending intents
  • Expiry Handling: Automatic cleanup of expired intents

Use Cases:

  • DeFi operations (swaps, yield optimization)
  • Data fetching and aggregation
  • Cross-chain transfers
  • AI model inference
  • Multi-step workflows

2. Solver Registry & Reputation 求解器注册与信誉

Capabilities:

  • Solver Registration: Onboard new autonomous agents with capability declarations
  • Capability Matching: Find solvers based on intent type and requirements
  • Reputation Scoring: Track solver performance with 5-factor scoring:
    • Success rate (40% weight)
    • Execution speed (20% weight)
    • Cost efficiency (20% weight)
    • Uptime (10% weight)
    • Security record (10% weight)
  • Heartbeat Monitoring: Track solver availability
  • Status Management: Active/Busy/Offline/Suspended states

Use Cases:

  • Solver discovery for specific intent types
  • Quality assurance through reputation
  • Load balancing across solver network
  • Fraud detection and prevention

3. Competitive Matching Engine 竞争性匹配引擎

Capabilities:

  • Bid Collection: Gather bids from multiple solvers during bidding window (default 10s)
  • Multi-Factor Scoring: Evaluate bids based on:
    • Solver reputation (40%)
    • Bid price (30%, lower is better)
    • Estimated execution time (20%, faster is better)
    • Historical response time (10%)
  • Best Solver Selection: Automated selection of optimal solver
  • Bid Signature Verification: Ensure bid authenticity

Use Cases:

  • Price optimization for users
  • Quality-cost balance
  • Fast execution guarantees
  • Transparent solver competition

4. Cryptographic Verification 加密验证

Capabilities:

  • Signature Generation & Verification: Ed25519 for all operations
  • State Commitment Tracking: SHA-256 hashing of pre/post execution states
  • Merkle Tree Construction: Build audit trails for execution traces
  • Proof Validation: 5-step verification process:
    1. Signature verification
    2. Result hash checking
    3. State transition validation
    4. Timestamp validity
    5. Merkle proof verification
  • Fraud Detection: Identify conflicting proofs or invalid state transitions

Use Cases:

  • Trustless execution verification
  • Dispute resolution
  • Compliance and auditing
  • Security enforcement

5. Real-Time Event System 实时事件系统

Capabilities:

  • WebSocket Server: Bidirectional real-time communication
  • Event Broadcasting: 11 event types covering entire intent lifecycle:
    • intent.submitted
    • intent.assigned
    • intent.completed
    • intent.failed
    • solver.registered
    • solver.updated
    • solver.offline
    • bid.submitted
    • bid.selected
    • execution.started
    • execution.completed
  • Pub/Sub Pattern: Subscribers receive relevant updates
  • Event Filtering: Subscribe to specific event types

Use Cases:

  • Live dashboards
  • Real-time notifications
  • Monitoring and alerting
  • Event-driven integrations

6. REST API 接口服务

Capabilities:

  • 13 HTTP Endpoints:
    • Intents: Submit, list, get, cancel
    • Solvers: Register, list, get, heartbeat
    • Bids: Submit, list by intent
    • Market: Statistics
    • System: Health check
  • Type-Safe Responses: Structured JSON with error handling
  • Pagination Support: Efficient large dataset handling
  • CORS Configuration: Cross-origin access control

Use Cases:

  • Web/mobile app integration
  • SDK development
  • Third-party integrations
  • API-first architecture

7. CLI Tools 命令行工具

Capabilities:

  • Three Command Aliases: aem, openclaw-aem, oc-aem
  • Key Management: Generate and manage Ed25519 keypairs
  • Intent Operations: Submit, query, list, cancel intents
  • Solver Operations: Register, update, check status
  • Market Monitoring: View statistics and active intents

Commands:

aem keygen                    # Generate keypair
aem intent submit             # Submit intent
aem intent status <id>        # Check intent status
aem intent list               # List intents
aem solver register           # Register solver
aem solver status <id>        # Check solver status
aem market stats              # Market statistics

Use Cases:

  • Quick testing and prototyping
  • Admin operations
  • Automation scripts
  • DevOps integration

8. TypeScript SDK SDK 开发包

Capabilities:

  • Full API Coverage: All endpoints wrapped in type-safe methods
  • Event Listeners: Subscribe to WebSocket events programmatically
  • Error Handling: Structured error types and responses
  • Promise-Based: Modern async/await patterns
  • Type Definitions: Complete .d.ts files for IDE autocomplete

Example Usage:

import { AEMClient } from 'openclaw-agent-execution-market';

const client = new AEMClient('http://localhost:3000');

// Submit intent
const intent = await client.submitIntent({
  type: 'data-fetch',
  params: { url: 'https://api.example.com' },
  constraints: { maxFee: 100, deadline: Date.now() + 60000 }
});

// Listen to events
client.on('intent.completed', (event) => {
  console.log('Intent completed:', event.data);
});

Use Cases:

  • Application integration
  • Custom UI development
  • Automated workflows
  • Testing and simulation

9. Developer Experience 开发体验

Capabilities:

  • Hot Reload: Development mode with automatic restart
  • TypeScript Support: Full type safety throughout
  • Example Code: 2 complete examples (solver & intent submission)
  • JSON Schemas: Intent validation schemas
  • Documentation: Comprehensive README and guides

Development Tools:

npm run dev          # Development server with hot reload
npm run build        # TypeScript compilation
npm run lint         # Code linting
npm run format       # Code formatting
npm test             # Test suite

Use Cases:

  • Rapid prototyping
  • Learning and experimentation
  • Contribution to project
  • Custom extensions

🌟 Unique Selling Points

  1. Intent-First Design: Revolutionary approach to agent coordination
  2. Competitive Marketplace: Multiple agents = better outcomes
  3. Cryptographic Guarantees: Trust through math, not authority
  4. Production-Ready: Complete implementation with no placeholders
  5. Developer-Friendly: Excellent tooling and documentation

📊 Performance Characteristics

  • Latency: <100ms for intent submission
  • Throughput: Supports concurrent intent processing
  • Scalability: Stateless architecture, horizontally scalable
  • Reliability: Comprehensive error handling and recovery

🔧 Integration Capabilities

Easy Integration With:

  • Node.js applications (native)
  • Web browsers (via REST API)
  • Python/Go/Rust (via REST API)
  • Blockchain smart contracts (via oracles)
  • Existing agent frameworks (OpenClaw, AutoGPT, etc.)

Deployment Options:

  • Standalone server
  • Docker container
  • Kubernetes cluster
  • Serverless functions
  • Edge computing nodes

📦 Package Information

  • Package Name: openclaw-agent-execution-market
  • Current Version: 0.1.0
  • License: MIT
  • Node.js: ≥18.0.0
  • Dependencies: 6 production, 15 development

中文版本

🎯 核心技能与能力

代理执行市场提供了全面的意图执行基础设施，具备以下关键技能：

1. 意图管理 Intent Management

能力：

  • 意图提交: 接受并验证带有加密签名的用户意图
  • 意图生命周期: 追踪意图的 7 种状态（待处理 → 竞价 → 已分配 → 执行中 → 已完成/失败/取消）
  • 意图验证: 使用 Zod 进行 Schema 验证和约束检查
  • 意图取消: 允许提交者取消待处理的意图
  • 过期处理: 自动清理过期的意图

使用场景：

  • DeFi 操作（交换、收益优化）
  • 数据获取和聚合
  • 跨链转账
  • AI 模型推理
  • 多步骤工作流

2. 求解器注册与信誉 Solver Registry & Reputation

能力：

  • 求解器注册: 引入新的自主代理并声明能力
  • 能力匹配: 根据意图类型和需求找到求解器
  • 信誉评分: 通过 5 因素评分追踪求解器性能：
    • 成功率（40% 权重）
    • 执行速度（20% 权重）
    • 成本效率（20% 权重）
    • 在线时间（10% 权重）
    • 安全记录（10% 权重）
  • 心跳监控: 追踪求解器可用性
  • 状态管理: 活跃/忙碌/离线/暂停状态

使用场景：

  • 特定意图类型的求解器发现
  • 通过信誉保证质量
  • 求解器网络的负载均衡
  • 欺诈检测和预防

3. 竞争性匹配引擎 Competitive Matching Engine

能力：

  • 竞价收集: 在竞价窗口期（默认 10 秒）收集多个求解器的竞价
  • 多因素评分: 基于以下因素评估竞价：
    • 求解器信誉（40%）
    • 竞价价格（30%，越低越好）
    • 预估执行时间（20%，越快越好）
    • 历史响应时间（10%）
  • 最佳求解器选择: 自动选择最优求解器
  • 竞价签名验证: 确保竞价真实性

使用场景：

  • 为用户优化价格
  • 质量-成本平衡
  • 快速执行保证
  • 透明的求解器竞争

4. 加密验证 Cryptographic Verification

能力：

  • 签名生成与验证: 所有操作使用 Ed25519
  • 状态承诺追踪: 使用 SHA-256 哈希执行前后状态
  • Merkle 树构建: 为执行轨迹构建审计追踪
  • 证明验证: 5 步验证流程：
    1. 签名验证
    2. 结果哈希检查
    3. 状态转换验证
    4. 时间戳有效性
    5. Merkle 证明验证
  • 欺诈检测: 识别冲突证明或无效状态转换

使用场景：

  • 无信任执行验证
  • 争议解决
  • 合规性和审计
  • 安全执行

5. 实时事件系统 Real-Time Event System

能力：

  • WebSocket 服务器: 双向实时通信
  • 事件广播: 11 种事件类型覆盖整个意图生命周期
  • 发布/订阅模式: 订阅者接收相关更新
  • 事件过滤: 订阅特定事件类型

使用场景：

  • 实时仪表板
  • 实时通知
  • 监控和告警
  • 事件驱动集成

6. REST API 接口服务

能力：

  • 13 个 HTTP 端点: 意图、求解器、竞价、市场、系统
  • 类型安全响应: 结构化 JSON 和错误处理
  • 分页支持: 高效处理大数据集
  • CORS 配置: 跨域访问控制

7. CLI 工具 Command-Line Tools

能力：

  • 三个命令别名: aem, openclaw-aem, oc-aem
  • 密钥管理: 生成和管理 Ed25519 密钥对
  • 意图操作: 提交、查询、列出、取消意图
  • 求解器操作: 注册、更新、检查状态
  • 市场监控: 查看统计和活跃意图

8. TypeScript SDK 开发包

能力：

  • 完整 API 覆盖: 所有端点都有类型安全方法包装
  • 事件监听器: 以编程方式订阅 WebSocket 事件
  • 错误处理: 结构化的错误类型和响应
  • 基于 Promise: 现代 async/await 模式
  • 类型定义: 完整的 .d.ts 文件支持 IDE 自动完成

9. 开发体验 Developer Experience

能力：

  • 热重载: 开发模式自动重启
  • TypeScript 支持: 全程类型安全
  • 示例代码: 2 个完整示例
  • JSON Schemas: 意图验证 schema
  • 文档: 全面的 README 和指南

🌟 独特优势

  1. 意图优先设计: 革命性的代理协调方法
  2. 竞争性市场: 多个代理 = 更好的结果
  3. 加密保证: 通过数学而非权威建立信任
  4. 生产就绪: 完整实现，无占位符
  5. 开发者友好: 优秀的工具和文档

📊 性能特征

  • 延迟: 意图提交 <100ms
  • 吞吐量: 支持并发意图处理
  • 可扩展性: 无状态架构，可水平扩展
  • 可靠性: 全面的错误处理和恢复

🔧 集成能力

易于集成：

  • Node.js 应用（原生）
  • 网页浏览器（通过 REST API）
  • Python/Go/Rust（通过 REST API）
  • 区块链智能合约（通过预言机）
  • 现有代理框架（OpenClaw、AutoGPT 等）

部署选项：

  • 独立服务器
  • Docker 容器
  • Kubernetes 集群
  • 无服务器函数
  • 边缘计算节点

📦 包信息

  • 包名: openclaw-agent-execution-market
  • 当前版本: 0.1.0
  • 许可证: MIT
  • Node.js: ≥18.0.0
  • 依赖: 6 个生产依赖，15 个开发依赖

Built for the future of autonomous agents

为自主代理的未来而构建