【Bug已解决】openclaw: environment variable conflict / Config override issue — OpenClaw 环境变量冲突解决方案1. 问题描述OpenClaw 的环境变量与配置文件冲突导致配置不生效# 环境变量覆盖配置 $ cat .openclaw/config.json {model: claude-sonnet-4-20250514} $ export OPENCLAW_MODELclaude-3-haiku $ openclaw task # 使用了 haiku 而非配置中的 sonnet # 或多个环境变量冲突 $ export ANTHROPIC_API_KEYkey_A $ export OPENCLAW_API_KEYkey_B $ openclaw task # 不确定使用哪个 Key # 或 .env 和 .bashrc 冲突 $ cat .env ANTHROPIC_API_KEYkey_A $ cat ~/.bashrc export ANTHROPIC_API_KEYkey_B $ openclaw task # 使用了 key_B这个问题在以下场景中特别常见环境变量覆盖配置文件多个环境变量冲突.env 和 .bashrc 冲突旧变量残留CI/CD 环境变量注入2. 原因分析原因分类具体表现占比环境变量覆盖env config约 35%多变量冲突key_A vs key_B约 25%.env vs .bashrc加载顺序约 15%旧变量残留stale约 15%CI/CD 注入覆盖约 5%export 顺序后覆盖先约 5%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 21 | grep -i model\|api_key\|config方案二统一配置来源# 只使用一种配置方式环境变量 OR 配置文件 # 如果使用配置文件 unset OPENCLAW_MODEL cat .openclaw/config.json EOF {model: claude-sonnet-4-20250514} EOF # 或只使用环境变量 export ANTHROPIC_API_KEYsk-ant-api03-xxxxx export OPENCLAW_MODELclaude-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_KEYsk-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 21 | 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 hello4. 各方案对比总结方案适用场景推荐指数难度方案一检查变量排查⭐⭐⭐⭐⭐低方案二统一来源长期⭐⭐⭐⭐⭐低方案三.env 修复项目⭐⭐⭐⭐⭐低方案四清除旧变量残留⭐⭐⭐⭐⭐低方案五配置优先文件⭐⭐⭐⭐⭐低方案六CI/CD流水线⭐⭐⭐⭐低5. 常见问题 FAQ5.1 环境变量和配置文件的优先级环境变量通常优先于配置文件。清除环境变量让配置文件生效。5.2 如何检查环境变量env | grep -i OPENCLAW\|ANTHROPIC5.3 如何清除环境变量unset OPENCLAW_MODEL unset OPENCLAW_API_KEY5.4 .env 和 .bashrc 冲突统一到一个文件从另一个中删除相关行。5.5 CI/CD 中如何管理在 CI/CD 配置中设置 secrets清除冲突变量。5.6 旧变量残留使用unset清除所有旧变量重新设置。5.7 如何验证配置来源openclaw --debug 21 | grep -i config\|source\|env5.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_KEY6. 总结根本原因环境变量冲突最常见原因是环境变量覆盖配置35%和多变量冲突25%最佳实践使用env | grep -i OPENCLAW检查unset清除冲突变量统一来源选择一种配置方式环境变量或配置文件清除另一种.env 和 .bashrc统一到一个文件从另一个中删除最佳实践建议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[✅ 长期方案]