【Bug已解决】openclaw environment variable conflict / Config override issue — OpenClaw 环境变量冲突解决方案

【Bug已解决】openclaw: "environment variable conflict" / Config override issue — OpenClaw 环境变量冲突解决方案

1. 问题描述

OpenClaw 的环境变量与配置文件冲突，导致配置不生效：

# 环境变量覆盖配置 $ cat .openclaw/config.json {"model": "claude-sonnet-4-20250514"} $ export OPENCLAW_MODEL=claude-3-haiku $ openclaw "task" # 使用了 haiku 而非配置中的 sonnet # 或多个环境变量冲突 $ export ANTHROPIC_API_KEY=key_A $ export OPENCLAW_API_KEY=key_B $ openclaw "task" # 不确定使用哪个 Key # 或 .env 和 .bashrc 冲突 $ cat .env ANTHROPIC_API_KEY=key_A $ cat ~/.bashrc export ANTHROPIC_API_KEY=key_B $ openclaw "task" # 使用了 key_B

这个问题在以下场景中特别常见：

• 环境变量覆盖配置文件
• 多个环境变量冲突
• .env 和 .bashrc 冲突
• 旧变量残留
• CI/CD 环境变量注入

2. 原因分析

3. 解决方案

方案一：检查环境变量（最推荐）

# 步骤 1：检查所有相关环境变量 env | grep -i "OPENCLAW\|ANTHROPIC" # 步骤 2：检查特定变量 echo $OPENCLAW_MODEL echo $ANTHROPIC_API_KEY # 步骤 3：清除冲突变量 unset OPENCLAW_MODEL # 让配置文件生效 unset OPENCLAW_API_KEY # 只用 ANTHROPIC_API_KEY # 步骤 4：验证 openclaw --debug 2>&1 | grep -i "model\|api_key\|config"

方案二：统一配置来源

# 只使用一种配置方式：环境变量 OR 配置文件 # 如果使用配置文件 unset OPENCLAW_MODEL cat > .openclaw/config.json << 'EOF' {"model": "claude-sonnet-4-20250514"} EOF # 或只使用环境变量 export ANTHROPIC_API_KEY=sk-ant-api03-xxxxx export OPENCLAW_MODEL=claude-sonnet-4-20250514 # 验证 openclaw --print "hello"

方案三：修复 .env 和 .bashrc 冲突

# 步骤 1：检查 .env cat .env | grep -i "ANTHROPIC\|OPENCLAW" # 步骤 2：检查 .bashrc grep -i "ANTHROPIC\|OPENCLAW" ~/.bashrc # 步骤 3：统一到一个文件 sed -i '/ANTHROPIC\|OPENCLAW/d' ~/.bashrc source ~/.bashrc # 步骤 4：验证 env | grep -i "ANTHROPIC\|OPENCLAW" openclaw --print "hello"

方案四：清除旧变量

# 步骤 1：检查所有变量 env | grep -i "OPENCLAW" # 步骤 2：清除所有旧变量 unset OPENCLAW_MODEL unset OPENCLAW_API_KEY unset OPENCLAW_MAX_TOKENS # 步骤 3：重新设置 export ANTHROPIC_API_KEY=sk-ant-api03-xxxxx # 步骤 4：验证 openclaw --print "hello"

方案五：使用配置文件优先

# 步骤 1：清除环境变量 unset OPENCLAW_MODEL unset OPENCLAW_API_KEY # 步骤 2：创建配置文件 cat > .openclaw/config.json << 'EOF' { "model": "claude-sonnet-4-20250514", "maxTokens": 8192 } EOF # 步骤 3：验证 python3 -m json.tool .openclaw/config.json openclaw --print "hello" # 步骤 4：验证来源 openclaw --debug 2>&1 | grep -i "config\|source"

方案六：检查 CI/CD 注入

# 步骤 1：检查 CI/CD 变量 env | grep -i "CI\|OPENCLAW\|ANTHROPIC" # 步骤 2：在 CI/CD 配置中设置 # .github/workflows/ci.yml # env: # ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }} # 步骤 3：清除冲突变量 unset OPENCLAW_MODEL # 让 CI/CD 的 ANTHROPIC_API_KEY 生效 # 步骤 4：验证 openclaw --print "hello"

4. 各方案对比总结

5. 常见问题 FAQ

5.1 环境变量和配置文件的优先级

环境变量通常优先于配置文件。清除环境变量让配置文件生效。

5.2 如何检查环境变量

env | grep -i "OPENCLAW\|ANTHROPIC"

5.3 如何清除环境变量

unset OPENCLAW_MODEL unset OPENCLAW_API_KEY

5.4 .env 和 .bashrc 冲突

统一到一个文件，从另一个中删除相关行。

5.5 CI/CD 中如何管理

在 CI/CD 配置中设置 secrets，清除冲突变量。

5.6 旧变量残留

使用unset清除所有旧变量，重新设置。

5.7 如何验证配置来源

openclaw --debug 2>&1 | grep -i "config\|source\|env"

5.8 ANTHROPIC_API_KEY 和 OPENCLAW_API_KEY

只使用一个。推荐ANTHROPIC_API_KEY。

5.9 如何统一配置

选择一种方式（环境变量或配置文件），清除另一种。

5.10 排查清单速查表

□ 1. env | grep OPENCLAW 检查 □ 2. unset 清除冲突变量 □ 3. 统一到一种配置方式 □ 4. sed -i 清理 .bashrc □ 5. cat .env 检查项目配置 □ 6. python3 -m json.tool 验证 □ 7. openclaw --debug | grep config □ 8. CI/CD secrets 管理 □ 9. unset 旧变量重新设置 □ 10. 只用 ANTHROPIC_API_KEY

6. 总结

1. 根本原因：环境变量冲突最常见原因是环境变量覆盖配置（35%）和多变量冲突（25%）
2. 最佳实践：使用env | grep -i OPENCLAW检查，unset清除冲突变量
3. 统一来源：选择一种配置方式（环境变量或配置文件），清除另一种
4. .env 和 .bashrc：统一到一个文件，从另一个中删除
5. 最佳实践建议：CI/CD 中使用 secrets，只使用ANTHROPIC_API_KEY

故障排查流程图

flowchart TD A[环境变量冲突] --> B[env | grep OPENCLAW] B --> C{有冲突变量?} C -->|是| D[unset 清除] C -->|否| E[检查 .env] D --> F[openclaw --print hello] E --> G{.env 有冲突?} G -->|是| H[统一到 .env 或 .bashrc] G -->|否| I[检查 CI/CD] H --> F I --> J{CI/CD 注入?} J -->|是| K[清除冲突变量] J -->|否| L[检查旧变量] K --> F L --> M[unset 所有旧变量] M --> F F --> N{配置正确?} N -->|是| O[✅ 问题解决] N -->|否| P[使用配置文件] P --> Q[unset 所有环境变量] Q --> R[创建 config.json] R --> F O --> S[长期: 统一来源 + 清除冲突] S --> T[✅ 长期方案]