SignalLayer Backlinks Client
安全规则
- 优先从
SIGNALLAYER_API_KEY环境变量读取 Key。 - 不在回复、日志或 Campaign 历史中回显完整 Key。
- 仅在用户明确选择兼容模式时，才保存到
memory/signallayer-api-user.md；提醒这是明文文件且不得提交 Git。 - 配置后必须调用
GET /credits真实验证。仅检查sl_前缀不算验证成功。
API 契约
Base URL：https://signallayer.io/api/openclaw
| 操作 | 方法与路径 |
|---|---|
| 查询积分 / 验证 Key | GET /credits |
| 创建 | POST /create-campaign |
| 查询单个任务 | GET /campaign-status/{id} |
| 查询任务列表 | GET /campaigns?limit=20&offset=0 |
认证 Header：Authorization: Bearer <USER_API_KEY>。
创建流程
- 获取 API Key 并调用
/credits。 - 从用户请求提取参数：
targetUrl：必填。brandName：API 必填；用户未提供时，可从目标 hostname 生成候选值并明确告知用户。linkCount：API 必填；用户未指定时客户端使用 200。keywords：可选，默认空字符串。strategy：safety（默认）、neutral、aggressive。speed：natural（默认）、standard、drip。dripDays：drip时为 10–30，默认 14。
- 调用：
httpPOST https://signallayer.io/api/openclaw/create-campaign Authorization: Bearer <USER_API_KEY> Content-Type: application/json { "targetUrl": "https://example.com", "brandName": "Example", "keywords": "seo,marketing", "linkCount": 200, "strategy": "safety", "speed": "natural", "dripDays": 14, "source": "openclaw-skill" }
- 创建成功必须按 HTTP 201 和
success: true判断。Campaign ID 位于campaign.id。 - 只记录非敏感 Campaign 元数据。
状态与列表
状态响应的进度位于：
json{ "campaign": { "progress": { "total": 200, "completed": 85, "pending": 115, "percent": 43 } } }
不要读取不存在的顶层 completed、total、campaign_id、updatedAt 或预计完成时间。
列表接口默认返回 20 条，limit 最大为 100。它是 Campaign 分页数量，与每个 Campaign 的外链数量无关。
计费与速度
- 当前计费：
1 条外链 = 1 积分。 aggressive不按 1.5 倍扣积分。- API 不支持
instant，不得发送或向用户推荐该值。 natural/standard进入正常 Agent 队列；drip生成 10–30 天的日期排期。- API 不返回 SLA 或预计完成日期，不要自行承诺。
错误处理
读取 HTTP 状态和 JSON 中的 code、error、可选 field：
- 400：参数或 Campaign ID 格式错误。
- 401：Key 缺失或无效。
- 402：积分不足。
- 404：任务不存在或不属于当前 Key。
- 500：服务端创建、列表或状态查询失败。
遇到 HTML 响应时，优先检查是否误用了 api.signallayer.io/v1 或 /campaigns/{id} 等旧路径。
独立客户端
优先使用仓库脚本，避免手写漂移的请求：
bashpython scripts/signallayer_client.py --credits python scripts/signallayer_client.py --target "https://example.com" --brand "Example" python scripts/signallayer_client.py --status "campaign_uuid" python scripts/signallayer_client.py --list
完整契约见 references/api.md，排查流程见 OPERATION-GUIDE.md。
