openclaw配置中环境变量优先级高于config.json，全局元数据字段由系统自动写入，agents、models、channels、gateway与system模块均支持对应环境变量覆盖，覆盖规则需严格遵循文档说明。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在配置OpenClaw时发现某些行为未按预期生效，或环境变量与config.json中参数出现覆盖冲突，则很可能是由于环境变量优先级规则未被正确理解。以下是针对config.json核心参数的逐行解读及对应环境变量影响说明：
一、全局元数据字段
这些字段用于记录配置文件生命周期状态，不参与运行时逻辑，但影响热重载判断与版本兼容性校验。其值由系统自动写入，手动修改可能导致配置同步异常。
1、"lasttouchedversion"：标识当前配置文件最后一次被OpenClaw内部工具（如onboard向导）修改时所依据的软件版本号，格式为YYYY.M.D；
2、"lasttouchedat"：ISO 8601格式时间戳，精确到毫秒，表示该配置文件最近一次被写入磁盘的时间；
3、"lastrunat"：记录上一次执行初始化向导（onboard）命令的具体时间；
4、"lastruncommand"：固定值为"onboard"，表明该配置由交互式向导生成；
5、"lastrunmode"：取值为"local"或"cloud"，指示上次配置生成时所选部署模式。
二、agents模块：智能体行为控制中枢
该模块定义所有Agent实例的默认行为策略，是决定OpenClaw“思考方式”的核心区域。其中env字段支持环境变量注入，允许运行时动态覆盖。
1、"workspace"：指定本地工作目录路径，若值含环境变量如${HOME}或${OPENCLAW_WORKSPACE}，则以系统环境变量优先级为准；
2、"model.primary"：主模型标识符，格式为provider/model-id，当存在同名环境变量OPENCLAW_MODEL_PRIMARY时，将完全覆盖此值；
3、"model.fallbacks"：备用模型数组，环境变量OPENCLAW_MODEL_FALLBACKS需为JSON格式字符串，例如'["openai/gpt-5.2","qwen/qwen3-4b"]'；
4、"temperature"：控制输出随机性，环境变量OPENCLAW_TEMPERATURE为浮点数字符串，如"0.2"，覆盖后立即生效；
5、"heartbeat.every"：后台任务触发周期，支持单位缩写（m/s/h/d），环境变量OPENCLAW_HEARTBEAT_EVERY可直接替换该字符串。
三、models模块：模型服务连接参数
该模块集中管理各模型提供商的认证凭证与连接策略，所有敏感字段均支持通过环境变量注入，避免明文泄露风险。
1、"anthropic.api_key"：若配置文件中为"${ANTHROPIC_API_KEY}"，则实际值从环境变量ANTHROPIC_API_KEY读取；
完整的工作区安全套件：检测未授权修改，扫描提示注入模式，自动响应应对措施——快照恢复、技能隔离、Git回滚和自动保护扫描。智能体工作区的完整安装后安全层。
2、"openai.base_url"：用于指向私有OpenAI兼容API端点，环境变量OPENAI_BASE_URL优先级更高；
3、"qwen.endpoint"：阿里云Qwen模型调用地址，支持${QWEN_ENDPOINT}占位符，由环境变量QWEN_ENDPOINT填充；
4、"deepseek.timeout"：请求超时毫秒数，环境变量DEEPSEEK_TIMEOUT为整型字符串，如"30000"。
四、channels模块：多渠道接入配置
该模块控制OpenClaw对外通信通道的启用状态与参数，各子模块均遵循统一的环境变量注入机制，便于灰度发布与A/B测试。
1、"qq.enabled"：布尔开关，环境变量QQ_ENABLED值为"true"或"false"（小写）时生效；
2、"qq.appId"：应用ID字段支持${QQ_APP_ID}占位符，对应环境变量QQ_APP_ID；
3、"web.port"：Web服务监听端口，环境变量WEB_PORT为整数字符串，如"8000"；
4、"slack.bot_token"：Slack机器人令牌，必须通过${SLACK_BOT_TOKEN}引用环境变量SLACK_BOT_TOKEN；
5、"whatsapp.phone_id"：WhatsApp业务号码ID，环境变量WHATSAPP_PHONE_ID提供运行时值。
五、gateway与system模块：网关与系统级控制
该模块管理OpenClaw服务入口、资源限制及安全边界，多数参数具有强制性约束力，环境变量覆盖需谨慎评估。
1、"gateway.port"：网关HTTP端口，环境变量GATEWAY_PORT优先级最高，冲突时将拒绝启动；
2、"gateway.host"：绑定IP地址，${GATEWAY_HOST}可被GATEWAY_HOST环境变量替换；
3、"session.max_concurrent"：并发会话上限，环境变量SESSION_MAX_CONCURRENT为整数字符串；
4、"browser.headless"：浏览器无头模式开关，环境变量BROWSER_HEADLESS值为"true"/"false"；
5、"tools.allow_local_tasks"：本地指令执行权限，环境变量ALLOW_LOCAL_TASKS为"true"时才允许调用shell命令。
