PondDepth Levels (🦞)
A game-like leveling overlay for OpenClaw Control UI.
Quick demo
What you get
- - Top-left PondDepth badge with hover popover
- XP → Level + progress (reads
companion-metrics.json) - Daily one-line OpenClaw tip (reads
openclaw-tip.json) - Level list / XP ranges (hover
?) + current XP highlight - i18n (zh/en) + compact skills list layout
- Level icons (B/F/S × 1..5)
- Skills install CTA (B2) that checks ClawHub auth status and guides users to run INLINECODE3
Requirements
- - INLINECODE4
- OpenClaw installed via Homebrew (default paths below)
Install
1) Install the skill
CODEBLOCK0
2) Apply it to Control UI (copies assets into OpenClaw install)
CODEBLOCK1
3) Refresh
Open Control UI and hard refresh.
What this modifies (important)
This skill copies files into your local OpenClaw installation:
- - UI assets directory (default):
-
/opt/homebrew/lib/node_modules/openclaw/dist/control-ui/assets
-
ponddepth-badge.js
- INLINECODE7
A timestamped backup is saved to:
Scheduled jobs (created on install)
The install script best-effort creates/updates two OpenClaw cron jobs:
1) PondDepth ClawHub status (10m)
- Writes clawhub-status.json for the “Install skills” CTA UX
2) PondDepth companion metrics (hourly)
- Generates companion-metrics.json (XP/level)
Configuration (optional)
You can override paths used by the install script:
- -
OPENCLAW_WORKSPACE (default: ~/.openclaw/workspace) - INLINECODE13 (default: Homebrew OpenClaw Control UI assets dir)
Example:
CODEBLOCK2
Uninstall
CODEBLOCK3
This removes the injected UI assets and (best-effort) restores the most recent backup from:
Troubleshooting
- - Nothing shows up: run the install script again, then hard refresh Control UI.
- Permissions error copying into
/opt/homebrew/...: run with a user that has write permission to that Homebrew prefix (or set OPENCLAW_UI_ASSETS_DIR). - Icons missing: ensure
ponddepth-icons/ exists under the Control UI assets dir.
Notes for maintainers
- - To keep publish size small, this package ships resized PNGs in
assets/icons_bin/ and ignores assets/icons_b64/ during publish via .clawhubignore.
技能名称: ponddepth-levels
详细描述:
PondDepth 等级系统 (🦞)
一个为 OpenClaw 控制界面 设计的游戏化等级覆盖层。
快速演示
功能特性
- - 左上角 PondDepth 徽章，悬停时显示弹出信息
- 经验值 → 等级 + 进度（读取 companion-metrics.json）
- 每日一条 OpenClaw 小贴士（读取 openclaw-tip.json）
- 等级列表 / 经验值范围（悬停 ?）+ 当前经验值高亮
- 国际化支持（中文/英文） + 紧凑的技能列表布局
- 等级图标（B/F/S × 1..5）
- 技能安装引导（B2），检查 ClawHub 认证状态并指导用户运行 clawhub login
系统要求
- - python3
- 通过 Homebrew 安装的 OpenClaw（默认路径如下）
安装步骤
1) 安装技能
bash
clawhub install ponddepth-levels
2) 应用到控制界面（将资源文件复制到 OpenClaw 安装目录）
bash
bash ~/.openclaw/workspace/skills/ponddepth-levels/scripts/install.sh
3) 刷新
打开控制界面并执行硬刷新。
修改内容（重要说明）
此技能会将文件复制到本地 OpenClaw 安装目录：
- /opt/homebrew/lib/node_modules/openclaw/dist/control-ui/assets
- ponddepth-badge.js
- ponddepth-icons/*.png
带时间戳的备份将保存到：
- - ~/.openclaw/workspace/_deleted/ponddepth-install-backups/<时间戳>/
定时任务（安装时创建）
安装脚本会尽力创建/更新两个 OpenClaw 定时任务：
1) PondDepth ClawHub 状态（每10分钟）
- 写入 clawhub-status.json，用于“安装技能”引导用户体验
2) PondDepth 伴侣指标（每小时）
- 生成 companion-metrics.json（经验值/等级）
配置选项（可选）
您可以覆盖安装脚本使用的路径：
- - OPENCLAWWORKSPACE（默认：~/.openclaw/workspace）
- OPENCLAWUIASSETSDIR（默认：Homebrew OpenClaw 控制界面资源目录）
示例：
bash
export OPENCLAWUIASSETS_DIR=/path/to/openclaw/dist/control-ui/assets
bash ~/.openclaw/workspace/skills/ponddepth-levels/scripts/install.sh
卸载方法
bash
bash ~/.openclaw/workspace/skills/ponddepth-levels/scripts/uninstall.sh
此操作会移除注入的 UI 资源，并（尽力）从以下位置恢复最近的备份：
- - ~/.openclaw/workspace/_deleted/ponddepth-install-backups/
故障排除
- - 无显示内容： 重新运行安装脚本，然后对控制界面执行硬刷新。
- 复制到 /opt/homebrew/... 时出现权限错误： 使用对该 Homebrew 前缀具有写入权限的用户运行（或设置 OPENCLAWUIASSETS_DIR）。
- 图标缺失： 确保控制界面资源目录下存在 ponddepth-icons/ 文件夹。
维护者说明
- - 为保持发布包体积小巧，本包在 assets/iconsbin/ 中提供调整尺寸后的 PNG 文件，并通过 .clawhubignore 在发布时忽略 assets/iconsb64/ 目录。
