Files

Josh Palmer 5676a6b38d Docs: normalize zh-CN terminology + tone

What: switch to 你/你的 tone; standardize Skills/Gateway网关/local loopback/私信 wording
Why: align zh-CN docs with issue 6995 feedback + idiomatic tech style
Tests: pnpm docs:build

2026-02-02 16:38:25 +01:00

2.3 KiB

Raw Blame History

read_when, summary, title, x-i18n

read_when

summary

title

x-i18n

需要了解加载了哪些环境变量及其加载顺序

正在调试 Gateway网关中缺失的 API 密钥

正在编写提供商认证或部署环境的文档

OpenClaw 从哪里加载环境变量及其优先级顺序

环境变量

generated_at	model	provider	source_hash	source_path	workflow
2026-02-01T20:24:58Z	claude-opus-4-5	pi	b49ae50e5d306612f89f93a86236188a4f2ec23f667e2388b043832be3ac1546	environment.md	14

环境变量

OpenClaw 从多个来源获取环境变量。规则是永远不覆盖已有的值。

优先级（从高到低）

进程环境（Gateway网关进程从父 shell/守护进程继承的变量）。
当前工作目录下的 .env（dotenv 默认行为；不覆盖已有值）。
全局 .env，位于 ~/.openclaw/.env（即 $OPENCLAW_STATE_DIR/.env；不覆盖已有值）。
配置文件中的 env 块，位于 ~/.openclaw/openclaw.json（仅在变量缺失时应用）。
可选的登录 shell 导入（env.shellEnv.enabled 或 OPENCLAW_LOAD_SHELL_ENV=1），仅对缺失的预期键生效。

如果配置文件完全不存在，则跳过步骤 4；如果已启用，shell 导入仍会运行。

配置文件 `env` 块

有两种等效方式设置内联环境变量（两者都不覆盖已有值）：

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

Shell 环境导入

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

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

等效的环境变量：

OPENCLAW_LOAD_SHELL_ENV=1
OPENCLAW_SHELL_ENV_TIMEOUT_MS=15000

配置中的环境变量替换

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

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

详情请参阅配置：环境变量替换。

2.3 KiB Raw Blame History Unescape Escape

环境变量

优先级（从高到低）

配置文件 env 块

Shell 环境导入

配置中的环境变量替换

相关内容

2.3 KiB

Raw Blame History

配置文件 `env` 块