技能介绍

要解决什么问题

在 OpenClaw 里做加密资讯相关自动化时，你往往需要对接一套异步 HTTP 服务：按时间窗口跑新闻分析、用自然语言做跨库语义检索、轮询任务直到 completed 或 failed，还要维护数据源与「主题优先」的情报流水线。手写 curl 和记路由很容易漏掉 Bearer 鉴权、把 POST /analyze 的 202 当成最终报告，或在语义搜索里忽略 PostgreSQL/pgvector 的前置条件。

技能如何工作

本技能把 Crypto News Analyzer（或兼容的私有部署）的调用约定整理成可复用流程：

新闻分析：POST /analyze → GET /analyze/{job_id} → GET /analyze/{job_id}/result；任务状态为 queued / running / completed / failed。
统一语义搜索：POST /semantic-search 返回 status_url、result_url 与 Retry-After；在 content_items 与 raw_intelligence_items 上通过 pgvector HNSW（vector(1536)）做 UNION 检索，结果带 source_domain（news / intelligence）与 source_breakdown。
数据源：POST/GET/DELETE /datasources，按 purpose（news / intelligence）区分 RSS/X/REST 与 Telegram、V2EX 等；列表响应会对 REST 密钥做脱敏。
情报主题（Topic-First）：同步接口完成草稿、修订、确认、归档、查 findings 与 runs；POST .../merge 为异步合并，需轮询 merge job。
主题与数据源关联：GET/PUT/POST/DELETE 主题下的 datasources 路由，用于限定研究范围。

OpenClaw 侧通过 metadata.openclaw.primaryEnv: API_KEY，在 ~/.openclaw/openclaw.json 注入 Bearer；无 token 时不应发未认证请求。

边界与注意点

语义搜索依赖 PostgreSQL + pgvector，SQLite 运行时不受支持；后端不支持时会返回 503。
语义搜索默认 5 分钟超时失败；hours 超过服务端上限（默认 720h）时响应可能带截断 warning。
query 必填、去首尾空白、最长 300 字符；user_id 须匹配 ^[A-Za-z0-9_-]{1,128}$。
本技能不覆盖 Telegram 斜杠命令、自动生成的 /docs 等文档路由，以及已废弃的 entry 类情报接口；Telegram webhook 仅作维护级集成，日常应走 HTTP API 或 Bot 命令。