Clawd Presence

核心用法

Clawd Presence 是一款面向 AI 代理的终端级物理状态显示系统，核心解决"聊天交互存在延迟"的痛点。通过独立的终端窗口持续广播代理状态，用户可像看时钟一样快速感知 AI 当前活动。

部署流程：
1. 配置阶段：通过 configure.py 自动识别或手动设定单字母标识（A-Z）与代理名称
2. 运行阶段：在独立终端启动 display.py 作为常驻显示端
3. 集成阶段：在代理代码中嵌入 status.py 调用，任务切换时主动上报状态

状态机制：
系统内置五种可视化状态——work（执行中/绿色）、think（处理中/黄色）、idle（待命/青色）、alert（需人工/红色）、sleep（低功耗/蓝色）。支持自定义超时回退（默认5分钟无更新自动转 idle），防止状态过期误导。

显著优点

• 零延迟感知：颠覆"主动查询"模式，状态推送实现被动接收
• 极简集成：单命令状态上报，无需改造代理核心逻辑
• 视觉编码：颜色+单字母标识+进度描述，信息密度高
• 常驻友好：专为 always-on 场景设计，适合长期运行的自动化代理
• 资源轻量：纯终端渲染，无 GUI 依赖，服务器/边缘设备均可部署

潜在局限

• 物理空间依赖：需独立屏幕或终端窗口，单屏工作环境价值受限
• 信息维度单一：仅展示"正在做什么"，不展示"做得怎么样"（无进度百分比、无历史记录）
• 状态上报可靠：依赖代理主动调用，若代理崩溃则显示最后一次上报状态（虽有超时回退，但仍存在窗口期误导）
• 网络/进程隔离：display 与 status 通过文件或本地机制通信，分布式部署需额外适配

适合人群

• 运行长期自动化代理的开发者/运维者（如代码生成 agent、数据 pipeline agent）
• 需要物理可见性而不想持续盯聊天窗口的场景
• 多代理并行监控环境（配合 A-Z 单字母标识快速区分）
• 极简主义偏好者，拒绝 Web Dashboard 的复杂度

常规风险

• 状态不同步：代理异常退出未上报，显示端可能滞留错误状态（直至超时触发）
• 配置泄露：monogram 与代理名称可能暴露内部命名规范
• 终端持久化：长期运行终端可能因系统更新、SSH 断开等失效，需配合 tmux/screen 等工具
• 权限边界：status/configure 脚本需文件系统写权限，多用户环境需关注路径隔离

核心用法

Clawd Presence 是一款专为 AI 代理设计的终端状态可视化工具，通过独立的终端窗口持续展示代理的实时状态。核心工作流程包含三步：首先通过 configure.py 完成初始化配置（支持自动检测或手动指定字母标识与名称），随后运行 display.py 启动专用显示终端，最后由代理在任务执行过程中调用 status.py 更新状态。

状态系统采用五色编码直观传达代理状态：青色代表空闲等待、绿色表示正在执行任务、黄色指示数据处理中、红色警示需要人工干预、蓝色表示低功耗休眠。系统具备智能超时机制，5 分钟无状态更新自动回归空闲态，避免信息陈旧。

显著优点

1. 零延迟状态感知：颠覆传统对话交互模式，用户无需主动查询即可通过余光扫视获取代理状态，响应速度远超文字聊天。
2. 极简架构设计：纯 Python 标准库实现，零第三方依赖，从根本上消除供应链攻击风险，部署轻量可靠。
3. 高度可定制化：支持 A-Z 单字母标识自定义，26 款预设字母设计适配不同代理身份识别需求。
4. 安全隔离运行：全本地文件操作，无网络通信能力，敏感配置与状态数据完全离线存储。

潜在局限

1. 物理空间依赖：需要独立的显示终端或屏幕，对桌面空间有限的用户可能构成布置挑战。
2. 单节点限制：设计定位为单机可视化工具，不支持跨设备状态同步或远程监控。
3. 功能边界清晰：专注于状态展示，不具备交互控制能力，状态变更需通过独立脚本调用实现。

适合人群

• 长期运行 AI 代理的开发者与高级用户
• 追求物理环境感知与氛围感的效率工具爱好者
• 对供应链安全敏感、偏好零依赖部署的技术团队
• 需要构建"数字同事"存在感的人机协作场景

常规风险

虽然本工具通过 S+ 安全认证，但用户仍需注意：配置文件建议设置为 600 权限防止其他用户读取；显示终端长期运行需考虑屏幕功耗与烧屏风险；自动超时机制依赖本地时钟，系统时间异常可能导致状态判断偏差。