TradingAgents configuration

TradingAgents 配置：模型、数据源与 API

自托管 TradingAgents 需要统一管理模型和多类数据；只想解决具体研究问题时，也可以选择 EasyClaw 的独立任务路线。

Responsibilities

先判断每项配置是否真的需要

不同研究任务需要的模型、数据和权限不同，不要一开始把所有密钥都填进去。

配置内容	是否必需	解决什么问题	可能需要
LLM 模型	是	生成分析、辩论和研究叙述	模型账号、API Key、额度和区域端点
行情数据	按任务	价格、K 线和技术指标	数据接口、市场权限或公共源网络
新闻与公告	按任务	事件、公告和情绪材料	新闻服务 Key、额度和时间边界
本地模型	可选	减少外部模型依赖	Ollama / 兼容端点、模型文件和磁盘空间
Docker / WSL2	可选	隔离依赖和运行环境	Docker Desktop、镜像下载和系统权限

完成标准：配置完成不等于研究成功。模型、数据源、市场代码和研究日期都通过验证，才算完成首次运行准备。

EasyClaw 按任务连接数据，不需要复制整套框架配置

先选择行情、公告、财务、筛选或图表任务，再连接对应提供商。每个 API Key、账户、额度和市场权限仍需分别确认。

安装 EasyClaw，开始研究查看连接要求

Minimum

最小可运行配置由四部分组成

每一层都应独立验证，避免把一个成功响应误认为整条链路可用。

模型提供商

选择深度与快速模型，确认区域端点、模型 ID、额度和重试预算。

市场数据

确定股票市场、代码格式、历史窗口、指标来源和权限。

新闻与宏观

确认新闻、社交、FRED 或 Polymarket 等数据是否适用于研究问题。

本地目录

保护 .env，确认缓存、决策日志和检查点目录可写。

LLM

模型提供商不是一个统一开关

当前代码覆盖多种云端、本地与兼容端点。具体模型可用性仍以你的账户和端点为准。

路线	当前代码示例	常见凭据	需要核对
主流云模型	OpenAI、Google、Anthropic、xAI	各自 API Key	模型访问权、区域、配额、响应格式
中国与区域提供商	DeepSeek、Qwen、GLM、MiniMax	国际/中国端点可能使用不同 Key	端点域名、模型 ID、地区与计费
聚合与企业	OpenRouter、Azure OpenAI、AWS Bedrock	Key、Azure 配置或 AWS 凭据	部署名、Region、IAM 权限、额外依赖
本地或兼容端点	Ollama、vLLM、LM Studio、llama.cpp	本地可无 Key；受保护端点需 Key	Base URL、模型 ID、上下文长度、网络可达性

Data

为每类数据指定清晰来源

同一报告可能同时使用价格、财务、新闻、情绪和宏观数据；它们的时间边界并不相同。

行情与公司数据

Yahoo Finance 覆盖的市场使用交易所后缀代码
Alpha Vantage 需要独立 Key
历史价格可固定分析日期，但数据修订仍需记录
A 股要额外核对复权、停复牌和字段覆盖

文本与宏观数据

新闻、StockTwits、Reddit 会随查询时间变化
FRED 用于宏观经济数据
Polymarket 属于独立数据供应路线
缺失或不可用时应明确标注，不用模型常识补齐

Environment

环境变量只展示名称，不展示值

下面是官方 README 中的凭据名称示例。实际部署时按所选路线填写，避免同时堆入不使用的密钥。

.env 示例（仅变量名）OPENAI_API_KEY=...
GOOGLE_API_KEY=...
ANTHROPIC_API_KEY=...
DEEPSEEK_API_KEY=...
DASHSCOPE_API_KEY=...
DASHSCOPE_CN_API_KEY=...
ZHIPU_API_KEY=...
MINIMAX_API_KEY=...
OPENROUTER_API_KEY=...
ALPHA_VANTAGE_API_KEY=...

不要公开：真实 Key、Token、AWS 凭据、Azure 部署信息、账户标识、请求头和带凭据的本地截图。

Paths

日志、记忆与检查点

用途	默认位置	可配置项	注意
决策日志	`~/.tradingagents/memory/trading_memory.md`	`TRADINGAGENTS_MEMORY_LOG_PATH`	包含历史研究内容，发布前需脱敏。
检查点缓存	`~/.tradingagents/cache/checkpoints/`	`TRADINGAGENTS_CACHE_DIR`	按 Ticker 保存 SQLite；成功后自动清理。
模型端点	按提供商配置	`TRADINGAGENTS_LLM_BACKEND_URL`	自定义端点需验证网络、鉴权和模型 ID。

Checklist

进入首次运行前的检查清单

只保留一个明确的模型路线
先验证提供商、端点和模型 ID，再增加备用模型。
用目标市场的真实代码格式
例如美股 AAPL、港股 0700.HK、上海 600519.SS、深圳 000001.SZ。
记录数据源与调用时间
尤其是新闻、社交和宏观数据，避免把后续变化误认为程序错误。
检查输出目录和隐私
确保日志可写，并在任何公开截图前遮蔽凭据、用户名和本地路径。