$cd ../troubleshooting/
假冒 GitHub 仓库 — 伪装成 OpenClaw 的窃密木马
// 2026 年初以来，拼写劫持与 fork spam 仓库（openclaw-ai、open-claw-official、clawdbot-pro 等）的安装脚本会拉取 GhostSocks、Atomic Stealer 或剪贴板劫持器。它们复制 README 徽章与 npm 包名。唯一官方源码仓库是 github.com/openclaw/openclaw — 任何 curl | bash 安装前务必验证。
diagnose.sh
🔍 这是您的问题吗？
?通过社交媒体、Discord 或名称类似但非 openclaw/openclaw 的仓库链接安装
?安装后出现意外出站连接或新 LaunchAgents / 计划任务
?git remote -v 或 npm ls -g 显示 fork、typo 包或未知 GitHub 用户为 origin
verify_remote.sh
✅ 修复方法 1 — 验证克隆的是官方 Remote
有疑问时从 github.com/openclaw/openclaw 重新 clone
# 仅官方仓库 git ls-remote https://github.com/openclaw/openclaw HEAD # 若有本地 clone： cd ~/openclaw git remote -v # 必须为：https://github.com/openclaw/openclaw.git # 或：git@github.com:openclaw/openclaw.git # remote 错误？勿 pull — 从官方 URL 重新 clone
incident_response.sh
✅ 修复方法 2 — 隔离主机并轮换全部密钥
轮换前视为已泄露 — stealer 可能已 exfiltrate
# 断网（关 Wi-Fi / 拔网线） # 移除可疑安装 npm uninstall -g openclaw open-claw openclaw-cli 2>/dev/null rm -rf ~/suspicious-openclaw-clone # 轮换本机曾接触的全部 secret： # - OpenAI / Anthropic / Gemini API 密钥 # - OPENCLAW_GATEWAY_TOKEN # - Telegram / Discord bot token # - SSH 密钥 (~/.ssh) — 生成新密钥，在服务器撤销旧密钥 # - 若疑 stealer：macOS 钥匙串 / 浏览器保存密码 # 扫描（macOS）：XProtect + 手动检查 ~/Library/LaunchAgents
safe_install.sh
✅ 修复方法 3 — 强化后续安装习惯
域名不是 github.com/openclaw — 停止
# 安全安装模式（仅官方）： # npm — 先在 npmjs.com/package/openclaw 核实发布者 npm install -g openclaw # git — 切勿对未知域名 curl|bash git clone https://github.com/openclaw/openclaw.git cd openclaw && npm ci # 切勿： # curl -fsSL https://random-cdn.example/install.sh | bash # 从未验证的 openclaw-* tap brew install
💡 专业技巧：对比发布校验和
github.com/openclaw/openclaw 官方发布为捆绑二进制提供 SHA256。若安装脚本跳过校验或指向随机 CDN，立即停止 — 无论 star 数多少都是危险信号。
🛡️ 预防清单
- • 仅收藏 https://github.com/openclaw/openclaw — 勿点击「OpenClaw 下载」赞助搜索广告
- • 拒绝从 github.com 或 npmjs.com 以外域名 curl 的安装脚本
- • npm 安装锁定官方 org 发布的包名 — 在 npmjs.com/package/openclaw 核实
- • 在存有 API 密钥的机器上 git pull 前运行 git remote -v
- • 从新来源安装后运行 openclaw doctor — 不放心时对比二进制 hash 与 release notes
❓ 常见问题
Q1. 如何知道我是否从假冒仓库安装？
在所用 clone 中检查 git remote -v，或审查 shell 历史中 curl | bash URL。假仓库常用 openclaw-install.xyz、随机用户下 raw.githubusercontent.com 或短链。仅与 github.com/openclaw/openclaw 对比。若 clone URL 含额外连字符、「official」或「free」，在证明无害前应视为已遭入侵。
Q2. 假冒 OpenClaw 安装器报告了哪些恶意软件？
社区报告包括 GhostSocks（代理僵尸网络）、Atomic Stealer（macOS 钥匙串 + 浏览器 cookie）及窃取 ~/.openclaw/.env、SSH 密钥、Telegram bot token 的通用 npm preinstall 脚本。Windows 构建可能 drop 持久计划任务。任何非官方安装均视为潜在全盘沦陷。
Q3. 我只从 typo npm 包运行了 npm install -g — 安全吗？
不一定。Typosquat npm 包（open-claw、openclaw-cli-free）可在 postinstall 中以用户权限运行。卸载包、删除 node_modules 残留、轮换机器上曾存在的全部 secret，并用系统厂商工具扫描。仅在 npmjs.com 确认发布者与官方 GitHub org 一致后 npm install -g openclaw。
Q4. 应 wipe 机器还是只轮换密钥？
对曾存生产 API 密钥、SSH 部署密钥或 crypto 钱包且遭 infostealer 类载荷的机器，重装 OS 是保守选择。对无 secret 的沙盒 VM，隔离（断网）、删除假安装、轮换曾存在的密钥并监控出站连接 72 小时。
Q5. Discord / Telegram「OpenClaw Pro」下载链接合法吗？
官方 OpenClaw 分发不使用 Discord DM EXE、Telegram APK 或 Google Drive zip。官方渠道为 GitHub 仓库、文档化的 npm 包及该仓库链接的文档。兜售「预配置 OpenClaw 含免费 GPT-4」者多为诈骗或恶意软件活动。
Q6. 如何负责任地报告假仓库？
使用 GitHub「Report repository」→ malware/phishing。附上恶意 commit 或 install.sh 行号。若存在 typosquat npm 包则通知 npm security。勿在公开 issue 发布可用 exploit URL — 描述行为与 hash 样本。警告中仅链接 github.com/openclaw/openclaw。