Skills config-tracker

Config Tracker Skill

install
source · Clone the upstream repo
git clone https://github.com/openclaw/skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/altaircardinal/config-tracker" ~/.claude/skills/clawdbot-skills-config-tracker && rm -rf "$T"
manifest: skills/altaircardinal/config-tracker/SKILL.md
source content

Config Tracker Skill

自动追踪并提交 OpenClaw 配置文件和关键 markdown 文件的变更。

功能

  • 自动版本控制:每次对话轮次开始时自动检查并提交文件变更
  • 双仓库管理:分别管理
    ~/.openclaw/
    和 workspace 目录
  • 零手动操作:无需手动执行 git 命令,所有提交自动完成
  • 可配置:可自定义追踪的文件列表和提交信息

追踪的文件

Workspace 目录

  • AGENTS.md
    — Agent 工作区配置
  • USER.md
    — 用户信息
  • SOUL.md
    — Agent 身份设定
  • MEMORY.md
    — 长期记忆
  • TOOLS.md
    — 工具配置
  • HEARTBEAT.md
    — 心跳任务配置
  • IDENTITY.md
    — Agent 身份

OpenClaw 配置

  • ~/.openclaw/openclaw.json
    — 主配置文件

触发时机

使用

before_prompt_build
hook,每次对话轮次开始时自动检查并提交变更。

配置项

配置项默认值说明
enabled
true
启用/禁用追踪器
workspaceFiles
["AGENTS.md", "USER.md", ...]
要追踪的 workspace 文件列表
openclawConfig
~/.openclaw/openclaw.json
OpenClaw 配置文件路径
commitMessagePrefix
"auto: track config changes"
提交信息前缀
gitUserName
"OpenClaw Bot"
Git 用户名
gitUserEmail
"openclaw@localhost"
Git 用户邮箱

安装

config-tracker
目录复制到你的 skills 目录:

cp -r config-tracker/ /Volumes/File/OpenClaw/workspace/skills/

然后重启 OpenClaw gateway 使其生效。

工作原理

  1. 每次对话轮次开始时(
    before_prompt_build
    hook),插件检查配置文件是否有变更
  2. 使用
    git status --porcelain
    检测未提交的变更
  3. 若有变更,自动执行
    git add <file>
    +
    git commit -m "auto: track config changes [timestamp]"
  4. 提交信息包含时间戳,便于追溯

注意事项

  • 首次运行时会自动初始化 git 仓库
  • 频繁修改配置文件(如 Doctor 自动修改)会产生大量提交,这是预期行为
  • 使用
    git log
    可以查看完整的历史变更
  • 提交冷却是 5 秒,防止短时间内多次提交