跳转到内容
CoderClaw CoderClaw

环境变量

环境变量

Section titled “环境变量”

CoderClaw 从多个来源拉取环境变量。规则是永不覆盖现有值。

优先级（从高到低）

Section titled “优先级（从高到低）”
  1. 进程环境（Gateway 网关进程从父 shell/守护进程已有的内容）。
  2. 当前工作目录中的 .env（dotenv 默认；不覆盖）。
  3. 全局 .env 位于 ~/.coderclaw/.env（即 $CODERCLAW_STATE_DIR/.env；不覆盖）。
  4. 配置 env 块 位于 ~/.coderclaw/coderclaw.json（仅在缺失时应用）。
  5. 可选的登录 shell 导入（env.shellEnv.enabled 或 CODERCLAW_LOAD_SHELL_ENV=1），仅对缺失的预期键名应用。

如果配置文件完全缺失，步骤 4 将被跳过；如果启用了 shell 导入，它仍会运行。

配置 env 块

Section titled “配置 env 块”

两种等效方式设置内联环境变量（都是非覆盖的）：

{
  env: {
    OPENROUTER_API_KEY: "sk-or-...",
    vars: {
      GROQ_API_KEY: "gsk-...",
    },
  },
}

Shell 环境导入

Section titled “Shell 环境导入”

env.shellEnv 运行你的登录 shell 并仅导入缺失的预期键名：

{
  env: {
    shellEnv: {
      enabled: true,
      timeoutMs: 15000,
    },
  },
}

环境变量等效项：

  • CODERCLAW_LOAD_SHELL_ENV=1
  • CODERCLAW_SHELL_ENV_TIMEOUT_MS=15000

配置中的环境变量替换

Section titled “配置中的环境变量替换”

你可以使用 ${VAR_NAME} 语法在配置字符串值中直接引用环境变量：

{
  models: {
    providers: {
      "vercel-gateway": {
        apiKey: "${VERCEL_GATEWAY_API_KEY}",
      },
    },
  },
}

完整详情参见配置：环境变量替换。

相关内容

Section titled “相关内容”