跳到主要内容

环境变量

所有密钥和环境特定配置都存储在 .env 文件中。该文件已被 .gitignore 排除在版本控制之外。

cp .env.example .env

LLM 提供商密钥​

至少需要一个 LLM API 密钥。使用哪个密钥取决于 config.yaml 中的 client_type。

变量是否必须说明
OPENAI_API_KEY使用 OpenAI 时必须OpenAI API 密钥（sk-...）
CLOUDFLARE_ACCOUNT_ID使用 Cloudflare 时必须Cloudflare 账户 ID
CLOUDFLARE_API_TOKEN使用 Cloudflare 时必须Cloudflare Workers AI Token
GOOGLE_API_KEY使用 Gemini 时必须Google AI Studio API 密钥
NVIDIA_API_KEY使用 NVIDIA NIM 时必须NVIDIA NIM API 密钥（nvapi-...）
LiteLLM 代理

如果使用 client_type: litellm，请设置 OPENAI_API_KEY 或在 config.yaml 中配置 LiteLLM 代理 URL。

Hyperliquid 凭据​

变量是否必须说明
HYPERLIQUID_PRIVATE_KEY必须用于签署订单的以太坊私钥（0x...）
HYPERLIQUID_TESTNET否true 使用测试网，false 使用主网（默认：false）

API 钱包授权​

Hyperliquid 支持使用 API 钱包（子钱包）进行程序化交易。这是推荐方式——主钱包私钥不需要暴露，且可随时撤销权限。

第一步 — 创建 API 钱包​

  1. 用主钱包连接并打开 https://app.hyperliquid.xyz/API
  2. 点击 Generate API Wallet，Hyperliquid 会自动生成新的密钥对
  3. 复制并保存显示的私钥（该私钥只显示一次）
  4. API 钱包地址会出现在 API Wallets 列表中
测试网

测试网请访问 https://app.hyperliquid-testnet.xyz/API。测试资金可从测试网水龙头领取。

第二步 — 配置 .env​

将 API 钱包的私钥填入 .env：

HYPERLIQUID_PRIVATE_KEY=0x<api-wallet-private-key>
HYPERLIQUID_TESTNET=true   # 主网设为 false

第三步 — 向 API 钱包充值​

在 Hyperliquid 上将 USDC 从主钱包转入 API 钱包地址，API 钱包需要有资金才能下单。

私钥安全
  • 永远不要将 .env 提交到任何仓库
  • 永远不要与任何人分享你的私钥
  • 私钥丢失意味着资产永久丢失
  • 建议使用专用的交易钱包，不要使用持有主要资产的钱包

可选：外部数据 API​

这些 API 被 CEX 信号与链上数据 功能使用。全部可选——如不可用，系统会自动降级处理。

变量说明
EXA_API_KEYExa API 密钥，用于 ExternalInfoAgent（市场资讯）
自动降级

如果外部 API 调用失败（网络错误、频率限制、密钥缺失），系统会记录警告并在没有该数据源的情况下继续运行。交易不会被阻断。

.env 示例​

# ── LLM ────────────────────────────────────────────────────────────
OPENAI_API_KEY=sk-proj-xxxxxxxxxxxxxxxxxxxx

# ── Hyperliquid ────────────────────────────────────────────────────
HYPERLIQUID_PRIVATE_KEY=0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890
HYPERLIQUID_TESTNET=true

# ── 可选外部数据 ───────────────────────────────────────────────────
EXA_API_KEY=exa-xxxxxxxxxxxxxxxxxxxx

下一步​