核心用法
赛博朋克主题是 OpenClaw 的第三方 UI 主题包，通过 Python 脚本将自定义 CSS/JS 注入到 live Control UI 中，实现聊天页与梦境页的视觉改造。安装后自动挂载 <style> 和 <script> 标签，不冲突于官方自定义主题注入器。
主要功能：
- 聊天页改造：P5 风格视觉层、背景大图铺底、立绘头像替换（主助手/Tool/Help/用户四角色）
- 梦境页改造：背景大图直贴、圆形梦境头像自定义
- UI 层级修正：修复 composer 上方状态条（context usage/compaction/run status）的显示层级
- 用量显示优化：Codex 用量按钮同时展示 5 小时与周额度，避免单一窗口误读
- 消息排序稳定：强制同时间戳消息按 user → assistant tool → toolResult → assistant 文本顺序排列
使用方式：
# 默认安装 python3 scripts/install_cyberpunk_theme.py --workspace <target> # 带素材覆盖 python3 scripts/install_cyberpunk_theme.py --workspace <target> --assistant-avatar /path/to/main.png ... # JSON 配置安装 python3 scripts/install_cyberpunk_theme.py --from-config /path/to/config.json # 重新挂载（OpenClaw 更新后） python3 scripts/apply_cyberpunk_theme.py
显著优点
1. 零侵入式注入：通过独立 ID（openclaw-workspace-theme）避免与官方主题系统冲突，可随时卸载
2. 热更新能力：安装后立即生效，无需重启 OpenClaw；更新后运行 apply 脚本即可恢复
3. 高度可定制：7 个视觉槽位全部开放替换，支持命令行参数或 JSON 配置批量指定
4. 持续迭代维护：版本号已达 1.0.16，累计修复 10+ 项 UI 缺陷，包括材质糊化、层级遮挡、消息排序等实际问题
5. 素材规格明确：提供详细的尺寸建议（2:3 立绘、3:2 聊天背景、16:9 梦境背景），避免用户上传后裁切失真
潜在缺点与局限性
1. 版本锁定风险：明确适配 OpenClaw 2026.5 系列，未来官方 UI 大改可能导致主题失效或样式错乱
2. 安装依赖脚本执行：需要本地 Python 环境及文件系统写入权限，无法纯配置化安装
3. 素材管理负担：自定义素材需用户自行准备并管理路径，无内置素材库或 CDN 托管
4. ClawHub 分发缺陷：历史版本曾因 ClawHub 仅上传文本文件导致默认素材缺失，虽已修复（1.0.16 自动还原），但反映分发渠道存在结构性限制
5. 非官方支持：属于社区第三方主题，官方更新可能未考虑此类注入的兼容性
适合人群
- 对 OpenClaw 默认 UI 视觉疲劳、追求个性化沉浸体验的重度用户
- 具备基础 Python/命令行操作能力、能自主管理素材文件的技术用户
- 角色扮演或创意写作场景用户，希望通过视觉主题强化"赛博朋克"世界观氛围
- 愿意承担版本兼容性风险、能接受手动维护更新的早期采用者
常规风险
| 风险类型 | 具体描述 | 缓解建议 |
|---------|---------|---------|
| 功能失效 | OpenClaw 官方 UI 更新后主题样式错乱或脚本报错 | 关注版本兼容性声明，延迟更新或等待主题适配 |
| 安全执行 | 需运行外部 Python 脚本，存在代码注入风险 | 审查脚本来源（GitHub/ClawHub），在隔离环境测试 |
| 数据残留 | 卸载后可能遗留 `customizations/` 目录文件 | 手动清理工作区 `customizations/openclaw-control-ui/` |
| 性能影响 | CSS/JS 注入增加浏览器渲染负担 | 素材避免使用超大分辨率（建议按文档规格）|
| 配置丢失 | 工作区迁移时主题配置未同步 | 保留 `theme-config.json` 及素材文件备份 |