\r \r

GEO 智能优化协同（Coordinator）\r

\r 轮询 SaaS 已开启 OpenClaw 协同 的 OPT-* 任务，按服务端返回的 openclawActions 执行子流程。\r \r

前置\r

\r

• ~/.qclaw/geo-api-key（QClaw；Windows %USERPROFILE%\.qclaw\geo-api-key），或兼容路径 ~/.openclaw/geo-api-key（商户 API Key，在 SaaS 账户设置 → 龙虾密钥 自助签发）\r
• SaaS 创建优化任务时勾选 深度仿写 和/或 sau 平台（会自动 openclawCoordinatorEnabled=true）\r
• Celery 已跑完当轮诊断（needsDeepImitate 依赖 diagnosis_report_id）\r
• 深度仿写：本机 FIRECRAWL_API_KEY + firecrawl_scrape 工具\r
• sau 发布：本机安装 social-auto-upload，完成各平台 Cookie 登录\r \r

启动后自动轮询\r

\r OpenClaw 启动后，建议使用 loop 定时执行本 skill 完整循环（无需 SaaS Webhook）：\r \r

/loop 60s 执行 geo-opt-coordinator 推荐循环：拉取 OPT 任务，处理 needsDeepImitate 与 needsSauPublish\r
```\r
\r
或将以下流程写入 Agent 系统提示词 / heartbeat，每 60s 执行一次。\r
\r
## API\r
\r
- 基础地址：`https://ai.gaobobo.cn`（本地 `http://127.0.0.1:8002`）\r
- 鉴权：`Authorization: Bearer $GEO_KEY`\r
\r
### 拉取任务列表\r
\r
```bash\r
GEO_KEY=$(cat ~/.qclaw/geo-api-key 2>/dev/null || cat ~/.openclaw/geo-api-key 2>/dev/null)\r
curl -s "https://ai.gaobobo.cn/api/geo/optimization/tasks" \\r
  -H "Authorization: Bearer $GEO_KEY"\r
```\r
\r
响应每项含：\r
\r
- `task`：品牌、关键词、开关\r
- `latestCycle`：本轮 `contentTaskIds`、`cycleStepResults`\r
- `openclawActions`：\r
  - `needsDeepImitate` → 使用 skill **geo-deep-imitate**\r
  - `needsSauPublish` + `pendingSauPlatforms` → 使用 skill **geo-social-publish**\r
  - `publishableContentTaskIds`：可 sau 分发的 `CG-*`\r
\r
### 单任务详情\r
\r
```bash\r
curl -s "https://ai.gaobobo.cn/api/geo/optimization/OPT-XXXXXXXXXXXX" \\r
  -H "Authorization: Bearer $GEO_KEY"\r
```\r
\r
### 最新周期\r
\r
```bash\r
curl -s "https://ai.gaobobo.cn/api/geo/optimization/OPT-XXXXXXXXXXXX/cycles/latest" \\r
  -H "Authorization: Bearer $GEO_KEY"\r
```\r
\r
## 推荐循环\r
\r
1. `GET /optimization/tasks`\r
2. 对 `needsDeepImitate=true` 的任务执行 **geo-deep-imitate**（同一 `taskId` + `latestCycle.cycleNumber`）\r
3. 对 `needsSauPublish=true` 的任务，对每个 `publishableContentTaskIds` × `pendingSauPlatforms` 执行 **geo-social-publish**\r
4. 间隔 ≥ 60s 再次拉取（文章轮询仍须 ≥30s）\r
\r
## 回写与 SaaS 可见性\r
\r
- 深度仿写完成后 Backend 写入 `latestCycle.cycleStepResults.deepImitate`（status、taskIds、usedSources）\r
- sau 发布回写 `cycleStepResults.sauPublish.platforms.{slug}` 与发稿记录\r
- SaaS 优化任务监控 / 周期日志中展示 **OpenClaw 协同** 区块\r
\r
## 注意\r
\r
- 不替代 SaaS Celery 优化周期；不调用网易 OAuth 发稿\r
- 遗留全局 Key 无法使用协同接口，须商户 Key\r