← 返回 Skills 市场
OpenClaw Config Safety v2
作者
austrian_guy
· GitHub ↗
· v1.0.0
· MIT-0
60
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install openclaw-config-safety
功能描述
Validate, normalize, export, and import openclaw.json configs safely with automatic backups and schema checks before applying changes or upgrades.
安全使用建议
This package appears to implement a sensible config validation and import/export workflow, but there are important things to check before installing or running it:
- Verify dependencies yourself: the code and scripts assume the openclaw CLI is available (or set via OPENCLAW_BIN), the `pass` tool is available for import credential resolution, and the shell validator uses `jq`. The registry metadata does not declare these — confirm they exist and are the versions you expect.
- Inspect resolve-refs.js (not shown in full here) to confirm how it invokes `pass` and whether it logs or transmits resolved secrets. The design claims it will not print secret values, but review to be sure.
- Back up your existing ~/.openclaw/openclaw.json before using the wizard or the validator (the docs already advise this). Even though the tool creates backups, manual backups are prudent.
- Treat exported tokens as containing credential reference names only (mrconf:v1 tokens do not include actual keys). Ensure destination machines have matching env vars or pass entries.
- If you do not fully trust the source owner (unknown homepage, owner id only), consider running the scripts in a restricted environment (container or VM) and audit the code paths that call external binaries before giving it access to your real OpenClaw installation and secrets.
If you want, I can (a) list exact files/lines that invoke external binaries (openclaw, pass, jq, child_process.exec), (b) extract the resolve-refs implementation for a focused review, or (c) suggest a minimal checklist to run the tool safely in a sandbox first.
功能分析
Type: OpenClaw Skill
Name: openclaw-config-safety
Version: 1.0.0
The bundle provides a comprehensive utility for safely managing, validating, and normalizing OpenClaw configurations (openclaw.json). It features a 'config token' system for sharing configurations using environment variable placeholders (${REF}) rather than actual secrets, which are resolved locally via process.env or the 'pass' utility. While the code uses high-risk functions like execSync (in src/resolve-refs.js and src/doctor-check.js), it employs strict regex validation (REF_REGEX) to prevent command injection and includes explicit logic to avoid logging or exporting sensitive credential values. The behavior is entirely consistent with the stated purpose of preventing gateway crashes due to schema drift.
能力标签
能力评估
Purpose & Capability
The skill's name/description (validate, normalize, export/import openclaw.json) matches the included code (normalize.js, export.js, import.js, audit.js, doctor-check.js, restore/backup helpers). However the registry metadata declares 'Required binaries: none' and 'Required env vars: none' while the code and SKILL.md clearly depend on system binaries (openclaw CLI, pass, jq for the shell validator) and Node for running the JS. This is a mismatch (under-declared dependencies) rather than a functional mismatch with stated purpose.
Instruction Scope
SKILL.md and scripts instruct the agent to read/write ~/.openclaw/openclaw.json, create backups, run validation, run `openclaw doctor --fix`, and restart the gateway. Those actions are appropriate for a config-safety tool, but the instructions also resolve credential references by reading process.env and invoking `pass` (import path). The skill's runtime will therefore access environment variables and call system binaries (openclaw, pass, jq) — the SKILL.md does not declare these env/binary accesses explicitly. This grants the skill scope to read sensitive local state (env vars, pass entries) which is necessary for import but should be called out as a security-sensitive operation.
Install Mechanism
There is no install spec (instruction-only), which minimizes remote code downloads. However the skill bundle actually contains many code files and CLI wrappers (bin/openclaw-config-onboard etc.) that will be executed from the user's workspace. No network-based installers or remote archives are used. The lack of an install step is reasonable but the package should declare that it needs Node and relies on local CLI tools.
Credentials
The skill will resolve credential references by checking process.env and invoking `pass` (see EXPORT-TOKEN-SPEC.md and resolve-refs behavior described). That is proportionate to the import feature, but the registry metadata lists no required env vars or binaries. The tool may read any environment variables whose names appear in a token's credentialRefs list (e.g., CEREBRAS_API_KEY). Users must understand that importing will read those env vars or call pass to retrieve secrets; those accesses are not declared in the skill metadata.
Persistence & Privilege
The skill does not request always:true and does not modify other skills or system-wide agent settings. It does invoke system-level operations such as restarting the OpenClaw gateway and running `openclaw doctor`, which are expected for a config-management tool. Autonomous invocation is allowed by default but not exceptional here.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install openclaw-config-safety - 安装完成后,直接呼叫该 Skill 的名称或使用
/openclaw-config-safety触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
Initial v2 release: normalize, export/import tokens, interactive wizard. 117 tests.
元数据
常见问题
OpenClaw Config Safety v2 是什么?
Validate, normalize, export, and import openclaw.json configs safely with automatic backups and schema checks before applying changes or upgrades. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 60 次。
如何安装 OpenClaw Config Safety v2?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install openclaw-config-safety」即可一键安装,无需额外配置。
OpenClaw Config Safety v2 是免费的吗?
是的,OpenClaw Config Safety v2 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
OpenClaw Config Safety v2 支持哪些平台?
OpenClaw Config Safety v2 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 OpenClaw Config Safety v2?
由 austrian_guy(@ether-btc)开发并维护,当前版本 v1.0.0。
推荐 Skills