codebuddy接口调试前须确保node.js（≥v18.20）和npm（≥v8.0）环境就绪，重点排查path未生效及全局bin目录权限问题，按步骤修复后验证版本与写入能力。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
CodeBuddy接口调试前必须确认Node.js环境能稳定支撑CLI运行，否则codebuddy命令根本无法识别，所有调试动作都会卡在第一步。
验证Node.js与npm是否就位
打开终端（Windows用户请用PowerShell，不要用旧版CMD），直接执行：
node --version && npm --version
输出必须同时满足：Node.js ≥ v18.20，npm ≥ v8.0。若任一命令报“command not found”，说明环境变量没生效——【这是最常见卡点，90%的调试失败源于此】。
注意：Windows用户安装时务必勾选“Add to PATH”，且安装后必须关闭所有旧终端窗口，新开一个再验证。旧窗口不会自动继承新PATH。
修复PATH失效问题
方法一：Windows快速重载（推荐）
右键“开始”→“Windows PowerShell（管理员）”→执行：[Environment]::SetEnvironmentVariable("PATH", $env:PATH + ";C:\Program Files\nodejs\", "Machine")→重启PowerShell。
方法二：macOS/Linux手动追加
诊断并恢复通过 SSH 隧道连接的 OpenClaw 节点。用于解决配对必需错误、隧道冲突、远程端点错误以及 SSH 目标配置错误等问题。
编辑~/.zshrc或~/.bash_profile，末尾添加：export PATH="/usr/local/bin:$PATH"→执行source ~/.zshrc。
验证修复效果：在全新终端中再次运行node -v，看到版本号才算真正成功。
检查全局bin目录写入权限
第一步：确认npm全局路径可写
执行npm config get prefix，典型输出为/usr/local（macOS/Linux）或C:\Users\XXX\AppData\Roaming\npm（Windows）。
第二步：测试写入能力
运行npm install -g dummy-package-test，若报EACCES错误，说明权限不足——【此时不能硬加sudo，会破坏后续CLI权限模型】。
第三步：切换npm默认全局目录（安全方案）
① 创建新目录：mkdir ~/.npm-global
② 配置npm使用该目录：npm config set prefix ~/.npm-global
③ 将新目录加入PATH：export PATH=~/.npm-global/bin:$PATH（写入shell配置文件并source）
