用途：OpenClaw Desk Pet 是原生 macOS 桌面伴侣，通过动画猫咪可视化 OpenClaw 智能体活动。它监听 OpenClaw Gateway 事件，把智能体状态（思考、工具执行、空闲、睡眠等）映射为动画，用户无需切换控制台即可查看实时状态，并通过快捷按钮或文本输入触发任务。
主要能力：状态包括 idle、thinking、taskStarting、tooling、completed、sleeping（浅睡到深睡）；处理 chat、agent、tool_call 等 Gateway 事件；显示工具标签与结果气泡；配置控制台可设置 OpenClaw 根目录、Gateway URL 与 token、启动脚本、活跃窗口，以及创建和排序快捷按钮。Gateway 不可用时读取本地 sessions.json 与 log.jsonl 进行文件回退。
安装与使用：先克隆仓库并配置环境文件，再运行启动脚本。
git clone https://github.com/LeoZhaorx/openclaw-desk-pet.git cd openclaw-desk-pet cp desk-sprite/.desk-sprite.env.example desk-sprite/.desk-sprite.env chmod 600 desk-sprite/.desk-sprite.env ./start-desk-pet.command
停止用 ./stop-desk-pet.command，重启用 ./restart-desk-pet.command；也可在 desk-sprite/ 目录使用 ./launch.sh、./halt.sh、./health.sh。配置控制台位于 http://127.0.0.1:17890/，仅监听 localhost。
要求：macOS 13+、Swift 5.9+（Xcode Command Line Tools）、Python 3.9+，并已安装配置 OpenClaw。
限制：资料未说明收费、价格、平台支持范围或效果保证；动画依赖 media/ 下的指定 .mov 资源，缺失会导致动画无法播放。排障可检查 Gateway 状态、日志与配置权限。