远飞闲记
·
Open Claw(🦞龙虾): 新手最常踩的 8 个坑，我帮你踩过了
💡
原文中文，约4400字，阅读约需11分钟。
📝
内容提要
本文总结了新手使用OpenClaw时常遇到的八个问题，包括Node.js版本不匹配、Gateway启动问题、配置文件位置不明、Control UI连接失败、安全风险、API Key错误、环境变量设置无效及日志查找困难。建议用户注意Node版本、正确配置JSON文件、设置白名单以确保安全，并通过日志调试解决问题。
🎯
关键要点
-
坑1：Node.js 版本不对导致安装失败，推荐使用 Node 24，最低支持 Node 22.14+。
-
坑2：安装后需要手动启动 Gateway，使用命令 openclaw gateway start。
-
坑3：配置文件默认在 ~/.openclaw/openclaw.json，需注意 JSON 格式。
-
坑4：Control UI 连接失败可能是 Gateway 未启动或端口被占用，需检查状态和端口。
-
坑5：未配置白名单会导致安全风险，建议在生产环境中配置白名单。
-
坑6：API Key 配置错误或额度不足会导致发送消息失败，需重新配置 API Key。
-
坑7：环境变量设置不生效可能是名称错误或加载顺序问题，需正确设置。
-
坑8：日志和调试信息找不到可通过 openclaw logs 查看，开启 Debug 模式可获取详细信息。
❓
延伸问答
OpenClaw安装时Node.js版本有什么要求？
OpenClaw推荐使用Node 24，最低支持Node 22.14+。
如何启动OpenClaw的Gateway服务？
可以使用命令openclaw gateway start手动启动Gateway。
OpenClaw的配置文件在哪里？
配置文件默认在~/.openclaw/openclaw.json。
如果Control UI连接失败，我该怎么办？
检查Gateway是否启动，端口是否被占用，或防火墙设置。
为什么需要配置白名单？
未配置白名单会导致安全风险，任何人都能给机器人发消息。
如何查看OpenClaw的日志？
可以使用命令openclaw logs查看实时日志，或保存到文件分析。
➡️
