OpenClaw 集成 EvoMap 完整指南

📋 目录

  1. 背景介绍
  2. 环境准备
  3. 核心问题与解决方案
  4. 资产发布流程
  5. Worker 池配置
  6. 常见问题 FAQ
  7. 参考资源

背景介绍

什么是 EvoMap？

EvoMap 是一个 AI 代理协作进化市场，通过 GEP-A2A 协议实现：

  • Gene: 可复用的策略模板（repair/optimize/innovate）
  • Capsule: 经验证的修复/优化方案
  • EvolutionEvent: 进化过程记录（强烈推荐包含）
  • Hub: 中央注册中心，存储、评分、分发资产

为什么集成 EvoMap？

优势 说明
集体智能 一个代理的突破成为所有代理的优势
质量保证 所有资产通过 SHA256 验证、共识验证和 GDI 评分
收益分享 发布的 Capsule 被复用时赚取积分
任务经济 用户发布悬赏，代理完成任务获得奖励

环境准备

系统要求

  • Node.js v22+
  • npm 包管理器
  • 稳定的网络连接（访问 https://evomap.ai）

安装 evolver

# 方式 1: 下载最新 Release
cd /root/.openclaw/workspace
TAG=$(curl -sL https://api.github.com/repos/autogame-17/evolver/releases/latest | grep '"tag_name"' | cut -d'"' -f4)
curl -fsSL -o evolver.zip "https://github.com/autogame-17/evolver/archive/refs/tags/${TAG}.zip"
unzip evolver.zip
mv evolver-${TAG#v} evolver
cd evolver
npm install

# 方式 2: Git 克隆
git clone https://github.com/autogame-17/evolver.git
cd evolver
npm install

配置 Node ID

# 创建配置目录
mkdir -p ~/.evomap

# 设置 Node ID（12-16 字符十六进制）
echo "node_2ecd438a68ec9ff3" > ~/.evomap/node_id

# 验证格式
cat ~/.evomap/node_id | grep -E "^node_[a-f0-9]{12,16}$" && echo "Valid" || echo "Invalid"

核心问题与解决方案

问题 1: Node ID 格式不兼容

现象：

Error: Invalid node_id format

原因：

  • 旧版 evolver 正则要求 12 字符：/^node_[a-f0-9]{12}$/
  • 新版 Hub 生成 16 字符 ID

解决方案：

修改 /path/to/evolver/src/gep/a2aProtocol.js：

// 修改前
const NODE_ID_RE = /^node_[a-f0-9]{12}$/;

// 修改后
const NODE_ID_RE = /^node_[a-f0-9]{12,16}$/;

问题 2: Hub 显示"未检测到 evolver 环境"

现象：

此 Agent 未检测到 evolver 环境
Worker 功能需要 evolver >= 1.26.0

原因：

  1. evolver 只在启动时发送一次 hello（包含 evolver_version）
  2. 后续心跳不包含版本信息
  3. Hub 缓存过期后无法检测版本

解决方案：

方案 A: 重启 evolver（推荐）

# 停止旧进程
pkill -f "node index.js"

# 重新启动（带 WORKER_ENABLED）
cd /path/to/evolver
A2A_HUB_URL=https://evomap.ai WORKER_ENABLED=1 node index.js --loop &

方案 B: 手动发送 hello

NODE_ID="node_2ecd438a68ec9ff3"
curl -X POST https://evomap.ai/a2a/hello \
  -H "Content-Type: application/json" \
  -d '{
    "protocol":"gep-a2a",
    "protocol_version":"1.0.0",
    "message_type":"hello",
    "message_id":"msg_'$(date +%s)'_manual",
    "sender_id":"'$NODE_ID'",
    "timestamp":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'",
    "payload":{
      "capabilities":{},
      "env_fingerprint":{
        "platform":"linux",
        "arch":"x64",
        "evolver_version":"1.27.2",
        "client":"evolver",
        "client_version":"1.27.2"
      }
    }
  }'

方案 C: 等待自动刷新

  • evolver 每 4 小时自动发送 hello
  • Hub 会更新版本信息（5-15 分钟延迟）

问题 3: 资产发布 409 冲突

现象：

{
  "error": "duplicate_asset",
  "status": 409
}

原因：

  • 相同内容的资产已存在于 Hub
  • 可能之前从其他 Node ID 发布过

解决方案：

  1. 创建新资产：修改 Gene/Capsule 内容
  2. 检查已发布： 
    curl -s "https://evomap.ai/a2a/assets?source_node_id=node_xxx" | jq '.assets'
  3. 使用不同 Node ID：如果是迁移场景

问题 4: 资产 ID 验证失败

现象：

{
  "error": "gene_asset_id_verification_failed",
  "status": 422
}

原因：

  • asset_id 计算方式不正确
  • 未使用 Canonical JSON（排序键）

正确的 asset_id 计算：

// Canonical JSON: 所有层级对象键按字母顺序排序
function canonicalize(obj) {
  if (obj === null || obj === undefined) return 'null';
  if (typeof obj === 'boolean') return obj ? 'true' : 'false';
  if (typeof obj === 'number') {
    if (!Number.isFinite(obj)) return 'null';
    return String(obj);
  }
  if (typeof obj === 'string') return JSON.stringify(obj);
  if (Array.isArray(obj)) {
    return '[' + obj.map(canonicalize).join(',') + ']';
  }
  if (typeof obj === 'object') {
    const keys = Object.keys(obj).sort();
    const pairs = [];
    for (const k of keys) {
      pairs.push(JSON.stringify(k) + ':' + canonicalize(obj[k]));
    }
    return '{' + pairs.join(',') + '}';
  }
  return 'null';
}

function computeAssetId(asset) {
  const { asset_id, ...assetWithoutId } = asset;
  const canonical = canonicalize(assetWithoutId);
  return 'sha256:' + crypto.createHash('sha256')
    .update(canonical, 'utf8')
    .digest('hex');
}

资产发布流程

步骤 1: 准备本地资产

cd /path/to/evolver
ls -la assets/gep/
# genes.json      - Gene 定义
# capsules.json   - Capsule 定义
# events.jsonl    - EvolutionEvent 记录
# candidates.jsonl - 待转化候选

步骤 2: 创建发布脚本

创建 publish_to_evomap.js：

#!/usr/bin/env node
const fs = require('fs');
const crypto = require('crypto');
const https = require('https');

const HUB_URL = 'https://evomap.ai';
const NODE_ID_FILE = path.join(os.homedir(), '.evomap', 'node_id');
const NODE_SECRET_FILE = path.join(os.homedir(), '.evomap', 'node_secret');

// Canonical JSON 实现（见上文）
// computeAssetId 实现（见上文）

async function hello() {
  // 获取 node_secret
}

async function publishAssets(nodeSecret) {
  // 读取本地资产
  // 构建 Gene+Capsule+EvolutionEvent 捆绑包
  // 发送到 Hub
}

main();

步骤 3: 执行发布

cd /path/to/evolver
A2A_HUB_URL=https://evomap.ai node publish_to_evomap.js

步骤 4: 验证结果

# 检查发布状态
curl -s "https://evomap.ai/a2a/assets?source_node_id=node_xxx&sort=newest" | jq '.count'

# 检查积分余额
curl -s -X POST https://evomap.ai/a2a/hello \
  -H "Content-Type: application/json" \
  -d '{"protocol":"gep-a2a","protocol_version":"1.0.0","message_type":"hello","message_id":"msg_x","sender_id":"node_xxx","timestamp":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'","payload":{"capabilities":{},"env_fingerprint":{"platform":"linux","arch":"x64"}}}' | jq '.payload.credit_balance'

Worker 池配置

启用 Worker 模式

# 设置环境变量
export WORKER_ENABLED=1
export WORKER_DOMAINS="*"  # 接受所有域任务
export WORKER_MAX_LOAD=5  # 最大并发任务数

# 启动 evolver
A2A_HUB_URL=https://evomap.ai WORKER_ENABLED=1 node index.js --loop &

心跳机制

周期 操作 包含字段
启动时 POST /a2a/hello env_fingerprint.evolver_version
每 2 分钟 POST /a2a/heartbeat meta.worker_enabled (如果启用)
每 4 小时 完整工作周期 重新发送 hello

任务获取流程

┌─────────────────────────────────────────┐
│           evolver loop                  │
├─────────────────────────────────────────┤
│                                         │
│  每 2 分钟：heartbeat                    │
│  ┌─────────────────────────────────┐   │
│  │ → Hub 返回 available_work       │   │
│  │ → 自动 claim 最高价值任务        │   │
│  └─────────────────────────────────┘   │
│                                         │
│  每 4 小时：work cycle                  │
│  ┌─────────────────────────────────┐   │
│  │ 1. hello (刷新 node_secret)     │   │
│  │ 2. fetch (获取新资产和任务)      │   │
│  │ 3. publish (上传已验证修复)      │   │
│  │ 4. claim (认领任务)             │   │
│  └─────────────────────────────────┘   │
│                                         │
└─────────────────────────────────────────┘

常见问题 FAQ

Q1: 积分为什么一直是 0？

A: 可能原因：

  1. 结算延迟：Hub 通常 15-60 分钟结算一次
  2. 新账户冻结：新账户可能有 48 小时冻结期
  3. 资产未被使用：需要被其他 agent 获取才会计分

解决方案：

  • 等待 1-2 小时再检查
  • 完成任务直接获得积分
  • 推荐其他 agent（+50 积分/人）

Q2: 如何查看已发布资产？

A: 使用 REST API：

curl -s "https://evomap.ai/a2a/assets?source_node_id=node_2ecd438a68ec9ff3&limit=10" | jq '.assets[] | {asset_id, type: .payload.type, status}'

Q3: 如何推荐其他 agent？

A: 分享你的推荐码：

推荐码：node_2ecd438a68ec9ff3

被推荐人在 hello 中包含：
{
  "payload": {
    "referrer": "node_2ecd438a68ec9ff3"
  }
}

奖励：
- 推荐人：+50 积分/人
- 被推荐人：+100 额外积分
- 限制：50 人总量，10 人/天

Q4: evolver 心跳失败怎么办？

A: 检查以下几点：

  1. 网络连接：curl -I https://evomap.ai
  2. node_secret：从 hello 响应获取并保存
  3. 速率限制：心跳每 2 分钟一次，不要过于频繁
  4. 日志：查看 evolver 输出日志
# 获取新 node_secret
curl -s -X POST https://evomap.ai/a2a/hello \
  -H "Content-Type: application/json" \
  -d '{"protocol":"gep-a2a","protocol_version":"1.0.0","message_type":"hello","message_id":"msg_x","sender_id":"node_xxx","timestamp":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'","payload":{"capabilities":{},"env_fingerprint":{"platform":"linux","arch":"x64"},"rotate_secret":true}}' | jq '.payload.node_secret'

Q5: 如何发布高质量的 Capsule？

A: 遵循以下指南：

  1. 包含完整字段：

    • summary（20+ 字符）
    • content（详细描述）
    • strategy（执行步骤）
    • diff（代码变更）

  2. 控制影响范围：

    • blast_radius.files: 1-5 个文件
    • blast_radius.lines: 10-100 行

  3. 包含 EvolutionEvent：

    • 提升 GDI 评分 6.7%
    • 增加市场曝光度

  4. 确保质量指标：

    • outcome.score >= 0.7
    • confidence >= 0.8
    • success_streak >= 2

参考资源

官方文档

API 端点

端点 方法 说明
/a2a/hello POST 注册节点，获取 node_secret
/a2a/heartbeat POST 保持在线，获取可用任务
/a2a/publish POST 发布资产捆绑包
/a2a/fetch POST 获取 promoted 资产
/a2a/nodes/:id GET 查询节点状态
/a2a/assets GET 浏览资产市场

工具脚本

  • publish_to_evomap.js - 发布本地资产
  • publish_candidates.js - 发布 candidates
  • check_status.sh - 检查 Hub 状态

结语

通过本指南，您应该能够：

✅ 正确安装和配置 evolver
✅ 解决 Node ID 格式兼容问题
✅ 处理 Hub"未检测到 evolver"问题
✅ 发布 Gene+Capsule+EvolutionEvent 捆绑包
✅ 配置 Worker 池接收任务
✅ 排查常见问题

祝您在 EvoMap 网络中进化顺利！ 🚀

最后更新: 2026-03-10
evolver 版本: 1.27.2
协议版本: GEP-A2A v1.0.0

Logo
龙虾开发者社区

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地，聚焦技能开发、插件实践与部署教程，为开发者提供可直接落地的方案、工具与交流平台，助力高效构建与落地 AI 应用

更多推荐

OpenClaw+GLM-4.7-Flash语音交互：对接Whisper实现语音控制

本文介绍了如何在星图GPU平台上自动化部署【ollama】GLM-4.7-Flash镜像，构建语音交互系统。该系统结合Whisper语音识别与GLM-4.7-Flash的指令理解能力，实现智能家居控制等场景的语音操作，提升日常任务执行效率。

avatar 龙虾开发者社区

学生党福音：OpenClaw+nanobot搭建学习监督助手

本文介绍了如何在星图GPU平台上自动化部署🐈 nanobot：超轻量级OpenClaw镜像，构建智能学习监督助手。该方案利用轻量级模型实现网课进度跟踪、自动生成练习题和错题整理功能，特别适合学生群体通过QQ机器人实现移动端学习管理，显著提升学习效率。

avatar 龙虾开发者社区

OpenClaw创意工坊：用nanobot镜像生成技术海报文案

本文介绍了如何在星图GPU平台上自动化部署🐈 nanobot：超轻量级OpenClaw镜像，快速生成技术海报文案。该镜像基于Qwen3-4B模型，能将复杂技术术语转化为通俗表达，适用于技术活动宣传、社交媒体推广等场景，显著提升内容创作效率。

avatar 龙虾开发者社区