Safe Config Modifier

安全修改 OpenClaw 配置文件。用于任何需要修改 ~/.openclaw/openclaw.json 的场景,包括:模型切换、channel 配置、tools 配置、skill 安装等。确保修改前备份、预览(脱敏 key)、并获得用户确认。

安装

概览

什么是Safe Config Modifier

Safe Config Modifier 是一个专为 OpenClaw 配置文件设计的标准化安全修改工具,旨在防止因配置错误导致的服务中断。该工具通过定义清晰的流程,确保用户在修改关键配置前完成备份、脱敏预览和合法性验证等必要步骤。它适用于所有涉及 ~/.openclaw/openclaw.json 文件的场景,如模型切换、渠道(channel)设置调整、插件(tools)配置更新以及技能(skill)安装等操作。其核心理念是‘安全第一’,强调在变更前必须获得用户明确确认,避免误操作带来的风险。

该工具提供了一套完整的脚本集合,包括预览当前配置、生成脱敏版本、验证 JSON 语法合法性以及执行修改等关键环节。特别地,它在展示给用户前会自动隐藏敏感信息,如 apiKey、token、password 等字段,以保护隐私。此外,它还强制要求用户输入特定确认语“ojbk可以改了”才能触发实际修改,杜绝了口头同意或模糊回应可能引发的意外变更。整个过程透明可控,每一步都有迹可循,极大提升了配置管理的可靠性和可审计性。

Safe Config Modifier 不仅简化了复杂配置的修改流程,还通过内置的检查清单和禁止事项列表,帮助开发者规避常见陷阱。无论是初次使用者还是经验丰富的运维人员,都可以借助这套标准化流程,在保障系统稳定性的前提下高效完成各类配置任务。

核心功能特点

  1. 提供标准化的安全配置修改流程,防止配置损坏
  2. 支持自动脱敏敏感字段(如 apiKey、token),保护隐私
  3. 内置 JSON 格式验证与 API 连通性测试功能
  4. 强制要求用户输入特定确认语“ojbk可以改了”才执行修改
  5. 自动生成带时间戳的配置文件备份,确保可回滚
  6. 集成预览、验证、修改、重启 Gateway 的全链路脚本

适用场景

Safe Config Modifier 主要应用于需要频繁或谨慎修改 OpenClaw 核心配置的场景。例如,当用户希望切换默认 AI 模型时,可通过该工具先查看当前模型设置并生成脱敏后的预览,确认无误后再进行替换;又如,在接入新的第三方服务(如 Anthropic Claude)作为模型提供商时,需添加对应的 baseUrl、apiKey 和模型列表,此时工具会验证新配置是否符合规范,避免因格式错误导致服务无法启动。

另一个典型使用场景是对通信渠道(如 Telegram 或微信)进行配置更新,比如启用贴纸功能、调整私信或群组消息策略等。由于这些配置通常包含 botToken 等敏感凭证,Safe Config Modifier 会在展示变更内容时自动屏蔽真实 token,仅显示 sk-*** 形式的占位符,从而降低泄露风险。同时,在完成写入后,工具还会检查 Gateway 是否正常运行,确保变更生效且不影响现有会话。

此外,该工具也适用于插件(tools)层面的扩展,例如开启网页搜索功能并绑定 Kimi 搜索引擎的 API 密钥。无论是一次性部署还是长期维护,Safe Config Modifier 都通过其严谨的流程设计,帮助用户建立起“备份—预览—验证—确认—执行”的安全工作流,显著提升 OpenClaw 生态系统的配置管理成熟度。