Clawdbot命令无效需依次排查：一、确认Node.js≥22且PowerShell策略为RemoteSigned；二、将npm全局路径加入PATH并重启终端；三、检查clawdbot符号链接，失效则npm link或用npx临时运行；四、验证安装脚本可访问、清除缓存重装；五、macOS避开SIP限制，Windows添加安全软件排除项。
如果您已完成 Clawdbot 安装，但在终端执行 clawdbot 命令后无响应、报错或提示“command not found”，则可能是由于运行环境未正确配置或安装路径未纳入系统 PATH。以下是解决此问题的步骤：
一、验证 Node.js 版本与权限配置
Clawdbot 依赖 Node.js 22+ 运行时，且要求脚本执行策略允许本地模块加载。若 Node.js 版本过低或 PowerShell 执行策略受限，将导致 CLI 无法初始化。
1、在终端中运行 node --version，确认输出为 v22.x.x 或更高版本。
2、若版本低于 v22，使用 nvm 切换：运行 nvm install 22 && nvm use 22 && nvm alias default 22。
3、在 Windows PowerShell 中以管理员身份运行，输入 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser，解除脚本执行限制。
二、检查全局 CLI 安装路径是否加入 PATH
通过 npm 全局安装的 clawdbot 二进制文件需位于系统可识别的 PATH 目录中；否则 shell 将无法定位命令。
1、运行 npm list -g clawdbot，确认包已成功安装且显示具体路径。
2、运行 npm config get prefix，获取全局安装前缀（如 C:\Users\XXX\AppData\Roaming\npm）。
3、将该前缀路径添加至系统环境变量 PATH 中（Windows：系统属性 → 高级 → 环境变量 → 用户变量 PATH → 新建；macOS/Linux：在 ~/.zshrc 或 ~/.bash_profile 中追加 export PATH="$(npm config get prefix)/bin:$PATH"）。
4、重启终端或运行 source ~/.zshrc（macOS/Linux）或重新打开 PowerShell（Windows），再试 clawdbot --version。
三、排查 CLI 符号链接失效问题
npm 全局安装时可能因权限或缓存异常导致 bin 目录下的 clawdbot 可执行链接损坏或缺失，表现为命令存在但无法调用主程序。
1、运行 which clawdbot（macOS/Linux）或 where clawdbot（Windows），查看是否返回有效路径。
2、若无输出或路径指向不存在的文件，手动重建链接：进入 npm prefix bin 目录，执行 npm link clawdbot。
3、若仍失败，改用 npx clawdbot 临时运行，验证核心功能是否正常。
四、验证安装脚本完整性与网络代理状态
一键安装脚本（curl 方式）若在下载或执行阶段被中断，可能导致部分二进制或配置文件缺失，尤其在国内网络环境下易受 DNS 污染或 TLS 握手失败影响。
1、运行 curl -fsSL https://clawd.bot/install.sh | head -n 20，确认能正常获取脚本开头内容。
2、若超时或返回空，说明网络不可达；此时需确保终端已启用支持 Tun 模式的代理，并设置 export https_proxy=http://127.0.0.1:7890（端口按实际代理工具调整）。
3、清除 npm 缓存并重装：npm cache clean --force && npm uninstall -g clawdbot && npm install -g clawdbot。
五、检查系统完整性保护（macOS）或防病毒拦截（Windows）
macOS 的 SIP（System Integrity Protection）可能阻止 clawdbot 对 /usr/local/bin 的写入；Windows Defender 或第三方安全软件可能将 clawdbot 临时进程误判为风险行为并终止。
1、macOS 用户运行 csrutil status，若显示 enabled，避免将 clawdbot 安装至受保护路径，改用 --prefix 指定用户目录（如 ~/local）。
2、Windows 用户打开 Windows 安全中心 → 病毒和威胁防护 → 管理设置 → 添加 clawdbot.exe 和 node.exe 所在目录为排除项。
3、临时关闭实时防护后重试 clawdbot setup，观察是否仍被拦截。
