ClaudeMap

cc-tg-watchdog

在 VPS 上守护 Claude Code + Telegram 长驻会话的实战看门狗脚本——自动重启、漏回消息补回、凭证刷新，每 3 分钟检查一次。

插件与代理watchdogtelegramvpslong-runningshell
访问项目kittenshome/cc-tg-watchdog

在 VPS 的 tmux 里跑 claude --channels plugin:telegram@claude-plugins-official，迟早撞全所有故障模式：tmux 进程悄悄死掉、额度弹窗把会话卡住、Telegram 的 Bun 进程断连、凭证过期陷入 401 死循环、上下文越滚越大每句话都烧一把 token，或者重启那一瞬间正好来了消息。cc-tg-watchdog 是一组 shell 脚本（watchdog.sh 健康检查、start.sh 完整重启流程、orphan-recovery.py 漏回消息检测），挂进每 3 分钟一次的 crontab：出问题时杀掉旧进程、补回没人理的消息、尝试刷新凭证、拉起新 tmux 会话并验证 Telegram 连接。依赖很轻——tmux、python3、flock、timeout、ss——README 强烈建议给 Telegram 单独配一个 CLAUDE_CONFIG_DIR，避免看门狗碰到你日常的 Claude Code 会话。中文文档。MIT。

它做什么

  • crontab 每 3 分钟跑一次健康检查；健康时直接跳过，看门狗不添乱
  • 六种故障模式全覆盖：tmux 静默死亡、额度弹窗卡死、Bun 断连、401 过期循环、上下文失控、重启瞬间丢消息
  • orphan-recovery.py 扫描会话记录找出没人回复的消息，补回到新会话里
  • 自带安全护栏：建议专用 CLAUDE_CONFIG_DIR，并明确警告不要提交凭证与会话 JSONL

什么时候用

把 Claude Code 当 24/7 Telegram 机器人跑在便宜 VPS 上的人——那种「配完就忘」的场景：凌晨四点额度弹窗落地时，没人在终端旁边看着。

如何上手

cp watchdog.sh ~/tgbot-watchdog.sh
cp start.sh ~/tgbot.sh
cp orphan-recovery.py ~/tgbot-orphan.py
chmod +x ~/tgbot-watchdog.sh ~/tgbot.sh

crontab -e
# 加一行：
*/3 * * * * /root/tgbot-watchdog.sh

注意事项

作者开宗明义：这是从个人环境整理出的脚本集——不是 Anthropic 或 Telegram 官方组件，也不保证完全不丢消息。默认阈值与进程特征可能随 Claude Code 或插件版本变化，务必先在测试 bot 上验证再上生产。它靠进程特征管理会话，非常规的启动方式可能需要自己调阈值。MIT。

代码仓库

kittenshome/cc-tg-watchdog

收录日期

地图上的相关资源

  • CometixCode

    插件 / 代理

    非官方的 Claude Code 终端 UI 复刻：用 Rust 按 1:1 逐文件移植到 iocraft 这套 React 风格 TUI 框架上。

    • terminal-ui
    • rust
    • reimplementation
    • unofficial
    查看

  • Abide

    插件 / 代理

    把 AGENTS.md、CLAUDE.md 里的自然语言规则变成钩子级强制：每次编辑都被评审，违规当场修复。

    • hooks
    • code-review
    • rules
    • agents-md
    查看

  • fast-jev-compaction

    插件 / 代理

    用 Jev 评分式修剪取代有损压缩摘要的 Claude Code 插件：过期的工具调用被丢弃，保留下来的内容原样不动。

    • plugin
    • context-management
    • compaction
    • function-hooks
    查看