设置:通知、AI 密钥和自己的副本
这里的一切都是可选的:没有它们仪表盘也能正常运行。所有设置都在 GitHub 仓库中:Settings → Secrets and variables → Actions。
目录
设置在哪里
在 GitHub 打开仓库 → Settings → Secrets and variables → Actions。有两个标签:
- Secrets:隐藏的值(令牌、密钥)。任何人都无法再读取,日志中也会被遮蔽。
- Variables:普通的非机密值(语言代码、模型名称)。
修改从下一次运行开始生效。立即运行:Actions → research-agents → Run workflow。
Telegram 通知
发生重要事情时智能体会通知你:市场状态变化、H-020 规则入场或离场、假设得到新结论、数据源出错,以及每周一次摘要。
- 在 Telegram 打开 @BotFather。使用已有机器人(
/mybots→ 机器人 → API Token)或用/newbot新建。 - 打开你的机器人并点击 Start,否则它无法给你发消息。
- 获取聊天 ID:给 @userinfobot 发消息,它会回复类似
123456789的数字。群组或频道需先把机器人加进去,其 ID 以-100开头。 - 在 Settings → Secrets and variables → Actions → Secrets → New repository secret 中创建
TELEGRAM_BOT_TOKEN(令牌)和TELEGRAM_CHAT_ID(ID)。 - 语言:在 Variables → New repository variable 中创建
TELEGRAM_LANG,值为zh(或en、ru、es、pt、tr、vi)。不设置则为英文。每条通知末尾附有同语言的仪表盘链接。 - 测试:Actions → research-agents → Run workflow,勾选 test_alert 后运行。几分钟内会收到"Telegram 通知已连接"。如果该步骤失败,说明令牌或 ID 有误,或尚未启动机器人。
只有出现变化时才会发送通知。
AI 模型密钥(可选)
所有检验都由引擎按固定规则完成,从不让模型判断一个想法是否有效。模型密钥会增加两个助手:
- 通俗的每周摘要。 没有密钥时你收到的是英文原始周报。有密钥时,模型会用
TELEGRAM_LANG的语言简要复述,只使用报告中的数字,也不给出交易建议。 - 每月的新假设草稿(每月 1 日)。模型以 draft 状态的 pull request 提出想法。是否登记由你决定,登记前不会检验任何内容。
免费方案:Groq。 在 console.groq.com → API Keys → Create API Key 获取密钥,保存为 secret LLM_API_KEY。无需付费(免费额度有每日上限,每周摘要绰绰有余)。模型会从 Groq 当前提供的免费模型中自动选择(这些模型会改名或下线);如需固定某个模型,请设置 CRL_LLM_MODEL。其他兼容 OpenAI 的服务(OpenRouter、Gemini)也可以:把地址填入变量 CRL_LLM_BASE_URL。两个密钥都设置时使用 LLM_API_KEY。
如何接入 Anthropic(付费):
- 访问 console.anthropic.com,注册并在 Billing 中充值。API 按用量计费,与 Claude 订阅分开;每周摘要和每月提案每月只需几美分。请先确认你所在国家在 Anthropic 支持的地区列表中。
- API Keys → Create Key,复制密钥(
sk-ant-…)。它只显示一次。 - 在 Settings → Secrets and variables → Actions → Secrets 中用该密钥创建
ANTHROPIC_API_KEY。 - 可选:变量
CRL_LLM_MODEL用于选择其他模型(默认claude-sonnet-5-5)。 - 若要草稿以 pull request 形式到达:Settings → Actions → General → Allow GitHub Actions to create and approve pull requests。
要关闭,删除该 secret 即可。如果密钥泄露,请立即在控制台撤销。
运行自己的副本
一切都在 GitHub 的免费服务器上运行,你的电脑上不需要任何东西。
- 打开 https://github.com/f1devbin/Crypto-Research-Labs 并点击 Fork。
- 在你的副本中:Settings → Pages → Source: GitHub Actions。
- Actions → 如有提示请启用 workflows → research-agents → Run workflow。首次运行约需 20 分钟(下载价格历史),之后每天自动运行。
- 你的仪表盘地址为
https://<你的用户名>.github.io/Crypto-Research-Labs/。 - 如需要,按上文接入 Telegram 和 AI 密钥。
想提出自己的想法,请看 CONTRIBUTING.md 或发到 Discussions → Ideas。
全部设置一览
| 名称 | 位置 | 作用 |
|---|---|---|
TELEGRAM_BOT_TOKEN | Secrets | 来自 @BotFather 的机器人令牌 |
TELEGRAM_CHAT_ID | Secrets | 通知接收者 |
TELEGRAM_LANG | Variables | 通知语言:en、ru、es、pt、tr、vi、zh |
ANTHROPIC_API_KEY | Secrets | 通俗摘要和假设草稿 |
LLM_API_KEY | Secrets | 免费替代:Groq 或其他兼容 OpenAI 的密钥 |
CRL_LLM_BASE_URL | Variables | 该服务的地址(默认 Groq) |
CRL_LLM_MODEL | Variables | 替代 claude-sonnet-5-5 的其他模型 |
GOOGLE_SITE_VERIFICATION | Variables | Google Search Console 代码 |
CRL_SITE_URL | Variables | 使用自有域名时的仪表盘地址 |