OpenClaw 实战 Debug 指南：让你的 AI 机器人稳定“起

一、开发者帮助与自检

核心技巧：手动前台启动网关，可直接查看报错，快速定位问题根源！

手动前台启动网关（直接在屏幕输出报错信息，排雷利器）

/usr/bin/node <path_to_openclaw>/dist/index.js gateway --port 18789

查看系统内存余量

free -h

查看命令帮助界面

openclaw --help

二、进程暴力清理 (遇到死锁必做)

注意：暴力清理会终止相关进程，建议先备份配置，再执行命令！

查看所有 Node.js 进程

ps aux | grep node

强制杀掉所有 OpenClaw 进程

pkill -9 -f openclaw

强制杀掉相关的 MCP 插件进程（如浏览器插件）

pkill -9 -f <plugin_name>

清理残留的锁文件（解决 Lock Timeout 报错的核心命令）

rm -rf /tmp/openclaw*

三、日志排查 (寻找死因)

日志是排查问题的关键，通过以下命令，快速找到 OpenClaw“罢工”的真正原因，精准定位故障点：

查看所有 Node.js 进程

ps aux | grep node

强制杀掉所有 OpenClaw 进程

pkill -9 -f openclaw

强制杀掉相关的 MCP 插件进程（如浏览器插件）

pkill -9 -f <plugin_name>

清理残留的锁文件（解决 Lock Timeout 报错的核心命令）

rm -rf /tmp/openclaw*

四、磁盘空间维护 (预防 OOM 与 100% 爆满)

磁盘爆满是 OpenClaw 频繁“罢工”的隐形杀手，定期维护磁盘空间，可有效预防故障，让机器人稳定运行：

查看各分区磁盘空间使用率

df -h

统计当前目录下各文件夹的大小（揪出占用大头）

du -h --max-depth=2 2>/dev/null | sort -hr | head -n 10

清空所有历史备份文件（瞬间释放空间）

rm -rf ~/.openclaw/backups/*

【专业建议】只保留最新 1 个备份，自动删除旧文件

cd ~/.openclaw/backups && ls -t | sed ‘1d’ | xargs -I {} rm “{}”

清理系统日志占用的空间（只保留最近 100M）

journalctl --vacuum-size=100M

清理软件包和 Node 缓存垃圾

apt-get clean
rm -rf ~/.npm/_cacache
rm -rf ~/.cache

五、飞书相关报错解决方案

为什么我在群里 @ 机器人，它装死不理我？

如果你的机器人私聊正常，但在群聊里没反应，通常是因为它被“门卫”拦住了，需要给特定的群发一张“通行证”。

在 openclaw.json 的 channels 部分，找到 groupPolicy。

如果它是 “allowlist”：说明开启了白名单模式，只有你点名准许的群，机器人才能说话。

机器人得知道它在哪个群。这个 ID 通常以 oc_ 开头。打开飞书群聊的设置即可在最下方找到。

找到后，在核心配置文件的 groups 这一块，按下面的格式把 ID 填进去：

  "groups": {                      // 具体的群聊权限管理
    "oc_xxxxxxxxxxxx": {           // 替换为具体的飞书群聊 ID (Group ID)
      "enabled": true,             // 是否在该群启用机器人
      "groupPolicy": "open"        // 该特定群聊的策略
    }
    // 如果有多个群，可以在下面继续添加 ID
  },

还有更简单的办法吗？

如果你觉得改代码太麻烦，怕改错逗号：

快捷方式：直接把你的会话 ID（或者把机器人拉进群后的截图/提示）发给虾虾，让它在后台帮你“暴力破门”直接爬进去，连重启服务器都省了！

注意事项

逗号别漏了：如果你添加了多个群，记得群 ID 之间要用逗号隔开。

重启生效：修改完 openclaw.json 后，别忘了执行 systemctl --user restart openclaw-gateway 让配置生效。