Geo Opt Coordinator

API key required
Security

GEO 智能优化任务 OpenClaw 协同 — 拉取 OPT 周期状态,分发深度仿写与 sau 群发。

Install

openclaw skills install geo-opt-coordinator

GEO 智能优化协同(Coordinator)

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

前置

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

启动后自动轮询

OpenClaw 启动后,建议使用 loop 定时执行本 skill 完整循环(无需 SaaS Webhook):

/loop 60s 执行 geo-opt-coordinator 推荐循环:拉取 OPT 任务,处理 needsDeepImitate 与 needsSauPublish

或将以下流程写入 Agent 系统提示词 / heartbeat,每 60s 执行一次。

API

  • 基础地址:https://ai.gaobobo.cn(本地 http://127.0.0.1:8002
  • 鉴权:Authorization: Bearer $GEO_KEY

拉取任务列表

GEO_KEY=$(cat ~/.qclaw/geo-api-key 2>/dev/null || cat ~/.openclaw/geo-api-key 2>/dev/null)
curl -s "https://ai.gaobobo.cn/api/geo/optimization/tasks" \
  -H "Authorization: Bearer $GEO_KEY"

响应每项含:

  • task:品牌、关键词、开关
  • latestCycle:本轮 contentTaskIdscycleStepResults
  • openclawActions
    • needsDeepImitate → 使用 skill geo-deep-imitate
    • needsSauPublish + pendingSauPlatforms → 使用 skill geo-social-publish
    • publishableContentTaskIds:可 sau 分发的 CG-*

单任务详情

curl -s "https://ai.gaobobo.cn/api/geo/optimization/OPT-XXXXXXXXXXXX" \
  -H "Authorization: Bearer $GEO_KEY"

最新周期

curl -s "https://ai.gaobobo.cn/api/geo/optimization/OPT-XXXXXXXXXXXX/cycles/latest" \
  -H "Authorization: Bearer $GEO_KEY"

推荐循环

  1. GET /optimization/tasks
  2. needsDeepImitate=true 的任务执行 geo-deep-imitate(同一 taskId + latestCycle.cycleNumber
  3. needsSauPublish=true 的任务,对每个 publishableContentTaskIds × pendingSauPlatforms 执行 geo-social-publish
  4. 间隔 ≥ 60s 再次拉取(文章轮询仍须 ≥30s)

回写与 SaaS 可见性

  • 深度仿写完成后 Backend 写入 latestCycle.cycleStepResults.deepImitate(status、taskIds、usedSources)
  • sau 发布回写 cycleStepResults.sauPublish.platforms.{slug} 与发稿记录
  • SaaS 优化任务监控 / 周期日志中展示 OpenClaw 协同 区块

注意

  • 不替代 SaaS Celery 优化周期;不调用网易 OAuth 发稿
  • 遗留全局 Key 无法使用协同接口,须商户 Key