这篇文章没有废话。所有内容按"问题现象 - 根本原因 - 解决方案"的三段式组织。建议收藏，遇到问题直接Ctrl+F搜索关键词。
环境准备阶段
问题01：执行node -v提示"不是内部或外部命令"
原因：Node.js未安装，或已安装但PATH环境变量未刷新。安装Node.js时如果没有勾选"Add to PATH"，系统找不到node命令。
解决：方案A，关闭当前CMD窗口，重新以管理员身份打开一个新的CMD窗口，再次执行node -v。方案B，如果仍然不行，卸载Node.js后重新安装，安装过程中确保勾选所有默认选项（包括"Add to PATH"）。方案C，手动添加PATH：将C:\Program Files\nodejs\添加到系统环境变量Path中。
问题02：Node.js版本低于22.x导致OpenClaw运行异常
原因：OpenClaw强制要求Node.js 22.x及以上版本。低版本Node.js的API与OpenClaw不兼容，会出现"Cannot find module"等报错。
解决：安装nvm-windows（Node版本管理工具）。执行nvm install 22安装22.x版本，然后执行nvm use 22切换到该版本。验证：node -v显示v22.x.x即可。
问题03：Git安装后命令不可用
原因：与Node.js同理，PATH未刷新。
解决：重新打开CMD窗口。如果安装时选择了"Git Bash Only"选项，则需要改用Git Bash而非CMD来执行Git命令。建议重新安装Git，使用默认设置。
安装阶段
问题04：npm install执行超时或卡住不动
原因：npm默认连接npmjs.org官方源，国内访问速度慢甚至超时。
解决：切换国内镜像源后重新安装。执行npm config set registry https://registry.npmmirror.com，然后重新执行安装命令：npm i -g openclaw@latest。
问题05：PowerShell中安装OpenClaw报错"禁止运行脚本"
原因：Windows默认的PowerShell执行策略为Restricted，禁止运行任何脚本。OpenClaw的安装脚本被安全策略拦截。
解决：方案A（推荐），放弃PowerShell，改用CMD（命令提示符）。以管理员身份运行CMD，所有安装命令在CMD中执行。方案B，解锁PowerShell执行策略：以管理员身份打开PowerShell，执行Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser，输入Y确认。
问题06：安装过程中报"EACCES permission denied"
原因：没有以管理员身份运行终端，npm全局安装需要写入系统目录的权限。
解决：关闭当前终端，右键CMD或PowerShell，选择"以管理员身份运行"，重新执行安装命令。
问题07：安装报错"npm ERR! code ERESOLVE"依赖冲突
原因：本机已有的npm包与OpenClaw依赖版本冲突。
解决：执行npm cache clean --force清除缓存，然后执行npm i -g openclaw@latest --force强制安装。
初始化阶段
问题08：执行openclaw onboard后提示无法连接LLM
原因：API Key未填写或填写错误，或选择的LLM服务商网络不通。
解决：重新执行openclaw onboard，按提示仔细填写API Key。推荐选择英伟达免费方案：前往developer.nvidia.com注册账号获取免费API Key。如果使用OpenAI等需要良好的网络环境的服务商，确保网络通畅。
问题09：初始化时"一路回车"后无法正常工作
原因：默认配置可能不适配你的环境。特别是LLM服务商选择和模型选择，默认值可能指向你没有权限使用的模型。
解决：重新执行openclaw onboard，在LLM服务商选择环节手动选择你有API Key的服务商，在模型选择环节选择该服务商提供的可用模型。
启动阶段
问题10：openclaw gateway start提示"端口18789被占用"
原因：另一个程序或另一个OpenClaw实例正在占用该端口。
解决：Windows下执行netstat -ano | findstr :18789找到占用端口的进程PID，然后在任务管理器中结束该进程。macOS/Linux下执行lsof -i:18789查看并kill对应进程。或者直接重启电脑。
问题11：网关启动成功但浏览器访问localhost:18789无响应
原因：浏览器地址栏需要输入完整的http://localhost:18789。部分浏览器会自动将localhost解析为HTTPS导致连接失败。
解决：在浏览器地址栏手动输入http://localhost:18789（注意是http不是https）。如果仍然无法访问，尝试用http://127.0.0.1:18789代替。
问题12：登录Web UI时令牌(Token)无效
原因：令牌过期或复制时多了空格。
解决：重新生成令牌：执行openclaw token generate。复制时注意不要带前后空格。Windows用户查看令牌可以打开文件C:\Users\你的用户名\.openclaw\openclaw.json，找到token字段。
本地模型对接阶段
问题13：Ollama安装后ollama serve报错
原因：Ollama未正确安装或系统不兼容。
解决：确认操作系统版本满足要求（Windows 10 64位以上、macOS 10.15以上）。重新从ollama.com下载最新版安装。Linux用户执行curl https://ollama.com/install.sh | sh。
问题14：模型下载ollama pull速度极慢
原因：Ollama模型托管在海外服务器，国内直连速度不稳定。
解决：使用网络优化工具加速下载。或寻找国内镜像源。下载过程可能需要十到二十分钟，耐心等待，不要中断。
问题15：对接Ollama时配置文件中API Key不知道填什么
原因：Ollama本地服务不需要真实的API Key认证，但OpenClaw的配置文件要求该字段不能为空。
解决：在config.json中将apiKey填写为任意非空字符串，如"apiKey": "ollama"。注意basePath必须用http://127.0.0.1:11434/v1，不要用localhost。
问题16：AI回答不完整，经常说到一半就停了
原因：模型默认上下文窗口太小（通常4096 tokens），无法处理较长的对话。
解决：创建扩展上下文的自定义模型。执行以下命令：echo "FROM qwen2.5:7b\nPARAMETER num_ctx 32768" > Modelfile，然后ollama create qwen2.5:7b-32k -f Modelfile。在OpenClaw配置中将model改为qwen2.5:7b-32k。
微信对接阶段
问题17：微信扫码后频繁掉线
原因：使用了新注册的微信号或长期未使用的账号，被微信安全策略标记为异常。
解决：使用日常活跃的主力微信号而非小号。掉线后在Web UI中重新扫码即可。保持终端窗口不关闭（关闭终端=关闭OpenClaw服务=微信掉线）。
问题18：微信能收消息但AI不回复
原因：OpenClaw的自动回复规则未配置，或LLM服务连接异常。
解决：进入Web UI控制面板，检查"自动回复"功能是否开启。检查LLM连接状态是否正常。在Chat窗口手动发送消息测试AI是否能回复。如果Chat窗口正常但微信不回复，检查微信对接的Webhook配置是否正确。