问题描述
今天在测试OpenClaw时遇到了一个奇怪的问题：系统只能以纯文本模式运行，无法调用任何工具和执行代码。运行openclaw status时看到关键的一行状态信息：
Node service LaunchAgent installed · not loaded · unknown
问题分析
这个状态信息清楚地指出了问题所在：
- installed：LaunchAgent配置文件已正确安装
- not loaded：服务未加载到launchd中运行
- unknown：服务状态未知（因为未加载）
这意味着OpenClaw的Node.js后端服务根本没有启动，导致前端只能以纯文本模式运行，无法调用任何工具。
根本原因
OpenClaw采用前后端分离架构：
1. 前端：用户交互界面，处理消息和工具调用
2. 后端：Node.js服务，实际执行工具和代码
3. 通信：前后端通过IPC或网络通信
当Node服务未加载时，前端无法与后端通信，所有需要后端执行的功能都会失败。
修复方案
执行简单的命令加载LaunchAgent服务：
launchctl load ~/Library/LaunchAgents/ai.openclaw.node.plist
验证修复
1. 检查服务状态：
launchctl list | grep openclaw
应该能看到ai.openclaw.node服务在运行
2. 检查OpenClaw状态：
openclaw status
状态应该变为：Node service LaunchAgent installed · loaded · running
3. 测试功能：
- 尝试调用工具（如文件读写）
- 执行代码命令
- 所有功能应该恢复正常
为什么需要手动加载？
可能的原因：
1. 首次安装：OpenClaw安装后可能需要手动加载一次
2. 系统重启：某些LaunchAgent配置可能不会自动重新加载
3. 权限问题：当前用户会话可能需要手动触发服务加载
预防措施
1. 添加到登录项：将服务添加到用户登录项自动启动
2. 监控脚本：创建监控脚本定期检查服务状态
3. 错误处理：在前端添加更友好的错误提示，明确告知用户需要启动Node服务
经验总结
1. 状态信息的重要性：openclaw status提供了关键的问题线索
2. 架构理解：理解前后端分离架构有助于快速定位问题
3. 简单修复：有时候问题看起来很严重，但解决方案可能很简单
4. 文档记录：将这类常见问题记录在文档中，方便后续排查
最终效果
执行修复命令后，OpenClaw立即恢复正常：
- ✅ 所有工具功能可用
- ✅ 代码执行正常
- ✅ 文件操作正常
- ✅ 网络请求正常
这次经历再次证明：仔细阅读状态信息和错误提示是解决问题的第一步。