跳转至

环境变量

OpenClaw 从多个来源获取环境变量。常规规则是绝不覆盖已有值。对于由 OpenClaw 安装的 systemd 服务,全局 .env 只能替换 OpenClaw 记录为受管的服务值。操作员拥有的服务值仍然优先。 工作区 .env 文件是较低信任度的来源:OpenClaw 在应用优先级之前,会忽略工作区 .env 中的提供商凭据和受保护的运行时控制。

Systemd 启动会保留配置引用的受管进程值,包括 $include 文件中的 ${VAR} 和 $VAR SecretRef 简写。这也涵盖 由操作员 EnvironmentFile= 提供的值。在受信任的 dotenv 文件和当前配置引用中均不存在的受管值,会从 Gateway 进程环境中移除。

优先级(从高到低)

  1. 进程环境(Gateway 进程已从父 shell/守护进程拥有的内容)。
  2. 当前工作目录中的 .env(dotenv 默认)。它不会覆盖。OpenClaw 会忽略此文件中的提供商凭据和受保护的运行时控制。
  3. 全局 .env,位于 ~/.openclaw/.env,也称为 $OPENCLAW_STATE_DIR/.env。推荐用于提供商 API 密钥。它不会覆盖,但 OpenClaw 记录的受管 systemd 服务值除外。
  4. ~/.openclaw/openclaw.json 中的配置 env 块(仅在缺失时应用)。
  5. 可选的登录 shell 导入(env.shellEnv.enabled 或 OPENCLAW_LOAD_SHELL_ENV=1),仅针对缺失的预期键应用。

在使用默认状态目录的全新 Ubuntu 安装中,OpenClaw 还会读取 ~/.config/openclaw/gateway.env。该文件是全局 .env 之后的兼容性回退。如果两个文件都存在且不一致,OpenClaw 会保留 ~/.openclaw/.env 并打印警告。

如果配置文件完全缺失,则跳过第 4 步。如果已启用,shell 导入仍会运行。

支持的操作员变量

以下变量是面向操作员的支持环境变量约定。未记录的 OPENCLAW_* 变量是内部实现细节,可能在不另行通知的情况下消失。

路径和实例

变量 用途
OPENCLAW_HOME 覆盖用于 OpenClaw 路径默认值的 home 目录。
OPENCLAW_STATE_DIR 覆盖可变状态目录。
OPENCLAW_CONFIG_PATH 覆盖当前配置文件路径。
OPENCLAW_WORKSPACE_DIR 覆盖默认 agent 工作区。
OPENCLAW_PROFILE 选择命名 profile 及其隔离默认值。
OPENCLAW_GIT_DIR 覆盖开发通道更新使用的源代码检出。
OPENCLAW_INCLUDE_ROOTS 允许 $include 从附加根目录解析。
OPENCLAW_SQLITE_LIBRARY 覆盖 macOS 上的 Bun 的 SQLite 库。

OPENCLAW_HOME

设置后,OPENCLAW_HOME 会替换系统 home 目录($HOME / os.homedir()),用于 OpenClaw 内部路径默认值。这包括默认状态目录、配置路径、agent 目录、凭据、安装程序入门工作区,以及 openclaw update --channel dev 使用的默认 dev 检出。

OPENCLAW_HOME 不会授予 OS 账户原生 Gateway 服务的所有权。Gateway 服务管理命令会将迁移后的 home 视为隔离状态。当需要单独的原生服务身份时,请使用 OS 账户 home 和命名 profile。

优先级: OPENCLAW_HOME > $HOME > USERPROFILE > Android 上 Termux PREFIX home 回退 > os.homedir()

空值以及字面字符串 undefined 和 null(去除首尾空白后)被视为未设置。在这种情况下,CLI 的 home 路径显示使用 ~;有效覆盖使用 $OPENCLAW_HOME。

示例(macOS LaunchDaemon):

<key>EnvironmentVariables</key>
<dict>
  <key>OPENCLAW_HOME</key>
  <string>/Users/user</string>
</dict>

OPENCLAW_HOME 也可以设置为波浪线路径(例如 ~/svc),使用前会按相同的 OS home 回退链展开。

诸如 OPENCLAW_STATE_DIR、OPENCLAW_CONFIG_PATH 和 OPENCLAW_GIT_DIR 等显式路径变量仍然优先。诸如 shell 启动文件检测、包管理器设置和主机 ~ 展开等 OS 账户任务仍可能使用真实系统 home。

临时编译缓存

打包版 OpenClaw 在设置 NODE_COMPILE_CACHE 时使用 NODE_COMPILE_CACHE/openclaw/<version>/<build>,否则使用 OS 临时目录下的 node-compile-cache/openclaw。子进程复用相同的构建命名空间。源代码检出保留现有的禁用缓存策略。

发布构建使用构建 ID 的稳定 16 字符哈希。在 Windows 上,OpenClaw 会跳过长度超过 200 个字符的缓存路径并给出警告,同时为子进程禁用不安全的继承缓存,以避免 Node 启动挂起。

编译缓存引导所有者会在后台工作线程中启动尽力而为的维护,该工作线程不会使 CLI 命令保持存活。Node 权限模式会跳过此维护,因为工作线程不会继承其文件系统限制;缓存条目会保留,直到由无限制调用或操作员移除。清理在命令退出时停止;长驻进程会为其提供完成时间。它会按单元移除已被取代的构建目录。最多每小时一次,或在退役另一个构建后,它会移除超过七天的字节码,并将当前缓存修剪到 512 MiB,优先删除最旧的文件。这是一个维护目标,而不是硬性磁盘配额:并发写入以及在清理完成前退出的进程可能暂时超过该目标。被中断的维护在一小时后有资格再次尝试。openclaw 子树之外的其他应用程序缓存会被保留。

Gateway 与身份验证

变量 用途
OPENCLAW_GATEWAY_URL 覆盖客户端使用的远程 Gateway URL。
OPENCLAW_GATEWAY_PORT 覆盖本地 Gateway 端口。
OPENCLAW_GATEWAY_TOKEN 为 Gateway 服务器和客户端提供 token 身份验证。
OPENCLAW_GATEWAY_PASSWORD 为 Gateway 服务器和客户端提供密码身份验证。
OPENCLAW_MAX_PREAUTH_CONNECTIONS_PER_IP 限制每个解析后的客户端 IP 的未认证 WebSocket 连接数(默认 128;正整数)。参见预身份验证连接限制。

提供商凭据

核心和内置提供商插件会识别以下凭据和提供商选择变量。当您需要作用域凭据,而不是一个进程级值时,请优先使用各提供商的配置或 SecretRef 字段。

AI_GATEWAY_API_KEY, ANTHROPIC_ADMIN_API_KEY, ANTHROPIC_ADMIN_KEY, ANTHROPIC_API_KEY, ANTHROPIC_OAUTH_TOKEN, ARCEEAI_API_KEY, AZURE_OPENAI_API_KEY, AZURE_SPEECH_API_KEY, AZURE_SPEECH_KEY, AZURE_SPEECH_REGION, BASETEN_API_KEY, BRAVE_API_KEY, BYTEPLUS_API_KEY, BYTEPLUS_SEED_SPEECH_API_KEY, CEREBRAS_API_KEY, CHUTES_API_KEY, CHUTES_OAUTH_TOKEN, CLAWROUTER_API_KEY, CLOUDFLARE_AI_GATEWAY_API_KEY, CODEX_API_KEY, COHERE_API_KEY, COMFY_API_KEY, COMFY_CLOUD_API_KEY, COPILOT_GITHUB_TOKEN, DASHSCOPE_API_KEY, DEEPGRAM_API_KEY, DEEPINFRA_API_KEY, DEEPSEEK_API_KEY, ELEVENLABS_API_KEY, EXA_API_KEY, FAL_API_KEY, FAL_KEY, FEATHERLESS_API_KEY, FIRECRAWL_API_KEY, FIREWORKS_API_KEY, FISH_API_KEY, FISH_AUDIO_API_KEY, GCLOUD_PROJECT, GEMINI_API_KEY, GMI_API_KEY, GOOGLE_API_KEY, GOOGLE_APPLICATION_CREDENTIALS, GOOGLE_CLOUD_API_KEY, GOOGLE_CLOUD_LOCATION, GOOGLE_CLOUD_PROJECT, GRADIUM_API_KEY, GROQ_API_KEY, HF_TOKEN, HUGGINGFACE_HUB_TOKEN, INWORLD_API_KEY, KILOCODE_API_KEY, KIMICODE_API_KEY, KIMI_API_KEY, LITELLM_API_KEY, LLAMA_SERVER_API_KEY, LM_API_TOKEN, LONGCAT_API_KEY, MINIMAX_API_KEY, MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY, MINIMAX_OAUTH_TOKEN, MISTRAL_API_KEY, MODELSTUDIO_API_KEY, MODEL_API_KEY, MOONSHOT_API_KEY, NOVITA_API_KEY, NVIDIA_API_KEY, OLLAMA_API_KEY, OPENAI_ADMIN_KEY, OPENAI_API_KEY, OPENCODE_API_KEY, OPENCODE_ZEN_API_KEY, OPENROUTER_API_KEY, PARALLEL_API_KEY, PERPLEXITY_API_KEY, PIXVERSE_API_KEY, QIANFAN_API_KEY, QWEN_API_KEY, QWEN_TOKEN_PLAN_API_KEY, RUNWAYML_API_SECRET, RUNWAY_API_KEY, SENSEAUDIO_API_KEY, SGLANG_API_KEY, SPEECH_KEY, SPEECH_REGION, STEPFUN_API_KEY, SYNTHETIC_API_KEY, TAVILY_API_KEY, TOGETHER_API_KEY, TOKENHUB_API_KEY, TOKENPLAN_API_KEY, VENICE_API_KEY, VLLM_API_KEY, VOLCANO_ENGINE_API_KEY, VOLCENGINE_TTS_API_KEY, VOLCENGINE_TTS_APPID, VOLCENGINE_TTS_TOKEN, VOYAGE_API_KEY, VYDRA_API_KEY, XAI_API_KEY, XIAOMI_API_KEY, XIAOMI_TOKEN_PLAN_API_KEY, XI_API_KEY, ZAI_API_KEY, 以及 Z_AI_API_KEY。

已安装的第三方插件可能在其插件清单中声明额外的凭据变量。这些变量是声明它们的插件的约定,而不是核心 OpenClaw 变量。

日志与诊断

变量 用途
OPENCLAW_LOG_LEVEL 覆盖文件和控制台日志级别。
OPENCLAW_DEBUG_MODEL_TRANSPORT 启用模型传输计时诊断。
OPENCLAW_DEBUG_MODEL_PAYLOAD 选择脱敏模型负载诊断。
OPENCLAW_DEBUG_SSE 选择 SSE 计时或事件预览诊断。
OPENCLAW_DEBUG_CODE_MODE 启用代码模式界面诊断。
OPENCLAW_DIAGNOSTICS 启用命名诊断标志,或使用 0 禁用所有标志。
OPENCLAW_DIAGNOSTICS_TIMELINE_PATH 选择时间线诊断的 JSONL 路径。
OPENCLAW_DIAGNOSTICS_EVENT_LOOP 向时间线诊断添加事件循环样本。

功能与运行时开关

变量 用途
OPENCLAW_CONFIG_READONLY 设置为 1 以使用外部管理的不可变配置。
变量 用途
OPENCLAW_LOAD_SHELL_ENV 从登录 shell 导入缺失的预期变量。
OPENCLAW_SHELL_ENV_TIMEOUT_MS 设置登录 shell 导入超时。
OPENCLAW_EXEC_SHELL_SNAPSHOT 使用 0 禁用 exec shell 快照。
OPENCLAW_OFFLINE 阻止下载固定版本的 agent helper 二进制文件。
OPENCLAW_BROWSER_HEADLESS 强制托管浏览器以有头(0)或无头(1)方式启动。
OPENCLAW_DISABLE_BONJOUR 强制启用(0)或禁用(1)Bonjour 广播。
OPENCLAW_NO_AUTO_UPDATE 禁用自动应用更新。
OPENCLAW_ALLOW_INSECURE_PRIVATE_WS 作为紧急覆盖,允许受信任的私有 DNS ws:// 连接。
OPENCLAW_ALLOW_MULTI_GATEWAY 在保留每个状态的所有权锁的同时,允许多个 Gateway 进程。
OPENCLAW_SKIP_CHANNELS 启动 Gateway 时不启用通道传输,用于故障排查。
OPENCLAW_THEME 强制 TUI 调色板为 light 或 dark。

文件系统观察

配置热重载、技能刷新、内存索引以及开发监视器使用 @openclaw/fs-safe/watch。现有的 CHOKIDAR_* 变量名称仍受支持,适用于 Docker、虚拟机以及其他需要观察偏好的部署:

变量 值 行为
CHOKIDAR_USEPOLLING 未设置、false、0 或空字符串 auto:优先使用原生事件,当没有事件后端时回退到轮询。
CHOKIDAR_USEPOLLING 其他任何非空值 选择 poll。值不区分大小写。
CHOKIDAR_INTERVAL 以毫秒为单位的正整数 显式轮询和自动回退的轮询间隔;覆盖以下默认值。

在 Linux、macOS 和 Windows 上的 Node.js 中支持原生事件。在 auto 模式下,Bun 以及没有原生后端的运行时使用与显式轮询相同的 CHOKIDAR_INTERVAL 设置进行轮询。原生事件保留 fs-safe 的 30 秒协调间隔。配置热重载和开发监视器默认使用 100 ms 轮询;内存索引和技能刷新默认使用 30000 ms,以限制空闲后台扫描。有效的显式 CHOKIDAR_INTERVAL 会覆盖这些默认值,最小值为 20 ms,最大值为 2147483647 ms。无效或非正值使用所有者的默认值。原生事件提示仍会触发提示更新;当使用自动轮询回退时,Memory 和 Skills 会为每个 watcher 记录一条警告。

恢复机制仍因每个所有者而异。配置热重载会使用其现有退避策略重试失败的订阅。当 CHOKIDAR_USEPOLLING 未设置时,原生监视失败还可以在这些重试之后触发一个新的轮询订阅。显式覆盖保留现有的重试限制。当原生监视容量耗尽(watch-limit)时,内存索引会切换到搜索时刷新。每个 Memory 订阅每次扫描最多允许 1,000,000 个目录和 1,000,000 个检查条目,包括被排除的条目。更大的目录树也会在观察重试耗尽后回退到搜索时刷新。容量耗尽后,Skills 会在 agent 准备期间刷新,如果观察失败,开发监视器会停止其子进程。

提供商凭据与工作区 .env

不要仅将提供商 API 密钥保存在工作区 .env 中。OpenClaw 会阻止大量提供商凭据和端点重定向密钥从工作区 .env 文件中加载,包括所有已知的提供商认证环境变量(例如 GEMINI_API_KEY、GOOGLE_API_KEY、XAI_API_KEY、MISTRAL_API_KEY、GROQ_API_KEY、DEEPSEEK_API_KEY、PERPLEXITY_API_KEY、BRAVE_API_KEY、TAVILY_API_KEY、EXA_API_KEY、FIRECRAWL_API_KEY),以及任何以 _API_HOST、_BASE_URL、_ENDPOINT 或 _HOMESERVER 结尾的密钥,还有整个 OPENCLAW_*、CLAWHUB_*、ANTHROPIC_API_KEY_* 和 OPENAI_API_KEY_* 命名空间。

请改用以下受信任来源之一来提供提供商凭据:

  • Gateway 进程环境,例如 shell、launchd/systemd 单元、容器机密或 CI 机密。
  • 位于 ~/.openclaw/.env 或 $OPENCLAW_STATE_DIR/.env 的全局运行时 dotenv 文件。
  • ~/.openclaw/openclaw.json 中的配置 env 块。
  • 当启用 env.shellEnv.enabled 或 OPENCLAW_LOAD_SHELL_ENV=1 时,可选的登录 shell 导入。

如果你之前仅将提供商密钥或端点路由值保存在工作区 .env 中,请将其移动到上述受信任来源之一。工作区 .env 仍可提供普通项目变量,只要它们不是凭据、端点重定向、主机覆盖或 OPENCLAW_* 运行时控制。

有关安全原因,请参阅 工作区 .env 文件。

配置 env 块

在 env.vars 下设置内联环境变量(值不会覆盖已有值):

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

配置 env.vars 块仅接受字面字符串值。它不会展开 file:... 值。例如,XAI_API_KEY: "file:secrets/xai-api-key.txt" 会作为该确切字符串传递给提供商。

对于基于文件的提供商密钥,请在支持该功能的凭据字段上使用 SecretRef:

{
  secrets: {
    providers: {
      xai_key_file: {
        source: "file",
        path: "~/.openclaw/secrets/xai-api-key.txt",
        mode: "singleValue",
      },
    },
  },
  models: {
    providers: {
      xai: {
        apiKey: { source: "file", provider: "xai_key_file", id: "value" },
      },
    },
  },
}

参见 Secrets 管理 和 SecretRef 凭据字段 了解支持的字段。

Shell 环境变量导入

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

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

环境变量等效项:

  • OPENCLAW_LOAD_SHELL_ENV=1
  • OPENCLAW_SHELL_ENV_TIMEOUT_MS=15000(默认 15000)

对于 Bash,导入会使用交互式登录 shell(bash -lic),以便在登录启动文件运行之前初始化 PS1。Bash 会读取 /etc/profile 以及第一个可用的用户登录 profile(~/.bash_profile、~/.bash_login 或 ~/.profile)。许多登录 profile 还会 source ~/.bashrc。请保持这些文件安静且范围有限,因为它们的输出、长时间运行的任务或失败可能会影响 OpenClaw 启动。其他 shell 使用非交互式登录启动(-l -c)。 该检查在独立会话中运行,并与你的终端分离,因此启动文件没有作业控制,也无法接管运行 OpenClaw 的终端。 此交互式 Bash 模式仅限于显式的 shell 环境变量导入。在普通 Gateway 命令期间自动发现可执行文件 PATH 仍保持非交互式。

成功的检查会被缓存。如果检查失败,下一次 shell 环境或 PATH 查找会重试。

Exec shell 快照

在非 Windows Gateway 主机上,bash 和 zsh 的 exec 命令默认使用启动快照。 在 Gateway 进程环境中设置 OPENCLAW_EXEC_SHELL_SNAPSHOT=0 可禁用此路径。 值 false、no 和 off 也会禁用它。每次调用的 exec.env 值无法切换 快照或重定向快照缓存。

运行时注入的环境变量

Gateway 端口监听器诊断和锁所有者身份检查会运行原生工具,并使用一个受限环境,其中包含可执行文件路径、操作系统引导和账户目录、 临时目录,以及已知的区域设置和时区设置。这些子进程不会继承提供商凭据、 应用令牌、代理、运行时注入变量或任意应用设置。 此边界保持父环境以及常规 agent、Gateway 和更新器负载环境不变。

OpenClaw 还会向生成的子进程注入上下文标记:

  • OPENCLAW_SHELL=exec:为通过 exec 工具运行的命令设置。
  • OPENCLAW_SHELL=acp-client:当 openclaw acp client 生成 ACP 桥接进程时设置。
  • OPENCLAW_SHELL=tui-local:为本地 TUI ! shell 命令设置。
  • OPENCLAW_CLI=1:为 CLI 入口点生成的子进程设置。

这些是运行时标记(不是必需的用户配置)。它们可用于 shell/profile 逻辑 中,以应用特定上下文的规则。

UI 环境变量

  • OPENCLAW_THEME=light:当你的终端具有浅色背景时,强制使用浅色 TUI 调色板。
  • OPENCLAW_THEME=dark:强制使用深色 TUI 调色板。
  • COLORFGBG:如果你的终端导出了它,OpenClaw 会使用背景颜色提示自动选择 TUI 调色板。

配置中的环境变量替换

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

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

缺失或空变量仍会显示为 ${VAR_NAME},并会发出警告。需要该值的消费者会将其视为不可用。如果意图是字面 ${VAR_NAME} 文本,请使用 $${VAR_NAME}。

参见 配置:环境变量替换 了解完整详情。

这适用于 openclaw.json 中的字符串值。它也适用于 openclaw.json 通过 $include 引入的任何文件。include 情况之所以有效,是因为替换在 include 解析之后对整个配置树运行。OpenClaw 的 dotenv 加载器不会展开环境变量值。例如,运行时 .env 文件中的 OPENCLAW_WORKSPACE_DIR=${XDG_CONFIG_HOME}/workspace 在 OpenClaw 加载时仍保持字面量。

由于 OpenClaw 不会展开这些值,请为路径变量提供完全解析的绝对路径。OPENCLAW_WORKSPACE_DIR 也不会展开开头的 ~,因为它直接传给 path.resolve。OPENCLAW_STATE_DIR 和 OPENCLAW_CONFIG_PATH 会展开 ~。工作区本地 .env 文件会丢弃整个 OPENCLAW_* 命名空间,因为它是不可信输入。请在受信任的全局 .env 中设置这些变量,位于 $OPENCLAW_STATE_DIR/.env,默认情况下为 ~/.openclaw/.env。

Docker Compose 遵循其自身的 插值规则。在捆绑的 docker-compose.yml 中,来自项目 .env 的 OPENCLAW_WORKSPACE_DIR 会选择工作区绑定挂载的主机目录。容器侧的 OPENCLAW_WORKSPACE_DIR 保持固定为 /home/node/.openclaw/workspace。

Secret 引用与 ${ENV} 字符串

OpenClaw 支持两种由环境变量驱动的模式:

  • 配置值中的 ${VAR} 字符串替换。
  • 用于支持 secrets 引用的字段的 SecretRef 对象({ source: "env", provider: "default", id: "VAR" })。

两者都会在激活时从进程环境变量中解析。SecretRef 详情记录在 Secrets 管理 中。 配置 env 块本身不会解析 SecretRef 或 file:... 简写值。

变量 用途
OPENCLAW_HOME 覆盖用于内部 OpenClaw 路径默认值的主目录(~/.openclaw/、agent 目录、sessions、credentials、installer onboarding 以及默认 dev checkout)。在将 OpenClaw 作为专用服务用户运行时很有用。
OPENCLAW_STATE_DIR 覆盖状态目录(默认 ~/.openclaw)。
OPENCLAW_CONFIG_PATH 覆盖配置文件路径(默认 ~/.openclaw/openclaw.json)。
OPENCLAW_INCLUDE_ROOTS 目录路径列表,允许 $include 指令在配置目录之外解析文件(默认:无 - $include 限制在配置目录内)。会进行波浪号展开。

代理辅助工具下载

设置 OPENCLAW_OFFLINE=1 可阻止 OpenClaw 下载其固定版本的 fd 和 ripgrep 辅助二进制文件。OpenClaw 工具目录中已有的辅助工具以及可用的系统二进制文件仍然可用。缺失的辅助工具将保持不可用,而不会触发网络请求。

日志

变量 用途
OPENCLAW_LOG_LEVEL 覆盖文件和控制台的日志级别(例如 debug、trace)。优先于配置中的 logging.level 和 logging.consoleLevel。无效值会被忽略并给出警告。
OPENCLAW_DEBUG_MODEL_TRANSPORT 在 info 级别输出有针对性的模型请求/响应计时诊断,而无需启用全局调试日志。
OPENCLAW_DEBUG_MODEL_PAYLOAD 模型负载诊断:summary、tools 或 full-redacted。full-redacted 有上限并会脱敏,但可能包含 prompt/message 文本。
OPENCLAW_DEBUG_SSE 流式诊断:events 用于 first/done 计时,peek 用于包含前五个脱敏 SSE 事件。
OPENCLAW_DEBUG_CODE_MODE Code-mode 模型表面诊断,包括 provider-tool 隐藏以及 compact control/direct 强制执行。

nvm 用户:web_fetch TLS 故障

如果 Node.js 是通过 nvm(而非系统包管理器)安装的,内置的 fetch() 会使用 nvm 捆绑的 CA 存储,其中可能缺少现代根 CA(例如 Let's Encrypt 的 ISRG Root X1/X2、 DigiCert Global Root G2 等)。这会导致 web_fetch 在大多数 HTTPS 站点上以 "fetch failed" 失败。

在 Linux 上,OpenClaw 会自动检测 nvm,并在实际启动环境中应用修复:

  • openclaw gateway install 会将 NODE_EXTRA_CA_CERTS 写入 systemd 服务环境
  • openclaw CLI 入口点会在 Node 启动前设置 NODE_EXTRA_CA_CERTS 并重新执行自身

手动修复(适用于旧版本或直接 node ... 启动):

在启动 OpenClaw 之前导出该变量:

export NODE_EXTRA_CA_CERTS=/etc/ssl/certs/ca-certificates.crt
openclaw gateway run

不要仅依赖将此变量写入 ~/.openclaw/.env。Node 会在进程启动时读取 NODE_EXTRA_CA_CERTS。

旧版环境变量

OpenClaw 特定的运行时控制使用 OPENCLAW_* 前缀。早期版本中的旧版 CLAWDBOT_* 和 MOLTBOT_* 前缀会被静默忽略。受支持的 provider 和文件系统观察变量保留其 文档中记载的名称。

如果启动时 Gateway 进程上仍设置了任何旧变量,OpenClaw 会发出单个 Node 弃用警告(OPENCLAW_LEGACY_ENV_VARS),列出 检测到的前缀和总数。通过将旧前缀替换为 OPENCLAW_ 来重命名每个值(例如将 CLAWDBOT_GATEWAY_TOKEN 改为 OPENCLAW_GATEWAY_TOKEN)。旧名称不生效。

本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw