ClawMonitor App

中文 | English

一个基于 SwiftUI 的 Apple 平台应用，用于查看和操作 OpenClaw Sessions。

界面预览

macOS

iOS

当前仓库包含：

• macOS App：直接读取本机 OpenClaw / ClawMonitor 配置与会话数据
• iOS App：通过局域网连接 macOS 端，或通过 CloudKit 同步查看会话状态
• 共享核心模块：Session 数据模型、局域网 API、CloudKit 同步能力

功能概览

• 查看 Session 列表与详情
• 触发预设 nudge 动作
• 发送状态消息
• macOS 端导出报告
• iOS 端扫描局域网设备并连接到 macOS 端
• 可选 CloudKit 同步与远程动作队列

运行环境

• Xcode 16 或更高版本
• macOS 15+
• iOS 18+

快速开始

1. 克隆仓库：

git clone git@github.com:justFI/clawmonitor-app.git
cd clawmonitor-app

2. 用 Xcode 打开 ClawMonitorApple.xcodeproj。

3. 在 Xcode 中为 ClawMonitorMac / ClawMonitoriOS 配置你自己的签名信息：

• Signing & Capabilities 中选择你自己的 Team
• 将默认的 com.example.* Bundle Identifier 改成你自己的标识

4. 如果你计划使用 CloudKit：

• 为 target 打开 iCloud / CloudKit capability
• 视需要填写自己的 CloudKit Container Identifier

5. 先运行 ClawMonitorMac，确认本机能读取到 OpenClaw 数据。

6. 如需在 iPhone 上查看：

• 优先使用“扫描设备”自动发现 macOS 端服务
• 或手动填写局域网地址，例如 http://<你的-mac-ip>:48222
• 如果不走局域网，也可以改用 CloudKit 同步

使用方式

macOS

ClawMonitorMac 会默认从 ~/.config/clawmonitor/config.toml 读取配置，再定位本机 OpenClaw 数据目录。

你可以在应用中：

• 刷新 Session 列表
• 查看 Session 详情
• 发送 nudge
• 发送状态消息
• 导出报告
• 处理 CloudKit 远程动作队列

iOS

ClawMonitoriOS 提供两种主要使用方式：

• 局域网模式：连接同一网络下的 macOS 端服务
• CloudKit 模式：读取已同步到私有 CloudKit 数据库的 Session 快照和动作结果

如果局域网地址留空，iOS 端可以继续使用 CloudKit 模式。

项目结构

Apps/
  ClawMonitorApp/
    Shared/     共享 SwiftUI 界面与状态管理
    macOS/      macOS 入口
    iOS/        iOS 入口

Packages/
  ClawMonitorCore/        核心模型与本地 API
  ClawMonitorMacRuntime/  macOS 运行时与本地 HTTP 服务
  ClawMonitorSync/        CloudKit 同步能力

公开仓库说明

为了适合公开发布，仓库已经移除了本地构建产物、用户目录信息、签名团队标识和私人地址。你在本地使用前，需要自行补齐：

• Apple Developer Team
• Bundle Identifier
• CloudKit 容器配置

致谢与来源声明

本项目在设计和实现过程中，参考并使用了上游 ClawMonitor 项目的思路与能力设计，特别感谢原项目作者和贡献者：

• openclawq/clawmonitor

如果你需要更成熟的 CLI / TUI 方案，也建议关注上游项目。

License

本项目使用 MIT License，见 LICENSE。