Loudy.ai 自动任务 Skill
⚠️ 安全警告
- 🔐 API Key 安全：建议使用环境变量
export LOUDY_API_KEY=你的密钥，不要写入 TOOLS.md 或其他共享文件
- 📝 文件系统访问：本工具会读写工作区目录下的文件（默认：
/root/.openclaw/workspace/，可通过 OPENCLAW_WORKSPACE 环境变量自定义）
- ⏰ 可选的 Cron 任务：如需自动检查，需手动配置 cron 任务
快速开始
1. 配置 API Key (推荐环境变量方式)
export LOUDY_API_KEY="你的API密钥"
⚠️ 注意：不建议将密钥写入 TOOLS.md，避免意外泄露
2. 启动任务
告诉 AI：
"查看 loudy 可用奖池"
3. 自动执行流程
- AI 展示可用奖池详情（包括要求、奖金、截止时间、详情页面链接）
- 你根据要求发布推文到 X/Twitter
- 将推文链接发送给 AI
- AI 自动提交到 loudy.ai
工作流程
1. fetch_earning_pools() → 获取进行中的奖池列表
2. 展示奖池详情给用户 → 包括要求、奖金、截止时间、详情页面链接
3. 提示用户根据要求发推文 → 用户手动发布到 X/Twitter
4. 等待用户提供推文链接 → 用户把推文链接发给 AI
5. submit_task() → 自动提交作品链接到 loudy.ai
6. 定时 check_task_status() → 查询任务是否被接受
├─ 超时未接受 → 报告失败
└─ 已接受 → 定时查询 payment/支付信息
用户交互流程示例
步骤 1: 查看可用奖池
用户: "查看 loudy 可用奖池"
AI: 调用 fetch_pools.py，展示奖池列表（包含详情页面链接）
步骤 2: 选择奖池并发推文
AI: 展示奖池详情和要求
用户: 选择奖池，根据要求发布推文
步骤 3: 提交推文链接
用户: "提交推文链接 https://x.com/xxx/status/123 到奖池 3"
AI: 调用 submit_task.py(3, "https://x.com/xxx/status/123")
步骤 4: 查询任务状态
用户: "查询任务状态"
AI: 调用 check_task.py 查询审核和支付状态
API 接口
1. 获取奖池列表
- URL:
GET https://api.loudy.ai/app-api/open-api/v1/earning-pools
- Header:
X-API-Key: <LOUDY_API_KEY>
2. 获取奖池详情
- URL:
GET https://api.loudy.ai/app-api/open-api/v1/earning-pools/{id}
- Header:
X-API-Key: <LOUDY_API_KEY>
3. 提交任务
- URL:
POST https://api.loudy.ai/app-api/open-api/v1/earning-pool-tasks/submit
- Header:
X-API-Key: <LOUDY_API_KEY>
- Body:
{
"earningPoolId": 123,
"taskLink": ["https://x.com/xxx/status/123"],
"languageType": "zh_CN"
}
4. 查询我的任务列表（分页）
- URL:
GET https://api.loudy.ai/app-api/open-api/v1/earning-pool-tasks
- Header:
X-API-Key: <LOUDY_API_KEY>
- Query:
pageNo - 页码（必填）pageSize - 每页条数，最大100（必填）earningPoolId - 奖池ID（可选）taskStatus - 任务状态（可选）
5. 查询任务状态
- URL:
GET https://api.loudy.ai/app-api/open-api/v1/earning-pool-tasks/{id}
- Header:
X-API-Key: <LOUDY_API_KEY>
- 返回字段:
taskStatus - 任务状态auditStatus - 审核状态 (0=未审核, 1=通过, 2=拒绝)taskLinks - 作品链接
脚本说明
scripts/fetch_pools.py
获取进行中的奖池列表，过滤 Ongoing 状态
scripts/list_my_tasks.py
查询当前用户的任务列表（分页）
scripts/submit_task.py
提交作品链接到奖池
scripts/check_task.py
查询单个任务状态和支付信息
scripts/auto_task_flow.py
优化的任务流程脚本：
- 获取可用奖池列表
- 展示奖池详情（包括要求、奖金、截止时间）
- 显示 Loudy.ai 详情页面链接
- 等待用户提供推文链接
- 自动提交到 loudy.ai
scripts/check_tasks.py
定时检查脚本，获取当前奖池并格式化输出
scripts/cron_check.sh
Cron 定时任务脚本，每5分钟检查一次新任务。使用 OPENCLAW_WORKSPACE 环境变量自定义工作目录。
配置定时检查（可选）
1. 设置环境变量
export LOUDY_API_KEY="你的API Key"
export OPENCLAW_WORKSPACE="/root/.openclaw/workspace" # 可选，默认值
2. 配置 Cron 定时检查（可选）
# 方法1: 使用工作区安装路径（推荐）
SKILL_DIR="/root/.openclaw/workspace/skills/claw-loudyai-skill"
(crontab -l 2>/dev/null; echo "*/5 * * * * $SKILL_DIR/scripts/cron_check.sh") | crontab -
# 方法2: 如果安装到系统路径
(crontab -l 2>/dev/null; echo "*/5 * * * * /usr/lib/node_modules/openclaw/skills/loudy-ai-auto-task/scripts/cron_check.sh") | crontab -
3. 配置 Heartbeat 通知（可选）
在 HEARTBEAT.md 中添加：
## Loudy.ai 任务检查
检查工作区目录下的 loudy_has_new.txt 是否存在：
- 如果存在 → 读取 loudy_tasks.json 内容
- 发送消息通知用户
- 删除 loudy_has_new.txt
注意事项
- ⚠️ API Key 安全：建议使用环境变量
export LOUDY_API_KEY=你的密钥，不要写入 TOOLS.md 或其他共享文件
- 📝 文件系统访问：本工具会读写工作区目录下的文件（默认：
/root/.openclaw/workspace/，可通过 OPENCLAW_WORKSPACE 环境变量自定义），包括 loudy_tasks.json, loudy_has_new.txt
- ⏰ 可选的 Cron 任务：如需自动检查，需手动配置 cron 任务（可选功能）
- 🐦 Twitter 功能说明：本工具不包含 Twitter/X 自动发布功能，用户需手动发布推文后提供链接
- ⏳ 任务截止时间：任务有截止时间 (activityEnd)，需在截止前提交
- ✅ 审核流程：提交后需等待审核 (auditStatus)，建议设置定时检查间隔为 5-10 分钟
