��OpenClaw Buddy v1.0.0 - “守望启航”

🌟项目地址： https://github.com/RandyChen1985/openclaw-buddy

[🌈!NOTE💗]“我听人说，如果连咖啡都没有伴侣，那它就不叫咖啡，叫苦水。在这个习惯了礼貌拒绝的时代，连空气中都带着独身的湿气。但我始终觉得，即使是代码堆砌的小龙虾，也该有个依靠。

OpenClaw Buddy，它就在离你 0.01 公分的地方。它不说话，只是陪你守着那些虾宝宝。希望有一天，你也能找到那个让你不再需要‘监控哨兵’的人。” [简体中文] | English

欢迎来到 OpenClaw Buddy 的第一个正式版本！🎉

本项目作为 OpenClaw (小龙虾 AI Agent) 的首个专业级带外管理 (Out-of-band Management) 与自愈伴侣系统，旨在为 AI 代理的运维提供“不灭的灯塔”。

✨ 核心亮点 (Key Highlights)

• 🛡️ 独立哨兵 (OOB)
  ：独立进程运行，即使 OpenClaw 网关崩溃，也能通过 Buddy 远程救回。
• 🩺 智能自愈
  ：内置多阶段自愈机制，检测到异常自动执行配置回滚（基于 backups/）。
• 📊 运维看板
  ：基于 React 的现代化 Web 控制面板，支持 WebSocket 实时日志追踪。
• 🤖 资产管理
  ：可视化管理所有 Bot 及模型映射，支持一键同步与强制转换。
• ⚡ 微信插件集成
  ：深度捕获微信登录流，实现“秒级”扫码授权。

一位 OpenClaw 深度用户的必备运维利器。

📸 功能预览

系统概览 (Dashboard)	流式登录 (Get QR)
安全登录 (Auth)	扫码登录 (Show QR)
虾兵蟹将 (Bots & Models)	对话实验室 (Online Chat)

✨ 核心特性

• 🖥️ 现代 Web 控制面板
  ：基于 React + Ant Design + Lucide 开发，支持响应式布局与 WebSocket 实时日志追踪。
• 🧪 对话实验室 (Online Chat)
  ：集成流式对话测试界面，支持一键开启/配置、快捷指令管理及 Markdown 渲染。
• 🛡️ 智能自愈系统 (Self-Healing)
• 多级回滚
  ：优先从 backups/ 目录恢复已知健康的配置快照。
• 全量持久化
  ：巡检历史与自愈事件通过 SQLite 持久化存储，支持审计与趋势分析。
• 📱 设备中心与授权
• 双态管理
  ：清晰区分“待处理连接请求”与“已配对合规设备”。
• 在线批准
  ：直接通过 Web 界面批准新设备的接入请求。
• 🤖 虾兵蟹将 (Bots/Models)
  ：自动解析 openclaw.json，直观展示机器人架构，支持手动强制刷新同步。
• 📺 微信插件深度管理
  ：自动化执行插件下载与启用配置，监听 openclaw 输出并实时捕获登录二维码。
• 📊 运行指标可视化
  ：实时查看 CPU、内存、磁盘负载及响应延迟趋势图。
• 🔄 异步任务管理
  ：关键操作（如重启）采用异步任务模式，支持任务状态追踪 (Task ID)。
• 🔗 龙虾面板透传
  ：集成 Reverse Proxy，支持通过 EXTERNAL_DASHBOARD_URL 在公网安全访问原生 UI。

🏗️ 系统架构

OpenClaw Buddy 采用非侵入式的“侧挂”架构，通过监控回路与管理链路实现对 OpenClaw 的全方位加固。

       [ 现代浏览器 / 移动端 ]                 │       [ OpenClaw Buddy Server ] (Go + Gin + React)                 │    ┌────────────┼────────────┐    │            │            │[ 监控自愈 ]   [ 资产管理 ]   [ 插件/授权 ]    │            │            │- 端口探针 (TCP)  - 模型直连测试  - 微信登录流捕获- 心跳/故障分析   - 资产强制同步  - 设备连接联机批准- 自动备份/回滚   - 默认模型分发  - 反向代理 (Native UI)- 趋势报表/入库   - 自定义渠道路由 - SQLite 状态持久化

🚀 快速下载与安装 (Installation Guide)

Important

获取路径：

https://github.com/RandyChen1985/openclaw-buddy/releases/tag/1.0.0

1. 下载已编译版本 (推荐)

• Linux (x64)
  : 下载 openclaw-buddy-linux-amd64.tar.gz
• macOS (Apple Silicon)
  : 下载 openclaw-buddy-macos-arm64.tar.gz

2. 部署步骤

1. 解压后进入目录：

   tar -zxvf openclaw-buddy-xxx.tar.gz

2. cd openclaw-buddy  (根据情况修改 env配置)

3. 启动守护：./start.sh

📂 路径说明 (File Path Reference)

如果你选择自行编译（./build_linux.sh），所有生成的发布产物将固定存放在项目的 ./release/ 目录下。

“即使是代码堆砌的小龙虾，也该有个依靠。” 🦐❤️