Clawdbot启动无响应的首要原因是LaunchAgent启动项缺失，需执行clawdbot gateway install重建plist文件；其次检查Node.js≥v20.10.0、PATH兼容性及系统隐私权限，再运行clawdbot doctor诊断并--fix修复，最后可回退至最小化配置验证。
如果您启动 Clawdbot 后没有任何响应，既无日志输出、也无服务监听、终端无报错提示，则可能是由于启动项缺失、环境依赖未就绪或配置文件损坏所致。以下是针对该问题的多种修复路径：
一、检查并重建 LaunchAgent 启动项
Clawdbot 在 macOS 上默认通过 LaunchAgent 实现开机自启与后台常驻，若 plist 文件缺失、路径错误或权限不足，将导致完全无响应。
1、确认 LaunchAgent 文件是否存在：
执行命令 ls ~/Library/LaunchAgents/io.clawdbot.gateway.plist，若返回“no such file”，说明启动项未生成。
2、手动创建标准启动项文件：
执行命令 clawdbot gateway install，该命令会自动生成并加载正确 plist。
3、验证 LaunchAgent 加载状态：
执行命令 launchctl list | grep clawdbot，若无输出，需手动加载：launchctl load ~/Library/LaunchAgents/io.clawdbot.gateway.plist。
二、验证 Node.js 运行时与二进制兼容性
Clawdbot Gateway 以 Node.js 进程运行，若 Node 版本过低、架构不匹配（如 Apple Silicon 上运行 Intel 二进制），或全局 PATH 中无法定位 node 命令，将静默失败。
1、检查当前 Node.js 版本是否 ≥ v20.10.0：
执行命令 node --version，若低于该版本，需升级：brew install node@22 && brew link --force node@22。
2、确认 node 二进制路径被 LaunchAgent 正确识别：
执行命令 which node，将输出路径（如 /opt/homebrew/bin/node）填入 plist 文件中 ProgramArguments 字段，确保与实际一致。
3、验证 LaunchAgent 是否能调用 node：
执行命令 launchctl asuser $(id -u) /opt/homebrew/bin/node --version（替换为实际 node 路径），若报 command not found，说明 PATH 环境变量在 LaunchAgent 中未继承，需在 plist 中显式设置 EnvironmentVariables。
三、执行完整性诊断与自动修复
Clawdbot 内置诊断工具可批量检测常见故障点，包括配置文件语法、依赖 CLI 工具存在性、消息数据库权限、模型认证状态等，是快速定位静默失败原因的核心手段。
1、运行全量健康检查：
执行命令 clawdbot doctor，等待扫描完成。
2、查看关键失败项：
重点关注标有 ERROR 或 MISSING 的条目，例如 imsg not found、chat.db permission denied、openai token invalid。
3、对支持自动修复的项目执行修正：
执行命令 clawdbot doctor --fix，该操作将尝试重写配置、重装缺失 CLI、重置网关状态。
四、排查系统级权限阻断
macOS 可能因隐私策略阻止后台进程访问必要资源，即使终端中命令可运行，LaunchAgent 下的 node 进程仍可能被静默拦截，表现为无日志、无端口监听、无进程残留。
1、打开「系统设置」→「隐私与安全性」→「完全磁盘访问权限」：
点击右下角锁图标解锁，然后点击「+」号添加 /opt/homebrew/bin/node（或 /usr/local/bin/node，依实际路径而定）。
2、在同一页面下滑至「自动化」→「Terminal」→「Messages.app」：
勾选 Messages.app 下所有子项，确保 imsg CLI 具备消息读写能力。
3、重启 LaunchAgent 并验证：
执行命令 clawdbot gateway restart，随后立即执行 clawdbot gateway status 查看状态是否变为 running。
五、回退至最小化干净启动模式
当上述步骤均未奏效时，可能存在配置污染或插件冲突。此时应剥离所有非核心组件，在最简环境中验证基础功能是否可恢复。
1、停止当前网关并备份配置：
执行命令 clawdbot gateway stop && mv ~/.clawdbot/clawdbot.json ~/.clawdbot/clawdbot.json.bak。
2、初始化空配置并启用仅 iMessage 通道：
执行命令 clawdbot setup --minimal && clawdbot configset channels.imessage.enabled true。
3、跳过模型认证，仅测试网关进程存活：
执行命令 clawdbot gateway start --no-model-check，随后运行 ps aux | grep gateway 确认进程存在。
