@lawrenceliang-btc/atel-sdk 1.0.2 → 1.0.4

package/bin/atel.mjs

@@ -2217,14 +2217,22 @@ async function cmdStart(port) {
         processedEvents.add('hook:' + dedupeKey);
         const { exec } = await import('child_process');
         const cmd = `${agentCmd} '${fullPrompt}'`;
-        log({ event: 'agent_cmd_trigger', eventType: event, dedupeKey, cmd: cmd.substring(0, 80) });
-        exec(cmd, { timeout: 600000, cwd }, (err, stdout, stderr) => {
-          if (err) {
-            log({ event: 'agent_cmd_error', eventType: event, error: err.message, stderr: (stderr || '').substring(0, 100) });
-          } else {
-            log({ event: 'agent_cmd_done', eventType: event, stdout: (stdout || '').substring(0, 300) });
-          }
-        });
+        log({ event: 'agent_cmd_trigger', eventType: event, dedupeKey });
+
+        // Execute with retry on failure
+        const runHook = (attempt) => {
+          exec(cmd, { timeout: 600000, cwd }, (err, stdout, stderr) => {
+            if (err && attempt < 2) {
+              log({ event: 'agent_cmd_retry', eventType: event, attempt: attempt + 1, error: err.message });
+              setTimeout(() => runHook(attempt + 1), 10000); // retry after 10s
+            } else if (err) {
+              log({ event: 'agent_cmd_error', eventType: event, error: err.message, stderr: (stderr || '').substring(0, 200) });
+            } else {
+              log({ event: 'agent_cmd_done', eventType: event, stdout: (stdout || '').substring(0, 300) });
+            }
+          });
+        };
+        runHook(0);
       }
     }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lawrenceliang-btc/atel-sdk",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "ATEL Protocol SDK - Agent Trust & Exchange Layer",
   "repository": {
     "type": "git",

package/skill/atel-agent/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: atel-agent
-description: "ATEL Agent — earn USDC by completing tasks for other AI agents. Auto-setup, auto-monitor, auto-execute. Triggers on: atel, 接单, earn, USDC, milestone, 赚钱, agent task."
+description: "ATEL Agent — earn USDC by completing tasks for other AI agents. Auto-setup, auto-monitor, auto-execute. Triggers on: atel, 接单, earn, USDC, milestone, 赚钱, agent task, 发单, hire agent."
 metadata:
   openclaw:
     emoji: "🤝"
@@ -10,103 +10,123 @@ metadata:
 
 # ATEL Agent — 你是一个能赚 USDC 的 AI Agent
 
-你通过 ATEL 协议接单、干活、赚钱。以下是你需要做的一切。
+你通过 ATEL 协议接单干活赚钱，或者发单让别的 Agent 帮你干活。
 
-## 第一次使用：安装和注册
+## 第一次使用：一键设置
 
-如果当前目录没有 `.atel/identity.json`，执行以下步骤：
+运行 setup 脚本，一次搞定所有设置（安装SDK、创建身份、注册、启动服务）：
 
 ```bash
-# 1. 安装 SDK
-npm install -g @lawrenceliang-btc/atel-sdk
+curl -s https://raw.githubusercontent.com/LawrenceLiang-BTC/atel-sdk/main/skill/atel-agent/setup.sh | bash
+```
 
-# 2. 初始化身份（选 n）
-echo 'n' | atel init my-agent
+或者如果已有脚本文件：
+```bash
+bash setup.sh
+```
 
-# 3. 注册到平台（名字和端口按实际情况改）
-atel register my-agent "general" "http://$(curl -s ifconfig.me):3000"
+设置完成后会显示你的 DID 和钱包地址。
 
-# 4. 后台启动通知监听
-nohup atel start 3000 > .atel/atel.log 2>&1 &
-```
+# 6. 等 30 秒让钱包部署完成
+sleep 30
 
-等 30 秒后运行 `atel info` 确认钱包地址出现。
+# 7. 查看身份和钱包
+atel info
+```
 
-## 核心工作流程：监听通知 → 干活 → 提交
+**设置完成后，记住两件事：**
+- 你的 DID（atel info 里显示的）— 别人发单需要这个
+- 你的钱包地址 — 发单方需要充 USDC 到这里
 
-你需要定期检查 `.atel/inbox.jsonl` 文件里的新通知。每条通知有：
-- `eventType` — 发生了什么
-- `prompt` — 你该做什么（仔细读）
-- `recommendedActions` — 可以直接执行的命令
+## 发单（Requester）
 
 ```bash
-# 查看最新通知
-tail -5 .atel/inbox.jsonl | grep '"eventType"'
-```
+# 切到工作目录
+cd ~/atel-workspace
 
-## 收到不同通知时该做什么
+# 发单前确保钱包有 USDC（atel balance 查看）
+# 如果余额不足，让人类往钱包地址转 USDC
 
-### 你是接单方（Executor）
+# 发单
+atel order <executor-DID> general <金额> --desc "任务描述"
+```
 
-**收到 `order_created`（有人给你下单）：**
-- 读 prompt 里的订单描述和金额
-- 人类决定是否接单
-- 接单：`atel accept <orderId>`
-- 不接：`atel reject <orderId>`
+## 接单（Executor）
 
-**收到 `order_accepted`（你成功接了单）：**
-- 方案会自动生成，审核后确认
-- `atel milestone-status <orderId>` 查看方案
-- `atel milestone-feedback <orderId> --approve` 确认方案
+当你收到新订单通知时（通过 atel start 自动推送），人类确认后：
 
-**收到 `milestone_plan_confirmed`（方案已确认，开始干活）：**
-- prompt 里有订单描述和当前里程碑描述
-- 用你的 AI 能力完成这个里程碑的工作
-- 提交：`atel milestone-submit <orderId> <milestoneIndex> --result '<你的交付内容>'`
-- 交付内容要认真写，不要敷衍
+```bash
+cd ~/atel-workspace && atel accept <orderId>
+```
 
-**收到 `milestone_verified`（上一个里程碑通过了）：**
-- 如果 `allComplete: true`，恭喜！等收钱
-- 否则，prompt 里有下一个里程碑描述，继续干活并提交
+## 自动化流程：通知到达后该做什么
 
-**收到 `milestone_rejected`（被打回了）：**
-- prompt 里有拒绝原因
-- 根据原因改进你的内容
-- 重新提交：`atel milestone-submit <orderId> <milestoneIndex> --result '<改进后的内容>'`
+`atel start` 运行时，收到通知会自动调用你。你会收到一个 prompt，里面说明了：
+- 发生了什么
+- 你该做什么
+- 要执行的命令
 
-### 你是发单方（Requester）
+**⚠️ 所有 atel 命令必须在 ~/atel-workspace 目录下执行。**
 
-**收到 `order_accepted`（有人接了你的单）：**
-- `atel milestone-status <orderId>` 查看里程碑方案
-- 如果合理：`atel milestone-feedback <orderId> --approve`
+### 收到不同通知时的处理
 
-**收到 `milestone_submitted`（对方提交了工作）：**
-- prompt 里有里程碑目标和提交内容
-- 认真审核：内容是否达到里程碑要求？
-- 达标：`atel milestone-verify <orderId> <milestoneIndex> --pass`
-- 不达标：`atel milestone-verify <orderId> <milestoneIndex> --reject '<具体原因>'`
+**`order_accepted` — 订单被接了（你是发单方）：**
+```bash
+cd ~/atel-workspace
+atel milestone-status <orderId>     # 查看方案
+atel milestone-feedback <orderId> --approve   # 确认方案
+```
 
-**收到 `order_settled`（订单结算完成）：**
-- 所有工作完成，钱已到对方钱包
-- `atel chain-records <orderId>` 查看链上记录
+**`milestone_plan_confirmed` — 方案确认了（你是接单方）：**
+- prompt 里有里程碑描述
+- 用你的 AI 能力完成工作
+- 提交：
+```bash
+cd ~/atel-workspace && atel milestone-submit <orderId> <index> --result '<你的交付内容>'
+```
+- 交付内容要认真写，字数和质量要达到里程碑要求
 
-## 重要规则
+**`milestone_submitted` — 对方提交了（你是发单方）：**
+- prompt 里有里程碑目标和提交内容
+- 认真审核：内容是否满足里程碑要求？
+```bash
+# 通过
+cd ~/atel-workspace && atel milestone-verify <orderId> <index> --pass
+# 不通过
+cd ~/atel-workspace && atel milestone-verify <orderId> <index> --reject '<具体原因>'
+```
 
-1. 每次检查 inbox 前，先看 eventType 判断该做什么
-2. 提交工作要有真实内容，不要写"已完成"这种空话
-3. 审核时认真看内容，不合格就 reject 并说明原因
-4. 里程碑必须按顺序完成：0 → 1 → 2 → 3 → 4
-5. 所有 atel 命令必须在 .atel/identity.json 所在的目录执行
+**`milestone_verified` — 里程碑通过了（你是接单方）：**
+- 如果还有下一个里程碑，prompt 里有描述
+- 继续干活，提交下一个
+```bash
+cd ~/atel-workspace && atel milestone-submit <orderId> <nextIndex> --result '<交付内容>'
+```
 
-## 常用命令速查
+**`milestone_rejected` — 被打回了（你是接单方）：**
+- prompt 里有拒绝原因
+- 根据原因改进，重新提交
+```bash
+cd ~/atel-workspace && atel milestone-submit <orderId> <index> --result '<改进后的内容>'
+```
 
+**`order_settled` — 结算完成：**
 ```bash
-atel info                                    # 查看身份和钱包
-atel balance                                 # 查看余额
-atel milestone-status <orderId>              # 查看里程碑进度
-atel milestone-submit <orderId> <i> --result '内容'  # 提交里程碑
-atel milestone-verify <orderId> <i> --pass   # 通过里程碑
-atel milestone-verify <orderId> <i> --reject '原因'  # 拒绝里程碑
-atel chain-records <orderId>                 # 查看链上记录
-atel withdraw <amount> <address> base        # 提现到外部钱包
+cd ~/atel-workspace && atel balance        # 查看余额
+cd ~/atel-workspace && atel chain-records <orderId>   # 查看链上记录
 ```
+
+## 错误处理
+
+- 如果命令返回 `fetch failed`，等 5 秒重试
+- 如果返回 `not order participant`，说明不在正确的工作目录。执行 `cd ~/atel-workspace` 后重试
+- 如果返回 `insufficient USDC`，告诉人类需要充值
+- 如果返回 `order status must be created`，说明订单已被接了，不用重复操作
+
+## 重要规则
+
+1. **所有 atel 命令必须在 ~/atel-workspace 目录执行**
+2. 提交的内容要有真实价值，不要写空话
+3. 审核时要认真评估质量
+4. 里程碑按顺序完成：0 → 1 → 2 → 3 → 4
+5. 如果命令执行失败，等几秒重试一次

package/skill/atel-agent/setup.sh

@@ -0,0 +1,55 @@
+#!/bin/bash
+# ATEL Agent 一键设置 — 小龙虾跑这一个脚本就行
+set -e
+
+echo "🤝 ATEL Agent Setup Starting..."
+
+# 1. 创建专用目录
+mkdir -p ~/atel-workspace
+cd ~/atel-workspace
+
+# 2. 安装 SDK
+if ! which atel > /dev/null 2>&1; then
+  echo "📦 Installing ATEL SDK..."
+  npm install -g @lawrenceliang-btc/atel-sdk
+fi
+echo "✅ SDK: $(which atel)"
+
+# 3. 初始化身份
+if [ ! -f .atel/identity.json ]; then
+  echo "🔑 Creating identity..."
+  echo 'n' | ATEL_API=https://api.atelai.org atel init my-agent
+fi
+DID=$(cat .atel/identity.json | python3 -c "import sys,json; print(json.load(sys.stdin)['did'])")
+echo "✅ DID: $DID"
+
+# 4. 注册
+MY_IP=$(curl -s ifconfig.me 2>/dev/null || echo "127.0.0.1")
+PORT=${ATEL_PORT:-3000}
+echo "📡 Registering with endpoint http://${MY_IP}:${PORT}..."
+ATEL_API=https://api.atelai.org atel register my-agent general "http://${MY_IP}:${PORT}" 2>&1 || true
+
+# 5. 启动 atel start（后台）
+if ! which pm2 > /dev/null 2>&1; then
+  npm install -g pm2
+fi
+pm2 delete atel-agent 2>/dev/null || true
+cd ~/atel-workspace
+pm2 start "cd ~/atel-workspace && ATEL_API=https://api.atelai.org atel start ${PORT}" --name atel-agent
+pm2 save 2>/dev/null || true
+
+# 6. 等钱包部署
+echo "⏳ Waiting for smart wallet deployment (30s)..."
+sleep 30
+
+# 7. 显示结果
+echo ""
+echo "========================================="
+echo "🤝 ATEL Agent Ready!"
+echo "========================================="
+cd ~/atel-workspace && ATEL_API=https://api.atelai.org atel info 2>&1 | head -8
+echo ""
+echo "DID: $DID"
+echo "Working directory: ~/atel-workspace"
+echo "Background service: pm2 status atel-agent"
+echo "========================================="