OpenClaw 稳定化工作流
目标
把“临时救火”变成“长期稳定”:
- 不再把密钥散落在仓库和脚本里
- 不再每次会话都重复问凭据
- 关键记忆文件每天自动快照
- 失败自动写入当天记忆,避免静默失败
- 整套流程可复用、可发布、可跨会话一键执行
标准产物
完成后应具备以下资产:
~/.config/openclaw/secrets.env:凭据单一来源~/.local/bin/openclaw-secrets-check:凭据完整性检查~/.local/bin/openclaw-boot-check:开机自检~/.local/bin/openclaw-daily-snapshot:每日快照crontab两条任务(@reboot+ 每日定时)~/.openclaw/logs/*.log:可追溯日志~/.openclaw/snapshots/YYYY-MM-DD/*:每日快照文件
执行流程(一步到位)
Phase 1:仓库体检与风险盘点
检查点:
- Git 状态是否过脏、是否存在异常子模块
- 是否存在 URL 内嵌凭据(
https://user:token@...) - 是否存在硬编码 token / appsecret / api key
- 哪些子项目可成功构建(基础可用性)
输出:
- 风险清单(高/中/低)
- 可立即修复项(自动化)
- 必须人工轮换项(密钥)
Phase 2:凭据脱敏与代码修复
动作:
- 清理远程 URL 中的凭据
- 清理仓库中的明文密钥(文档、脚本、代码、记忆文件)
- 将业务代码改为读取环境变量
- 前端:import.meta.env.*
- Node:process.env.*
Phase 3:凭据集中化(免打扰)
规范:
- 凭据仅存放在
~/.config/openclaw/secrets.env ~/.bashrc只做source,不直接存放明文- 权限最小化(
secrets.env->600)
Phase 4:自检与快照自动化
动作:
- 增加开机自检脚本
- 增加每日快照脚本
- 配置 crontab
推荐定时:
@reboot执行开机自检- 每天固定时段(如
09:15)执行快照
Phase 5:失败主动提醒
要求:
- 任一自动任务失败时,必须将告警写入当天
memory/YYYY-MM-DD.md - 告警至少包含:失败任务、时间戳、退出码、日志路径
- 不允许仅写日志而不提醒
Phase 6:复盘沉淀
每次执行后输出:
- 触发原因(为什么做)
- 执行链路(做了什么)
- 关键改动(改了哪些文件和脚本)
- 风险变化(修复了什么,剩什么)
- 下次可复用入口(命令/脚本/Skill)
Phase 7:同步到 CNBLL
目标:将本 Skill 推送到 cnbll 可复用仓库,团队可直接安装/复制。
提示词台账(可直接复用)
Prompt 01:体检盘点
给 openclaw 做一次全链路体检,按以下顺序输出:
1) 仓库状态(git、远程、子模块、改动规模)
2) 明文凭据风险(URL 带密码、硬编码 token)
3) 可运行性检查(至少 1 个子项目构建/测试)
4) 风险分级(高/中/低)
5) 可自动修复项与需人工项
Prompt 02:安全治理
先清理所有明文凭据和 URL 内嵌密码,代码改为环境变量读取。
要求:
- 不破坏现有功能
- 脱敏后给出“仍残留的敏感点”清单
- 明确哪些密钥必须轮换
Prompt 03:免打扰凭据方案
把凭据管理改为一次配置长期可用:
1) 建 secrets.env 作为单一来源
2) bashrc 自动加载
3) 提供一键自检脚本
4) 收紧文件权限
5) 验证通过后给用户最少操作指南
Prompt 04:防失忆机制
加“开机自检 + 每日快照”自动化机制:
- 有日志
- 有定时任务
- 有执行验证
- 不影响现有工作流
Prompt 05:失败主动提醒
升级自动脚本:任务失败时必须把告警追加到当天 memory/YYYY-MM-DD.md。
告警包含:时间、任务名、exit code、日志路径。
并验证正常路径和失败路径都可工作。
Prompt 06:复盘成 Skill
把本次完整执行链路复盘成可复用 Skill:
- 分阶段步骤
- 每步提示词模板
- 检查清单
- 发布到 CNBLL 的方法
目标是下次一句话触发,一步到位。
质量检查清单
- [ ]
secrets.env存在且权限为600 - [ ]
~/.bashrc不含明文 token - [ ]
openclaw-secrets-check通过 - [ ] crontab 存在
@reboot与每日快照 - [ ] 生成了当天快照和
manifest.sha256 - [ ] 失败告警可写入
memory/YYYY-MM-DD.md - [ ] 仓库无 URL 内嵌凭据残留
快速命令
# 手动自检
bash ~/.local/bin/openclaw-secrets-check
# 手动跑开机自检
bash ~/.local/bin/openclaw-boot-check
# 手动跑每日快照
bash ~/.local/bin/openclaw-daily-snapshot
# 查看定时任务
crontab -l
发布到 CNBLL
使用本 Skill 自带发布脚本:
chmod +x /home/ubuntu/.openclaw/workspace/skills/openclaw-stability-workflow/scripts/publish-to-cnbll.sh
/home/ubuntu/.openclaw/workspace/skills/openclaw-stability-workflow/scripts/publish-to-cnbll.sh cnbll/openclaw-stability-workflow-skill master
脚本会自动:
- 检查目标仓库是否存在,不存在则创建
- 克隆目标仓库
- 覆盖更新 Skill 内容
- 自动提交并推送到
master