Axelrod

通过 AIxVC AI 自动化，使用自然语言执行 Base 链上的交易及链上查询。

快速开始

首次配置

1. 在 OpenClaw 配置中配置凭证，路径为 skills.entries.axelrod.env：

{
  "skills": {
    "entries": {
      "axelrod": {
        "enabled": true,
        "env": {
          "AIXVC_ACCESS_KEY": "your_access_key",
          "AIXVC_SECRET_KEY": "your_secret_key"
        }
      }
    }
  }
}

2. 安装依赖项：

pip install -r skills/axelrod/requirements.txt

3. 验证配置：

python skills/axelrod/scripts/axelrod_chat.py --message "check my balance"

核心用法

简单查询

适用于可快速完成的直接请求：

python skills/axelrod/scripts/axelrod_chat.py --message "check my ETH balance"
python skills/axelrod/scripts/axelrod_chat.py --message "what is ETH price now"

JSON 调试模式

用于查看完整的 API 响应内容：

python skills/axelrod/scripts/axelrod_chat.py --message "check my balance" --json

强制工作流

1. 检查 AK/SK — 若缺少 AIXVC_ACCESS_KEY 或 AIXVC_SECRET_KEY，需提示用户配置；严禁猜测或伪造凭证。
2. 运行脚本 — 凡涉及实时链上数据获取或交易执行的请求，必须调用 CLI 执行；不得仅依赖模型内存作答。
3. 返回 stdout — 捕获脚本的标准输出并原样返回给用户。允许轻量级格式化，但不得遗漏关键结果（金额、交易哈希、确认密钥、错误信息等）。
4. 处理确认流程 — 若响应中包含 confirmKey，需引导用户确认或取消（参见下方「确认流程」部分）。

能力概览

交易操作

• 现货买卖/兑换（Spot Buy/Sell/Swap）：在 Base 链上进行代币兑换
• DCA（定投）：美元成本平均法自动化（例如：“DCA 20u 进入 ETH，每日执行”）
• 限价单 / 触发单（Limit/Trigger Orders）：按目标价格或盈亏率触发执行
• RSI 策略：基于 RSI 指标条件触发交易（例如：“若 1 小时 RSI < 30，则买入 100u BTC”）
• 止盈 / 止损（Take-Profit / Stop-Loss）：通过 QUERY_ALGO 实现自动化风控

参考文档：references/api.md

查询操作

• 余额查询（Balance Query）：支持单个代币或全资产组合查询
• 代币信息与分析（Token Info & Analysis）：合约地址、精度（decimals）、链上分析数据等
• 价格查询（Price Query）：实时价格及 24 小时涨跌幅
• 订单查询（Order Query）：查看当前活跃订单列表及详情
• TP/SL 订单查询（TP/SL Order Query）：查看止盈/止损订单状态

区块链助手

• 加密货币/DeFi 领域问答与执行指导
• Base 链交易策略建议

确认流程

订单通常需经过风控确认；小额订单（约 ≤ $10）可能跳过确认步骤。confirmKey 的有效期约为 10 分钟。

当响应中包含 confirmKey 时，请用户发送以下任一指令：

yes, please execute 
no, please cancel 

若该密钥已过期，用户需重新提交原始请求。

当前限制

常见使用模式

交易前检查

# 查询余额
python skills/axelrod/scripts/axelrod_chat.py --message "check my ETH balance"

# 查询价格
python skills/axelrod/scripts/axelrod_chat.py --message "what is ETH price now"

# 执行交易
python skills/axelrod/scripts/axelrod_chat.py --message "buy 50u of ETH"

自动化策略

# DCA 策略
python skills/axelrod/scripts/axelrod_chat.py --message "DCA 20u into ETH every day"

# RSI 条件策略
python skills/axelrod/scripts/axelrod_chat.py --message "if 1h RSI < 30, buy 100u BTC"

# 限价单
python skills/axelrod/scripts/axelrod_chat.py --message "buy ETH when price drops to 2500"

投资组合回顾

# 全资产组合
python skills/axelrod/scripts/axelrod_chat.py --message "check my balance"

# 代币分析
python skills/axelrod/scripts/axelrod_chat.py --message "analyze AXR token for me"

# 订单状态
python skills/axelrod/scripts/axelrod_chat.py --message "show my recent orders"

错误处理

退出码

常见问题

按类别划分的提示词示例

交易类

• "buy 50u of AXR"
• "sell 50% of my ETH"
• "swap 10 SOL to ETH"

自动化策略类

• "DCA 20u into ETH every day"
• "if 1h RSI < 30, buy 100u BTC"
• "buy ETH when price drops to 2500"

投资组合与查询类

• "check my balance"
• "show AXR token info"
• "what is ETH price now"
• "show my recent orders"
• "show my TP/SL orders"

区块链助手类

• "analyze AXR token for me"
• "help me make a Base trading plan"

最佳实践

安全性

1. 切勿泄露您的 AK/SK 凭证
2. 首次使用建议从小额测试开始
3. 大额交易前务必核对代币合约地址
4. 执行前须仔细审阅确认详情

交易建议

1. 交易前先查询余额
2. 明确指定交易数量（如 50u、50%、0.1 ETH）
3. 从小额起步，验证无误后再逐步加仓
4. 优先使用限价单以获得更优入场价
5. 务必设置止盈/止损（TP/SL）以控制风险

API 参考文档

完整 API 接口定义、SigV4 签名协议、请求/响应格式及字段说明，请参阅：

参考文档: references/api.md

实现说明

• 脚本使用 AK/SK 并采用 SigV4 风格签名调用 AIxVC。
• 当前 endpoint：https://api.aixvc.io/gw/openapi/v2/public/twa/agent/chat（参数 chain-id=base）。
• 若文档描述与实际代码行为存在差异，请以脚本实现为准。

文件结构

• SKILL.md — Agent 指令文件（即本文档）。Agent 通过读取此文件理解如何调用该技能。
• README.md — 面向用户的配置与使用指南。
• scripts/axelrod_chat.py — CLI 客户端。始终以如下方式调用：python skills/axelrod/scripts/axelrod_chat.py --message ""。
• references/api.md — 完整 API 接口契约与签名参考文档。
• requirements.txt — Python 依赖项（含 requests）。

故障排查

脚本无法运行

# 确保已安装 Python 3
python --version

# 安装依赖
pip install -r skills/axelrod/requirements.txt

# 测试网络连通性
curl -I https://api.aixvc.io

API 错误

详见上方退出码与常见问题表格。若错误持续存在，请按以下步骤排查：

1. 检查 stderr 输出的错误信息
2. 启用 --json 模式以查看完整 API 响应
3. 确认 AK/SK 配置正确
4. 优先尝试简单查询验证（如 "check my balance"）

💡 提示：最常见的问题是 AK/SK 缺失或错误。遇到任何错误时，请首先验证凭证配置。

⚠️ 安全提醒：请严格保护您的 AK/SK，切勿将其提交至版本控制系统；仅交易您可承受损失的资金。

🚀 快速上手：先执行 "check my balance" 验证环境配置，再尝试小额交易（如 "buy 1u of ETH"），熟悉完整流程。