← 返回 Skills 市场
altaircardinal

Config Tracker

作者 AltairCardinal · GitHub ↗ · v1.0.2 · MIT-0
cross-platform ⚠ suspicious
301
总下载
0
收藏
0
当前安装
3
版本数
在 OpenClaw 中安装
/install config-tracker
功能描述
自动追踪并自动提交 OpenClaw 配置和关键工作区 markdown 文件的变更,无需手动操作。
使用说明 (SKILL.md)

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 \x3Cfile> + git commit -m "auto: track config changes [timestamp]"
  4. 提交信息包含时间戳,便于追溯

注意事项

  • 首次运行时会自动初始化 git 仓库
  • 频繁修改配置文件(如 Doctor 自动修改)会产生大量提交,这是预期行为
  • 使用 git log 可以查看完整的历史变更
  • 提交冷却是 5 秒,防止短时间内多次提交
安全使用建议
This skill does roughly what it says — auto-detecting and committing changes to OpenClaw config and specified workspace markdown files — but take precautions before installing: - Inspect the full source (you've got it) to confirm there is no 'git push' or remote upload behavior in the truncated portion; if you want, provide the remaining code to re-check. The visible code does not perform network exfiltration. - Ensure git is installed and that you are comfortable with the plugin creating .git repositories in your workspace and ~/.openclaw (it will initialize repos and create commits). - Review which files will be tracked. If any tracked files may contain secrets (API keys, tokens, passwords), either remove them from the tracked list or add them to a local .gitignore before enabling the skill. - Check for existing git remotes in those directories. If a remote is configured, commits could be pushed later (by other tools or manual action); consider removing remotes or ensuring they point to a private destination. - If you want more assurance, run the plugin in an isolated environment or disable it (set enabled=false) until you're confident. Also ask the maintainer to declare 'git' as a required binary in the metadata and to fix the metadata that called this 'instruction-only'. If you want, I can: (a) search the truncated portion for 'push'/'remote' or other network calls if you paste it; (b) suggest a safe .gitignore and configuration to avoid committing secrets; or (c) produce a minimal checklist to harden installation.
功能分析
Type: OpenClaw Skill Name: config-tracker Version: 1.0.2 The skill is a utility designed to provide automated version control for OpenClaw configuration and workspace files. It uses local Git commands via `node:child_process` to track and commit changes to files such as `openclaw.json`, `MEMORY.md`, and `USER.md` whenever a dialogue turn begins. The code is transparent, lacks network exfiltration capabilities, and strictly performs local `git add` and `git commit` operations without any `git push` or remote execution logic.
能力评估
Purpose & Capability
The code and SKILL.md align with the stated purpose: it scans workspace markdown files and ~/.openclaw/openclaw.json and auto-commits changes. However the package metadata earlier claimed 'required binaries: none' / 'instruction-only', while the shipped code clearly runs git commands and is non-trivial JavaScript — git should be declared as a required binary and the 'instruction-only' tag is inaccurate.
Instruction Scope
Runtime instructions and implementation focus on git operations (git status, add, commit) and on two locations: workspaceDir and ~/.openclaw/openclaw.json, which is consistent with the SKILL.md. The plugin auto-initializes git repositories and commits without user action (including creating .git in your home or workspace). This stays within the stated scope but grants the skill broad read/write access to those paths and can create many commits.
Install Mechanism
There is no install spec and the SKILL.md asks you to copy the directory into your skills folder — consistent with a local plugin. No remote downloads or package installs are performed. That said, the presence of code files means this is not purely 'instruction-only' as the registry summary implied.
Credentials
The skill declares no required env vars (which is reasonable), but it relies on the git binary without declaring it. More importantly, it will read and commit files from ~/.openclaw and workspace markdowns which may contain sensitive tokens or configuration. The code does not push to remote by itself (no git push observed in provided code), but if a remote exists in those repos, committing can make secrets easier to expose if the repo later gets pushed. The skill also copies process.env into git child processes (normal) but does not explicitly read other env vars.
Persistence & Privilege
The skill is not always:true and is not requesting system-wide privileges. It will, however, create and manage local git repositories (.git directories) in your workspace and possibly in ~/.openclaw, and will run automatically on the before_prompt_build hook (every conversation round). That autonomous behavior combined with automatic commits increases privacy/operational impact if you don't want automatic changes recorded.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install config-tracker
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /config-tracker 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.2
Fix: auto-initialize git repo for workspace directory
v1.0.1
Fix: natural language change descriptions and path display
v1.0.0
Initial release of config-tracker skill. - Automatically tracks and commits changes to OpenClaw config and key markdown files. - Supports dual-repository management for both `~/.openclaw/` and workspace directories. - All commits are handled automatically at the start of each chat round; no manual git commands needed. - Customizable tracked file list, commit messages, and git user info. - Uses a 5-second commit cooldown to prevent excessive commits from rapid changes. - Automatically initializes git repositories on first run.
元数据
Slug config-tracker
版本 1.0.2
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 3
常见问题

Config Tracker 是什么?

自动追踪并自动提交 OpenClaw 配置和关键工作区 markdown 文件的变更,无需手动操作。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 301 次。

如何安装 Config Tracker?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install config-tracker」即可一键安装,无需额外配置。

Config Tracker 是免费的吗?

是的,Config Tracker 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Config Tracker 支持哪些平台?

Config Tracker 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Config Tracker?

由 AltairCardinal(@altaircardinal)开发并维护,当前版本 v1.0.2。

💬 留言讨论