TokenMix Crypto Intelligence Agent

TokenMix Crypto Intelligence Agent

由 TokenMix 驱动的个性化加密市场情报与决策辅助报告工具。

TokenMix 加密市场情报 Agent 是一个开源的加密资产研究工具。它会读取公开行情、交易所数据、DeFi 数据、新闻和开发者信号，再结合你的风险偏好、关注列表和时间周期，生成一份带证据、数据质量评分和风险提示的分析报告。

这篇教程的核心是：把 TokenMix API Key 配进这个 Agent，让它可以通过 TokenMix 调用模型来生成报告。

请注意：它是研究和决策辅助工具，不是交易机器人，不会替你买卖，也不应该被当作金融建议。

你需要先准备好

  1. 一个 TokenMix 账号。
  2. 一个 TokenMix API Key。
  3. 一台可以运行 Node.js 或 Docker 的电脑/服务器。
  4. 一个你想分析的币种，例如 BTC、ETH、SOL。

如果还没有 API Key，先登录 TokenMix，进入控制台，打开 API Key 页面，新建一个 Key。复制完整 Key，通常以 sk-tm- 开头。

第一步：下载项目

打开终端，运行：

git clone https://github.com/TokenMixAi/tokenmix-crypto-intelligence-agent
cd tokenmix-crypto-intelligence-agent
npm install
cp .env.example .env

这一步会把项目下载到本地，并生成一个 .env 配置文件。后面要把 TokenMix API Key 写到这个文件里。

第二步：填写 TokenMix 配置

打开 .env 文件，找到这些字段：

TOKENMIX_API_KEY=
TOKENMIX_BASE_URL=https://api.tokenmix.ai/v1
TOKENMIX_MODEL=claude-opus-4.7
TOKENMIX_ROUTING=balanced
REQUIRE_TOKENMIX_KEY=true

改成类似这样：

TOKENMIX_API_KEY=sk-tm-你的TokenMix密钥
TOKENMIX_BASE_URL=https://api.tokenmix.ai/v1
TOKENMIX_MODEL=<model-short-id>
TOKENMIX_ROUTING=balanced
REQUIRE_TOKENMIX_KEY=true

注意：

  1. TOKENMIX_BASE_URL 固定填 https://api.tokenmix.ai/v1。
  2. TOKENMIX_API_KEY 前后不要有空格。
  3. TOKENMIX_MODEL 要填 TokenMix 模型列表里可用的模型 ID。
  4. 如果不确定模型，先用后台推荐模型；复杂报告建议用更强的模型。

第三步：设置你的个人画像

Agent 会根据你的角色和风险偏好调整报告口径。比如你是短线交易者，和你是长期研究者，报告关注点会不一样。

示例：

npm run dev -- profile --role crypto_researcher --risk balanced --horizon weekly --interests "AI agents,Solana,DeFi" --style standard

参数含义：

  1. role：你的身份，例如 short_term_trader、long_term_investor、defi_yield_hunter、meme_hunter、crypto_researcher。
  2. risk：风险偏好，常用 conservative、balanced、aggressive。
  3. horizon：关注周期，例如 intraday、weekly、monthly、long_term。
  4. interests：关注叙事或板块，例如 AI agents、Solana、DeFi。
  5. style：输出风格，例如 brief、standard、deep、risk_first。

如果只是先测试，可以跳过这一步，使用默认画像。

第四步：分析一个币种

先分析 BTC：

npm run dev -- analyze BTC

也可以分析 SOL：

npm run dev -- analyze SOL

成功后，你会看到一份 Markdown 报告，通常包含：

  1. 市场概览。
  2. 多来源数据和证据。
  3. 数据质量评分。
  4. 风险评分。
  5. 适配你个人画像的观察重点。
  6. 需要确认或失效的信号。

报告里的 Action Bias 不是买卖指令，它只是研究倾向，例如观察、等待确认、机会关注、谨慎或风险规避。

第五步：设置关注列表

如果你经常看几个币，可以设置 watchlist：

npm run dev -- watchlist BTC ETH SOL TAO VIRTUAL

然后生成每日简报：

npm run dev -- daily

这样 Agent 会按你的关注列表生成一份简短概览。

第六步：使用 Web UI

如果你不想一直用命令行，可以启动 Web UI：

npm run dev:api

然后打开：

http://localhost:3000

第一次生产环境启动时，如果 APP_AUTH_PASSWORD 留空，浏览器会提示你创建部署密码。系统只会保存密码哈希到 data/auth.json，不会把明文密码写进仓库。

可选：Docker 启动

如果你更习惯 Docker：

cp .env.example .env

先按第二步填好 .env，然后运行：

docker compose up --build

打开：

http://localhost:3000

常见问题

提示缺少 TokenMix API Key

检查 .env 里是否已经填写：

TOKENMIX_API_KEY=sk-tm-你的TokenMix密钥

如果 REQUIRE_TOKENMIX_KEY=true，没有 Key 就无法生成 AI 报告。

提示模型不可用或模型不存在

检查 TOKENMIX_MODEL 是否是 TokenMix 当前支持的模型 ID。不要随便填写上游官网模型名，除非 TokenMix 模型列表里也这样展示。

报告生成很慢

加密分析会拉取多来源数据，并调用模型生成长报告。复杂模型和复杂币种都可能更慢。可以先用 BTC 做测试，再分析其它资产。

报告看起来像投资建议

请把它当作研究材料。这个 Agent 不提供“买入”“卖出”“做空”“保证上涨”等指令，也不会接管钱包或自动交易。

一句话总结

把 .env 里的 TOKENMIX_API_KEY 填成 TokenMix 的 sk-tm-...，保持 TOKENMIX_BASE_URL=https://api.tokenmix.ai/v1，选择一个 TokenMix 支持的模型，然后运行 npm run dev -- analyze BTC，就能生成一份由 TokenMix 模型驱动的加密市场情报报告。