先按最短顺序定位，再按错误类型处理。大多数问题几分钟内就能解决。
优先判断是“打不开”“安装失败”“模型连不上”还是“运行后报错”，不要同时乱试多个方向。
一键包用户先处理权限、杀软、路径问题。只有明确走命令行安装时，才需要继续看 Node、Git、CLI 和 npm 错误。
这是 macOS Gatekeeper 的安全机制。两种解决方式：
方式一：前往「系统设置 → 隐私与安全性」，找到被拦截的应用，点击「仍要打开」。
方式二：在终端执行：
如果你走的是一键包路径，不需要先把它装进系统目录，优先对当前解压目录执行上面的命令即可。
弹出"Windows 已保护你的电脑"时，点击「更多信息」→「仍要运行」。底层的 OpenClaw 是开源软件，源码可在 GitHub 查看。
这通常不是安装包本身坏了，而是系统把“第一次出现的未签名文件”当成风险项。
常见关键词包括 permission denied (publickey)、git@github.com、exit 128。这通常表示当前机器没有正确处理 GitHub 拉取权限。
先确认 Git 已安装，再把 Git 拉取方式切到 HTTPS：
这通常表示文件被占用、被杀软拦截，或当前终端权限不足。
这表示文件没写完整、目录异常，或上次安装被中断了。
如果你走的是命令行安装路径，先清理 npm 缓存，再重新安装底层 CLI：
如果你走的是一键包路径，优先重新下载并解压到一个新的空目录，不要覆盖旧目录。
这类错误通常意味着底层依赖没装完整，或者 Node.js 版本太低。
native binding：先重装底层 CLIengine / unsupported：先升级 Node.js 到当前要求版本以上如果你只是想最快用起来，建议优先回到一键包路径，不要继续手动折腾命令行环境。
只有你明确走了命令行安装路径，才需要处理这个问题。一键包用户不需要手动调用 openclaw 命令。
关闭并重新打开终端窗口。如果仍然找不到：
检查以下几点：
几种解决方案：
这通常是网络、代理、证书或公司环境限制，不一定是模型本身有问题。
openclaw config set requestTimeout 60000openclaw gateway restartopenclaw sessions prune --older-than 7dopenclaw skills update --force/startopenclaw status微信接入是实验性功能。建议：