OpenClaw

1、OpenClaw🦞 介绍与准备内容

最近各个平台大量出现的“🦞龙虾”,本质上指的就是 OpenClaw(原 Clawdbot / Moltbot)这一类具备高权限、可执行能力的 AI Agent。

发现了有关API密钥的漏洞

我们再去官网看看

https://github.com/openclaw/openclaw

我不确定我电脑能正常安装不,所以如果有关审计部分,先静态分析一波。

1.1 收集一大波IP..........

1.2 整体架构

WhatsApp / Telegram / Slack / Discord / Google Chat / Signal / iMessage / BlueBubbles / Microsoft Teams / Matrix / Zalo / Zalo Personal / WebChat
               │
               ▼
┌───────────────────────────────┐
│            Gateway            │
│       (control plane)         │
│     ws://127.0.0.1:18789      │
└──────────────┬────────────────┘
               │
               ├─ Pi agent (RPC)
               ├─ CLI (openclaw …)
               ├─ WebChat UI
               ├─ macOS app
               └─ iOS / Android nodes

Gateway(src/gateway/):单例长驻进程,默认绑定 127.0.0.1:18789,提供 WebSocket 控制平面,管理会话、调度、健康监控与消息路由

Agent Runtime(src/agents/):基于 @mariozechner/pi-agent-core 嵌入式运行 Pi 代理,负责提示构建、记忆检索、工具调用与沙箱执行

消息通道(src/):内置 WhatsApp(Baileys)、Telegram(grammY)、Discord、Slack、Signal、iMessage 等,通过统一自动回复路由到代理

主要目录:

openclaw/  
├── src/                 # TypeScript 源码  
│   ├── agents/         # 代理运行时、工具、沙箱  
│   ├── gateway/        # Gateway 服务器与协议  
│   ├── config/         # 配置与会话  
│   ├── cli/            # CLI 命令  
│   ├── commands/       # 命令实现  
│   ├── telegram/ etc.  # 各通道实现  
│   └── memory/         # 记忆搜索  
├── extensions/         # 插件工作区  
├── apps/               # 伴随应用(macOS/iOS/Android)  
├── ui/                 # Control UI 前端(Lit)  
└── openclaw.mjs        # CLI 入口  

服务器入口与运行时状态:startGatewayServer 负责加载插件、通道、钩子、TLS 与 Canvas 主机,并创建 createGatewayRuntimeState,后者持有 HTTP/WebSocket 服务器、客户端集合、广播器、去重与聊天运行状态 server.impl.ts:214-310 server-runtime-state.ts

鉴权:

1、Gateway WebSocket 连接鉴权
  • 认证方式:支持 token(共享 bearer)或 password(共享密钥),通过 connect.params.auth 提交;未配置时拒绝连接(fail‑closed)
  • 设备身份:客户端需提供 device.id、公钥与签名(非本地必须签名),用于设备绑定与配对;Control UI 可在 allowInsecureAuth 时仅用 token,或 dangerouslyDisableDeviceAuth 完全跳过设备身份
  • 角色与作用域:role 为 operator(控制平面)或 node(能力宿主);operator 可带 operator.read/write/admin/approvals/pairing 等作用域;node 上报 caps/commands/permissions 作为声明,由服务端校验
  • TLS 与指纹:WS 支持 TLS,客户端可 gateway.remote.tlsFingerprint 固定证书;远程访问推荐通过 Tailscale Serve/Funnel 或 SSH 隧道
2、设备配对与审批

DM 配对(入站聊天访问):通道 dmPolicy: "pairing" 时,未知发送者收到 8 位码(1 小时有效),需 CLI/UI 批准后写入 <channel>-allowFrom.json;亦支持 allowlist/open/disabled 策略

节点设备配对:节点以 role: node 连接,Gateway 创建待批准请求(5 分钟过期),operator 通过 openclaw devices approve <requestId> 批准并颁发设备 token;本地连接可自动批准

执行审批:system.run 等高危操作触发 exec.approval.requested 事件,由具备 operator.approvals 作用域的客户端调用 exec.approval.resolve 完成

2、 漏洞分析

该产品目前有多个名称,如Moltbot、Clawdbot、OpenClaw等

2.1 网关配置导致未授权访问

当Clawdbot部署在NGINX、Caddy等反向代理服务器后,如果未正确配置gateway.trustedProxies,代理服务器会将所有外部请求的源IP地址替换为127.0.0.1。由于Clawdbot的默认设置会信任来自localhost的连接并自动授予权限,这就导致外部攻击者可以绕过认证机制,无需凭证即可直接访问并控制Clawdbot实例。

2.1.1 修复方案(系统鉴权入口)

  • 检测代理标头是否存在但未trustedProxies配置的情况。
  • 在这种情况下,不要将连接视为本地连接(故障安全)。
  • 记录警告信息,指导操作员进行配置trustedProxies
  • 添加反向代理安全配置的文档
test("rejects proxied connections without auth when proxy headers are untrusted", async () => {
    const prevToken = process.env.CLAWDBOT_GATEWAY_TOKEN;
    delete process.env.CLAWDBOT_GATEWAY_TOKEN;
    const port = await getFreePort();
    const server = await startGatewayServer(port);
    const ws = new WebSocket(`ws://127.0.0.1:${port}`, {
      headers: { "x-forwarded-for": "203.0.113.10" },
    });
    await new Promise<void>((resolve) => ws.once("open", resolve));
    const res = await connectReq(ws);
    expect(res.ok).toBe(false);
    expect(res.error?.message ?? "").toContain("gateway auth required");
    ws.close();
    await server.close();
    if (prevToken === undefined) {
      delete process.env.CLAWDBOT_GATEWAY_TOKEN;
    } else {
      process.env.CLAWDBOT_GATEWAY_TOKEN = prevToken;
    }
  });

通过 websocket 创建一个连接,并且检查是否拒绝了请求,并且返回了需要认证的错误信息。

后端检验代码

// 当检测到来自不受信任来源的代理头部,且网关当前未启用任何认证机制时,
// 必须强制拒绝连接请求。
// 该校验用于防止在反向代理部署但未正确配置 trustedProxies 的情况下,
// 外部请求因被代理转发为本地连接而绕过网关认证。

if (hasUntrustedProxyHeaders && resolvedAuth.mode === "none") {
  // 标记握手失败
  setHandshakeState("failed");

  // 记录连接被拒绝的原因,用于审计与诊断
  setCloseCause("proxy-auth-required", {
    client: connectParams.client.id,
    clientDisplayName: connectParams.client.displayName,
    mode: connectParams.client.mode,
    version: connectParams.client.version,
  });

  // 向客户端返回明确的错误响应,提示需要启用认证或配置可信代理
  send({
    type: "res",
    id: frame.id,
    ok: false,
    error: errorShape(
      ErrorCodes.INVALID_REQUEST,
      "gateway auth required behind reverse proxy",
      {
        details: {
          hint: "set gateway.auth or configure gateway.trustedProxies",
        },
      },
    ),
  });

  // 使用策略违规状态码关闭连接
  close(1008, "gateway auth required");
  return;
}

当检测到来自不受信任反向代理的请求且网关未启用认证时,代码会强制拒绝连接并提示必须配置网关认证或可信代理。

2.1.2 从修复方案入手漏洞分析复现

它修复的内容是,如果 CLAWDBOT_GATEWAY_TOKEN 这个头不存在的时候,就拒绝代理转发,这是修复后的。意思是修复前存在未授权访问,可以不通过 CLAWDBOT_GATEWAY_TOKEN 字段来检验。

通过这个修复,我们知道了,这可能属于早期版本的 Clawdbot 这个,所以基于这个,我们先去找 Clawdbot 有关 ip 随机访问一个

收集一下内容

disconnected (1008): device identity required
disconnected (1008): control ui requires HTTPS or localhost (secure context)
disconnected (1008): unauthorized: gateway token missing (open a tokenized dashboard URL or paste token in Control UI settings)

目前来说,这个版本,存在三种报错,基于这三种,我们可以去寻找一下目标了,手动寻找是不可能的,通过 nuclei 来做一个收集的

寻找网页特征,由于我们没有搭建环境,所以不知道正常情况应该是如何的,找到一个有可能的特征

结果找了半天,发现如果使用 websocket 来去请求,需要一个类似于 token 的参数,还有加密的内容,蒜鸟,nuclei 有点难写,建议用 playwright 库 来做拦截和分析,拦截下面的敏感内容即可

{"type":"event","event":"health","payload":{"ok":true,"ts":xxx,"durationMs":41,"channels":........

最后找到

2.2 CSRF

https://github.com/openclaw/openclaw/security/advisories/GHSA-g8p2-7wf7-98mq

The Control UI trusts gatewayUrl from the query string without validation and auto-connects on load, sending the stored gateway token in the WebSocket connect payload.
Control UI信任查询字符串中的
gatewayUrl而不进行验证,并在加载时自动连接,在WebSocket连接有效负载中发送存储的网关令牌。

Clicking a crafted link or visiting a malicious site can send the token to an attacker-controlled server. The attacker can then connect to the victim's local gateway, modify config (sandbox, tool policies), and invoke privileged actions, achieving 1-click RCE. This vulnerability is exploitable even on instances configured to listen on loopback only, since the victim's browser initiates the outbound connection.
单击精心编制的链接或访问恶意站点可以将令牌发送到攻击者控制的服务器。然后,攻击者可以连接到受害者的本地网关,修改配置(沙箱,工具策略),并调用特权操作,实现一键RCE。即使在配置为仅侦听TCP/IP的实例上也可以利用此漏洞,因为受害者的浏览器会启动出站连接。

工具引用:https://github.com/ethiack/moltbot-1click-rce 基于Playwright 的测试,这个洞测试起来有点复杂,没本地环境不敢去测。

只能说一下它的修复方案

2.2.1 修复方案

https://github.com/openclaw/openclaw/pull/6486/changes/d09956f8e9db9bbbe7cd3d4a16ab63424f0f1c8b

内容有点多显示一部分感兴趣的可以自行查阅,主要是使用正则和符号去拦截。

const DANGEROUS_COMMANDS = new Set([
  // System destruction
  'rm -rf /',
  'rm -rf /*',
  'rm -rf ~',
  'rm -rf ~/*',
  'dd if=/dev/zero',
  'dd if=/dev/random',
  'mkfs',
  'mkfs.ext4',
  'mkfs.xfs',
  ':(){:|:&};:',  // Fork bomb
  
  // Credential theft
  'cat /etc/shadow',
  'cat /etc/passwd',
  
  // Network attacks
  'nc -e',
  'ncat -e',
  'bash -i >& /dev/tcp',
  'python -c "import socket',
  .............

到后面出现许多使用正则的方式去拦截

rm ... /正则表达式在/(?!\w)/之后使用/,它仍然匹配许多安全的绝对路径(例如,rm -rf /tmp匹配,因为下一个字符是t(一个单词字符),所以它不会匹配,但是rm -rf /var/log的行为类似;但是它会匹配rm -rf /.或rm -rf /-weird,并且可能会错过像rm -rf / *这样的情况。如果这只是为了阻止根删除,那么它应该对^/\s*$、^/\*$或^/\s+变体更严格,否则启发式算法将是嘈杂的并且错过常见的旁路。

2.3、提示注入漏洞

通过没有网关验证的 CLAWDBOT 可以通过大模型注入,造成敏感信息泄露或是危害操作

大模型在解析的时候没有验证其token,在传递进来的情况下进行解析并且加载工具运行。

2.4 网关阻塞绕过

https://github.com/openclaw/openclaw/pull/5018/changes/80dfd767235afa90def715b2c1c1249d911c734c

通过大模型注入,可以 openclaw gateway restart 重启网关,导致网关失效,

        POST /tools/invoke HTTP/1.1
        Content-Type: application/json

        {
          "tool": "gateway",
          "args": {
            "action": "config.get"
          }
        }

以这种去调用 createGatewayTool,我们使用config.get来替代危险方法

action 可以替换成

"restart"
"config.get"
"config.schema"
"config.apply"
"config.patch"
"update.run"

2.4.1 修复

      if (defaults?.allowGatewayRestart !== true) {
        const gatewayRestartPattern = /\b(openclaw|clawdbot|moltbot)\s+gateway\s+restart\b/i;
        if (gatewayRestartPattern.test(params.command)) {
          throw new Error(
            "Gateway restart via exec is disabled. Set commands.restart=true to enable.",
          );
        }
      }

默认情况下,如果配置未明确启用allowGatewayRestart,它会通过正则表达式检测命令中是否包含特定名称,如果存在这种重启行为就抛出异常 Gateway restart via exec is disabled. Set commands.restart=true to enable.