Claude Code会话监控

技能简介

Claude Code Supervisor 用于监督在 tmux 中运行的 Claude Code 会话。通过 Claude Code 的生命周期钩子结合 Bash 预过滤与快速 LLM 分流，检测错误、卡住代理和任务完成状态，支持多种通知后端。

能做什么

• 监控长时间运行的 Claude Code 后台任务
• 自动检测 API 错误或异常停止并发送提醒
• 从后台编码代理获取进度报告
• 在会话或上下文限制重置后继续工作
• 通过可配置命令对接 OpenClaw、webhook、ntfy 等通知系统

使用说明

安装依赖：需要预先安装 tmux 和 claude CLI。

步骤1：安装钩子到项目

{baseDir}/scripts/install-hooks.sh /path/to/your/project

此命令创建：.claude/hooks/supervisor/（钩子脚本+分流）、.claude/settings.json（接入 Claude Code 生命周期）、.claude-code-supervisor.yml（配置文件）。

步骤2：编辑配置

修改 .claude-code-supervisor.yml：

triage:
  command: "claude -p --no-session-persistence"
  model: "claude-haiku-4-20250414"

notify:
  command: "openclaw gateway call wake --params"

步骤3：注册受监控会话

创建状态文件 ~/.openclaw/workspace/supervisor-state.json，包含会话 socket、tmux 会话名、项目目录、目标、成功标准等字段。

步骤4：在 tmux 中启动 Claude Code

SOCKET="/tmp/openclaw-tmux-sockets/openclaw.sock"
tmux -S "$SOCKET" new -d -s my-task
tmux -S "$SOCKET" send-keys -t my-task "cd /path/to/project && claude 'Fix issue #42'" Enter

钩子自动触发，分流评估后仅在必要时发送通知。

输入与输出

见下方输入与输出表格。

风险提示

• 钩子依赖 Claude Code 进程存活，若会话崩溃、账户受限或被 OOM 终止，需依赖 watchdog 脚本捕获
• Bash 预过滤规则需根据实际使用场景调整，避免漏检或过度触发 LLM 调用
• 通知命令配置错误可能导致告警丢失
• tmux socket 路径权限问题会影响会话通信

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/johba37/claude-code-supervisor/SKILL.md
来源类型：GitHub 仓库