alpha-copilot-skill
v0.1.0Generate a daily priority leaderboard for 5 crypto tokens, with per-token fundamentals, liquidity, and risk summaries plus ready-to-publish drafts for X posts, group updates, and quick briefs. Use this skill when users want an OpenClaw research copilot for daily alpha scanning with SkillPay billing...
Installation
Skill: alpha-copilot-skill
Purpose / 用途
Use this skill to produce a publishable daily research pack from Binance Web3 market signals. 用这个 skill 可以基于 Binance Web3 市场信号生成可直接发布的日报研究包。
It is designed for operators who want one fixed output: - 今日优先级榜单 - 值得看的 5 个币 - 每个币的基本面/流动性/风险摘要 - 可直接发推文、发群、写快报的文案草稿
Workflow / 工作流
- Pull multiple Binance Web3 leaderboard views (
trending,top_search,alpha). - Merge repeated token hits into one candidate list.
- Enrich top candidates with token metadata and audit data.
- Score candidates into a daily priority ranking.
-
Output JSON or Markdown and bill one successful
rankcall through SkillPay. -
拉取 Binance Web3 的多个榜单视图(
trending、top_search、alpha)。 - 合并重复上榜的 token,生成候选池。
- 补充 token 元数据与审计信息。
- 计算今日优先级评分。
- 输出 JSON 或 Markdown,并在成功执行
rank后接入 SkillPay 计费。
Commands / 命令
Run from the skill root: 在 skill 根目录执行:
python3 scripts/alpha_copilot.py rank --chain bsc --lang zh --user-id demo
python3 scripts/alpha_copilot.py rank --chain base --format markdown --limit 5 --user-id demo
python3 scripts/alpha_copilot.py rank --chain solana --skip-audit --skip-billing
python3 scripts/alpha_copilot.py health
python3 scripts/alpha_copilot.py proxy-check --chain bsc
Output Contract / 输出结构
Each ranked token includes:
每个入选币种包含:
- symbol
- name
- contract_address
- priority_score
- priority_tier
- fundamentals_summary
- liquidity_summary
- risk_summary
- tweet_draft
- group_draft
- brief_draft
The report also contains leaderboard, top_tokens, summary, and generated_at_utc.
整份报告还包含 leaderboard、top_tokens、summary 和 generated_at_utc。
Billing Hook (SkillPay) / 计费接入
- Bill only
rank. - Default price comes from
SKILLPAY_PRICE_USDTand should stay at0.01. - Read API key from
SKILLPAY_APIKEY. - Keep
SKILLPAY_BASE_URL/SKILLPAY_CHARGE_URLoverrideable so the SkillPay integration can be swapped without changing report logic. -
Do not hard-code secrets.
-
只对
rank计费。 - 默认价格来自
SKILLPAY_PRICE_USDT,默认应保持为0.01。 - API key 从
SKILLPAY_APIKEY读取。 SKILLPAY_BASE_URL/SKILLPAY_CHARGE_URL保持可覆盖,避免把 SkillPay 接口写死进业务逻辑。- 不要硬编码任何密钥。
Required/Useful Env Vars / 关键环境变量
SKILLPAY_APIKEY(required for paid mode)SKILLPAY_BILLING_MODE(optional,skillpayornoop)SKILLPAY_PRICE_USDT(optional, default0.01)SKILLPAY_USER_REF(optional fallback user id)BINANCE_WEB3_BASE_URL(optional, defaulthttps://web3.binance.com)BINANCE_HTTP_TIMEOUT_SEC(optional, default12)ALPHA_COPILOT_PROXY_MODE(optional,auto/env/direct/custom, defaultauto)-
Standard proxy env vars are supported:
HTTP_PROXY,HTTPS_PROXY,ALL_PROXYand lowercase forms -
SKILLPAY_APIKEY(付费模式必需) SKILLPAY_BILLING_MODE(可选,skillpay或noop)SKILLPAY_PRICE_USDT(可选,默认0.01)SKILLPAY_USER_REF(可选,默认用户标识)BINANCE_WEB3_BASE_URL(可选,默认https://web3.binance.com)BINANCE_HTTP_TIMEOUT_SEC(可选,默认12)ALPHA_COPILOT_PROXY_MODE(可选,auto/env/direct/custom,默认auto)- 支持标准代理环境变量:
HTTP_PROXY、HTTPS_PROXY、ALL_PROXY及其小写形式
Notes / 说明
- This skill is for research and content generation, not auto-trading.
- Keep wording neutral and avoid profit guarantees.
- If audit or metadata enrichment partly fails, still return the report with unavailable fields instead of failing the whole run.
- Recommended proxy strategy:
- Default
auto: if the user's terminal has proxy env vars, requests use them; otherwise direct access is used. - Use
--proxy-mode directfor overseas users who do not want inherited proxy settings. - Use
--proxy-mode custom --https-proxy ... --http-proxy ...when the caller wants the skill to use a specific proxy without changing the shell environment. - Use
proxy-checkfirst when a user reports connection errors; it verifies root access, rank API, metadata API, and audit API in the current network mode. -
proxy-checkalso returns bilingual fields:summary.message_zh,summary.message_en,summary.suggestions_zh,summary.suggestions_en. -
这个 skill 用于研究与内容生成,不是自动交易工具。
- 文案要保持中性,不要承诺收益。
- 如果审计或元数据补充阶段部分失败,也要尽量保留报告结构,并把不可用字段标出来,而不是整份报告直接失败。
- 推荐代理策略:
- 默认
auto:如果用户终端里存在代理环境变量,就自动继承;否则直连。 - 海外用户可用
--proxy-mode direct强制直连。 - 如果不想修改 shell 环境,可用
--proxy-mode custom --https-proxy ... --http-proxy ...显式指定代理。 - 用户反馈联网失败时,优先先跑
proxy-check。 proxy-check会返回双语字段:summary.message_zh、summary.message_en、summary.suggestions_zh、summary.suggestions_en。