环境与调试(debug)

Node + tsx 崩溃

运行 OpenClaw 网关或 CLI 时,如果遇到 Node.js 或 tsx 崩溃(比如 node --import tsx 或使用 tsx 的脚本),本页会帮你排查问题。

常见原因

  • Node 版本:OpenClaw 需要 Node 22 或更高版本。版本过低可能导致运行时错误或原生模块崩溃。
  • tsx / 加载器:启动时崩溃或加载 TypeScript 失败,可能是 tsx 版本问题、--import 参数顺序不对,或者与其他加载器冲突。
  • 内存 / 原生模块:大负载或原生插件可能触发内存溢出(OOM)或段错误。版本和环境配置建议请参考 Node.js

快速排查步骤

  1. 检查 Node 版本:运行 node -v,确认显示 v22 或更高版本。
  2. 不用 tsx 复现:用纯 node 运行预编译的 JS,看是否还会崩溃。这样可以判断问题是否与 tsx 相关。
  3. 开启诊断日志:使用 诊断标志(如 OPENCLAW_DEBUG_*),在崩溃前获取更多日志信息。

相关链接