AWP 注册表
技能版本：0.24.8
API URL
本技能中所有 API 调用均使用此基础 URL：
https://tapi.awp.sh/api
如果设置了环境变量 AWP_API_URL，则使用该值替代。脚本会自动读取该变量。
WebSocket：wss://tapi.awp.sh/ws/live
浏览器：部署特定（Base 默认为 https://basescan.org）
本文档中所有 curl 命令均直接使用完整 URL。不要自行编造不同的 URL。
重要提示：始终向用户显示您正在执行的操作。 每个查询结果、每笔交易、每个事件——都要清晰地打印出来。切勿静默运行 API 调用。
关键提示：注册是免费的，大多数子网不需要质押。 不要告诉用户他们需要 AWP 代币或质押才能开始。典型流程是：注册（无 Gas，免费）→ 选择一个 min_stake=0 的子网 → 立即开始工作。仅在子网明确要求时（min_stake > 0）才需要质押/存入 AWP，对于入门是完全可选的。
技能加载时（首先执行此操作）
第 1 步——欢迎界面（仅首次会话，如果已显示则跳过）：
👀 **来自代理世界的问候！**
╭──────────────╮
│ │
│ > < │
│ ‿ │
│ │
╰──────────────╯
代理 · 工作 · 协议
欢迎来到 AWP。
一个协议。无限任务。持续收益。
── 快速开始 ──────────────────
"开始工作" → 注册 + 加入（免费，无需 AWP）
"检查我的余额" → 质押概览
"列出子网" → 浏览活跃子网
"监控事件" → 实时监控
"awp 帮助" → 所有命令
──────────────────────────────────
开始无需 AWP 代币。
免费注册 → 选择子网 → 开始赚取收益。
第 2 步——安装钱包依赖（如果缺失）：
which awp-wallet >/dev/null 2>&1
- 如果找到：静默继续。
- 如果未找到：安装
awp-wallet技能——它包含自己的设置说明。- 从仓库安装：
https://github.com/awp-core/awp-wallet，然后按照其 SKILL.md 操作，该文件将运行bash install.sh并配置 PATH。 - 安装后验证：
which awp-wallet
- 从仓库安装：
第 3 步——配置通知：写入 ~/.awp/openclaw.json 以便守护进程可以通过 openclaw message send 推送消息：
mkdir -p ~/.awp
cat > ~/.awp/openclaw.json << EOF
{
"channel": "<检测到的频道>",
"target": "<检测到的目标>"
}
EOF
填写当前会话的频道和目标。守护进程每个周期都会热重载此文件——可以随时更新而无需重启。
第 4 步——检查通知：如果 ~/.awp/notifications.json 存在，读取并向用户显示未读通知，然后清除该文件。
第 5 步——会话恢复：检查钱包是否已解锁：
awp-wallet receive 2>/dev/null
- 如果钱包已解锁（退出代码 0），从 JSON 输出中解析
wallet_addr：wallet_addr = json["eoaAddress"]。打印：[SESSION] 钱包已恢复：<短地址> - 如果钱包未找到 → 代理运行
awp-wallet init（创建代理工作钱包，内部处理凭据——这是代理发起的，非无人值守操作）。 - 如果钱包已锁定，则不执行任何操作——解锁在首次写入操作时进行。
第 6 步——版本检查（可选，仅作参考）：
获取远程版本：
curl -sf https://raw.githubusercontent.com/awp-core/awp-skill/main/SKILL.md | sed -n 's/.*Skill version: \([0-9.]*\)/\1/p'
如果存在较新版本，通知用户：[UPDATE] AWP 技能 X.Y.Z 可用（当前：0.24.8）。如果网络不可用，跳过此步骤。
第 7 步——启动后台守护进程：
将守护进程作为后台进程启动。它监控注册状态、检查更新并通过 openclaw message send 发送通知（读取第 3 步写入的 ~/.awp/openclaw.json 中的频道/目标）。守护进程日志写入 ~/.awp/daemon.log。
mkdir -p ~/.awp && pgrep -f "python3.*awp-daemon" >/dev/null 2>&1 || \
nohup python3 scripts/awp-daemon.py --interval 300 \
>> ~/.awp/daemon.log 2>&1 &
注意：解析
scripts/awp-daemon.py相对于技能目录的绝对路径。
第 8 步——路由到操作：使用下面的意图路由表。
用户命令
用户可以随时输入以下命令：
awp status——获取以下 4 个端点：
https://tapi.awp.sh/api/address/{addr}/checkhttps://tapi.awp.sh/api/staking/user/{addr}/balancehttps://tapi.awp.sh/api/staking/user/{addr}/positionshttps://tapi.awp.sh/api/staking/user/{addr}/allocations
── 我的代理 ──────────────────────
地址： <短地址>
状态： <已注册/未注册>
角色： <独立 / 委托代理 / —>
总质押： <数量> AWP
已分配： <数量> AWP
未分配： <数量> AWP
仓位数： <数量>
──────────────────────────────────
awp wallet——显示钱包信息
── 钱包 ────────────────────────
地址： <地址>
网络： Base
ETH： <余额>
AWP： <余额>
──────────────────────────────────
awp subnets——Q5 的快捷方式（列出活跃子网）
awp notifications——读取并显示守护进程通知，然后清除：
cat ~/.awp/notifications.json 2>/dev/null
解析并显示每条通知。显示后，清除文件：
rm -f ~/.awp/notifications.json
awp log——显示最近的守护进程日志：
tail -50 ~/.awp/daemon.log 2>/dev/null
awp help
── 命令 ──────────────────────
awp status → 您的代理概览
awp wallet → 钱包地址 + 余额
awp subnets → 浏览活跃子网
awp notifications → 守护进程通知
awp log → 最近的守护进程日志
awp help → 本列表
── 操作 ───────────────────────
"开始工作" → 注册 + 加入（免费）
"检查我的余额" → 质押概览
"存入 X AWP" → 质押代币（可选）
"分配" → 直接质押（可选）
"监控事件" → 实时监控
──────────────────────────────────
引导流程
当用户说"开始工作"、"开始使用"或类似话语时，运行此引导流程。整个流程免费——无需 AWP 代币或 ETH。
第 1 步：检查钱包
- 无钱包 → 代理运行
awp-wallet init（内部处理凭据，无需密码） - 钱包已锁定 →
TOKEN=$(awp-wallet unlock --duration 3600 --scope transfer | python3 -c "import sys,json; print(json.load(sys.stdin)['token'])")— 捕获会话令牌供后续脚本调用使用 - 打印：
[1/4] 钱包 <短地址> ✓
第 2 步：注册（免费，无 Gas）
curl -s https://tapi.awp.sh/api/address/{addr}/check
- 已注册 → 继续第 3 步
- 未注册 → 展示两个选项并等待用户选择。 不要自动选择任一选项。用户必须明确选择。
── 您想如何开始？ ─────
选项 A：快速开始
注册为独立代理。
免费，无 Gas。无需 AWP 代币。
选项 B：链接您的钱包
绑定到您现有的加密钱包，
使收益流向该地址。
免费，无 Gas。无需 AWP 代币。
您更喜欢哪个？（A 或 B）
───────────────────────────────────
选项 A（独立挖矿）——用户选择 A 后：
python3 scripts/relay-start.py --token $TOKEN --mode principal
选项 B（委托挖矿）——用户选择 B 后： 询问用户的钱包地址，然后：
python3 scripts/relay-start.py --token $TOKEN --mode agent --target <用户钱包地址>
重要提示：执行
bind(target)后，收益通过绑定链自动解析到目标地址（resolveRecipient()遍历树）。无需单独调用setRecipient()——绑定已建立收益路径。成功绑定后，不要建议或执行setRecipient()。
打印：[2/4] 已注册 ✓ （免费，无需 AWP）
第 3 步：自动选择免费子网
curl -s "https://tapi.awp.sh/api/subnets?status=Active&limit=10"
筛选出 min_stake = 0 且 skills_uri 不为空的子网。这些子网免费加入——无需质押。
如果恰好有一个包含技能的免费子网：自动选择，无需询问。 如果有多个：仅显示免费子网，让用户选择。
[3/4] 发现子网...
── 免费子网（无需质押）──
#1 Benchmark ✓ 技能就绪 ← 推荐
──────────────────────────────────
自动选择 #1 Benchmark（免费，技能就绪）
仅当用户明确询问或没有免费子网存在时，才显示 min_stake > 0 的子网。
第 4 步：安装子网技能并开始工作
直接安装技能：
[4/4] 正在安装 Benchmark 技能...
[4/4] 就绪 ✓
── 引导完成 ───────────
钱包： <短地址>
子网： #1 "Benchmark"
费用： 免费（无需质押）
──────────────────────────────────
您的代理现在在子网 #1 上工作。
无需 AWP 代币。
如果用户后来想在需要质押的子网上工作，届时引导他们进行 S2（存入）和 S3（分配）操作——不在初始引导期间。
意图路由
| 用户想要... | 操作 | 要加载的参考文件 |
|---|---|---|
| 开始 / 引导 / 设置 | ONBOARD | references/commands-staking.md |
| 查询子网信息 | Q1 | 无 |
| 检查余额 / 仓位 | Q2 | 无 |
| 查看排放 / 纪元信息 | Q3 [草稿] | 无 |
| 查找代理信息 | Q4 | 无 |
| 浏览子网 | Q5 | 无 |
| 查找 / 安装子网技能 | Q6 | 无 |
| 查看纪元历史 | Q7 [草稿] | 无 |
| 设置接收者 / 绑定 / 开始挖矿 | S1 | references/commands-staking.md |
| 存入 / 质押 AWP | S2 | references/commands-staking.md |
| 分配 / 取消分配 / 重新分配 | S3 | references/commands-staking.md |
| 注册新子网 | M1 | references/commands-subnet.md |
| 激活 / 暂停 / 恢复子网 | M2 | references/commands-subnet.md |
| 更新技能 URI | M3 | references/commands-subnet.md |
| 设置最低质押 | M4 | references/commands-subnet.md |
| 创建治理提案 | G1 | references/commands-governance.md |
| 对提案投票 | G2 | references/commands-governance.md |
| 查询提案 | G3 | 无 |
| 检查国库 | G4 | 无 |
| 监控事件 | W1 | 无（以下预设） |
| 排放结算警报 | W2 [草稿] | 无（以下工作流程） |
| 检查通知 | NOTIFICATIONS | 无 — 读取 ~/.awp/notifications.json |
| 查看守护进程日志 | LOG | 无 — tail -50 ~/.awp/daemon.log |
输出格式
所有结构化输出（状态面板、查询结果、交易确认、进度步骤）必须包裹在 markdown 代码块中，以便用户看到整洁、等宽、对齐的文本。使用带标签的前缀，方便用户跟踪：
| 标签 | 使用时机 |
|---|---|
[QUERY] | 只读数据获取 |
[STAKE] | 质押操作 |
[SUBNET] | 子网管理 |
[GOV] | 治理 |
[WATCH] | WebSocket 事件 |
[GAS] | Gas 路由决策 |
[TX] | 交易——始终显示 basescan.org 链接 |
[NEXT] | 推荐的下一步操作 |
[SETUP] | 安装 / 设置操作 |
[!] | 警告和错误 |
交易输出：
[TX] 哈希：<txHash>
[TX] 查看：https://basescan.org/tx/<txHash>
[TX] 已确认 ✓
代理钱包和交易安全
这是一个代理工作钱包——不要在其中存储个人资产。 此技能创建的钱包仅用于执行 AWP 协议任务。只保留最少量的 ETH 用于 Gas。不要将个人资金或有价值的代币转入此钱包。
当用户请求链上操作时，代理直接执行——无需额外的确认提示。用户的指令即确认。交易后在显示简要摘要：
[TX] 已存入 1,000 AWP → 仓位 #3
[TX] 锁定结束于 2026-06-19
[TX] 哈希：0xabc...
[TX] 查看：https://basescan.org/tx/0xabc...
[TX] 已确认 ✓
首次钱包设置时，告知用户：
[WALLET] 这是您的代理工作钱包——仅用于 AWP 任务。
不要在此存储个人资产。仅保留最少量 ETH 用于 Gas。
地址：<地址>
规则
- 注册是免费的。 切勿告诉用户他们需要 AWP 代币、ETH 或质押才能注册。注册使用无 Gas 中继，不花费任何费用。
- 大多数子网免费加入。
min_stake = 0的子网完全不需要质押。在引导期间始终优先选择这些子网。仅在用户明确选择min_stake > 0的子网时才提及质押。 - 不要因为质押而阻止引导。 流程是：注册 → 选择免费子网 → 开始工作。质押是一个独立的、可选的、后续步骤。
- 所有写入操作必须使用捆绑脚本。 绝不要手动构造 calldata、ABI 编码或 EIP-712 JSON。
- 写入操作前始终从 API 获取合约地址——捆绑脚本通过
GET /registry自动处理此操作。绝不要硬编码合约地址。 - 金额显示为人类可读的 AWP（wei / 10^18，4 位小数）。绝不要显示原始 wei。
- 地址：显示为
0x1234...abcd，参数使用完整地址。 - 不要使用过时的 V1 名称：没有 "unbind()"，没有 "removeAgent()"。绑定变更使用
bind(newTarget)。 - 钱包内部处理凭据。 只需运行
awp-wallet init+awp-wallet unlock。无需密码生成、密码文件或用户提示。 - 这是一个代理工作钱包。 用户请求时直接执行交易——无需额外确认。首次设置时提醒用户：不要在此钱包中存储个人资产。
- 子网技能安装 (Q6)： 始终直接安装。对于第三方来源（非
github.com/awp-core/*），添加⚠ 第三方来源提示但不阻止。 - 引导需要用户选择。 始终提供选项 A（独立）和选项 B（委托）供用户选择。