终端状态显示器

技能简介

Clawd Presence 是一款为 AI 代理设计的终端物理状态显示器。它在专用终端或屏幕上持续展示可自定义的字母标识（A-Z）、当前状态和活动信息，让用户无需打开聊天窗口即可快速了解代理正在执行的任务。

业务背景

为运维和研发团队提供AI代理的实时可视化监控能力，通过独立终端窗口持续展示代理标识、状态颜色和当前活动，实现无需切换聊天界面即可快速掌握多代理运行状况，有效降低系统监控的认知负荷与响应延迟。

落地案例：某DevOps团队部署三个AI代理分别负责日志分析、告警处理和自动化修复，通过终端状态显示器为各代理分配字母标识L、A、R并配置专属颜色。值班人员从集中监控屏幕一眼识别：绿色L代理处于空闲待命，黄色A代理正在处理告警队列，红色R代理因需人工确认而闪烁提示，从而实现异常情况的秒级定位与介入。

能做什么

• 在独立终端窗口实时显示代理状态
• 支持 5 种颜色区分的状态：空闲、工作中、思考中、需关注、休眠
• 通过命令行快速更新当前活动描述
• 自动检测配置或手动设置标识字母和名称
• 无操作 5 分钟后自动返回空闲状态，避免信息过时

使用说明

安装与配置

# 克隆仓库后进入目录
cd clawd-presence

# 自动配置（从 clawdbot 检测）
python3 scripts/configure.py --auto

# 或手动配置
python3 scripts/configure.py --letter A --name "AGENT"

启动显示

# 在专用终端运行显示程序
python3 scripts/display.py

更新状态

# 代理执行任务时调用
python3 scripts/status.py work "Building feature"
python3 scripts/status.py think "Analyzing data"
python3 scripts/status.py idle "Ready"
python3 scripts/status.py alert "Need attention"
python3 scripts/status.py sleep

调整自动空闲超时

python3 scripts/configure.py --timeout 300  # 单位秒，设为 0 关闭

输入与输出

见下方输入与输出表格。

风险提示

• 需保持 display.py 终端窗口常驻运行，关闭后无法查看状态
• status.py 需从代理代码或脚本中主动调用，不会自动捕获活动
• 同一机器多代理同时使用时需分配不同字母避免混淆
• 网络中断或进程崩溃会导致显示冻结，需配合看门狗监控

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/voidcooks/clawd-presence/SKILL.md
来源类型：GitHub 开源项目