{"skill":{"slug":"safe-config","displayName":"Safe Config Modifier","summary":"安全修改 OpenClaw 配置文件。用于任何需要修改 ~/.openclaw/openclaw.json 的场景，包括：模型切换、channel 配置、tools 配置、skill 安装等。确保修改前备份、预览（脱敏 key）、并获得用户确认。","description":"---\nname: safe-config\ndescription: 安全修改 OpenClaw 配置文件。用于任何需要修改 ~/.openclaw/openclaw.json 的场景，包括：模型切换、channel 配置、tools 配置、skill 安装等。确保修改前备份、预览（脱敏 key）、并获得用户确认。\n---\n\n# 🛡️ Safe Config Modifier\n\n安全修改 OpenClaw 配置文件的标准化流程，防止配置损坏导致服务故障。\n\n## ⚡ 快速开始\n\n```bash\n# 1. 预览当前配置（脱敏）\n~/.openclaw/skills/safe-config/scripts/preview.sh\n\n# 2. 验证配置合法性\n~/.openclaw/skills/safe-config/scripts/validate.sh\n\n# 3. 备份当前配置\ncp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.backup-$(date +%Y%m%d-%H%M%S)\n```\n\n## 📋 完整流程\n\n### 步骤 1: 读取当前配置\n\n```bash\n# 查看完整配置\ncat ~/.openclaw/openclaw.json | jq '.'\n\n# 查看特定字段\ncat ~/.openclaw/openclaw.json | jq '.agents.defaults.model'\ncat ~/.openclaw/openclaw.json | jq '.channels'\ncat ~/.openclaw/openclaw.json | jq '.plugins'\n```\n\n### 步骤 2: 脱敏预览\n\n使用内置脚本生成安全的预览：\n\n```bash\n# 完整预览（自动脱敏）\n~/.openclaw/skills/safe-config/scripts/preview.sh\n\n# 或手动脱敏\n~/.openclaw/skills/safe-config/scripts/sanitize.sh < ~/.openclaw/openclaw.json\n```\n\n**脱敏字段**: `apiKey`, `token`, `password`, `secret`, `botToken`\n\n### 步骤 2.5: 本地验证\n\n```bash\n# JSON 语法检查\njq '.' ~/.openclaw/openclaw.json\n\n# 使用验证脚本\n~/.openclaw/skills/safe-config/scripts/validate.sh\n\n# 测试 API 连通性（如适用）\ncurl -s https://api.siliconflow.cn/v1/models -H \"Authorization: Bearer test\" | jq .\n```\n\n### 步骤 3: 请求用户确认\n\n⚠️ **关键规则**:\n- 展示脱敏后的配置变更\n- 告知验证结果\n- **必须收到确认语才能执行**\n- 确认语只认: **`ojbk可以改了`**\n- ❌ 其他任何同意（\"好的/可以/OK/收到\"）都不执行！\n\n### 步骤 4: 执行修改\n\n```bash\n# 1. 备份（必需）\ncp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.backup-$(date +%Y%m%d-%H%M%S)\n\n# 2. 写入新配置（使用 jq 或直接写入）\njq '.新字段 = \"新值\"' ~/.openclaw/openclaw.json > /tmp/openclaw.json\nmv /tmp/openclaw.json ~/.openclaw/openclaw.json\n\n# 3. 重启 Gateway（如需要）\nopenclaw gateway restart\n```\n\n### 步骤 5: 验证\n\n```bash\n# 检查配置写入\njq '.新字段' ~/.openclaw/openclaw.json\n\n# 验证 JSON 合法\njq empty ~/.openclaw/openclaw.json && echo \"✅ JSON 合法\"\n\n# 检查 Gateway 状态\nopenclaw gateway status\n```\n\n## 📖 常用配置示例\n\n### 模型切换\n\n```json\n{\n  \"agents\": {\n    \"defaults\": {\n      \"model\": {\n        \"primary\": \"siliconflow/Pro/MiniMaxAI/MiniMax-M2.5\"\n      }\n    }\n  }\n}\n```\n\n### 添加新模型提供商\n\n```json\n{\n  \"models\": {\n    \"providers\": {\n      \"anthropic\": {\n        \"baseUrl\": \"https://api.anthropic.com/v1\",\n        \"apiKey\": \"sk-ant-***\",\n        \"models\": [\n          {\n            \"id\": \"claude-sonnet-4-20250514\",\n            \"name\": \"Claude Sonnet 4\",\n            \"contextWindow\": 200000,\n            \"maxTokens\": 8192\n          }\n        ]\n      }\n    }\n  }\n}\n```\n\n### Channel 配置\n\n```json\n{\n  \"channels\": {\n    \"telegram\": {\n      \"enabled\": true,\n      \"botToken\": \"123456:ABC-DEF***\",\n      \"dmPolicy\": \"pairing\",\n      \"groupPolicy\": \"allowlist\"\n    }\n  }\n}\n```\n\n### 启用 Telegram 贴纸\n\n```json\n{\n  \"channels\": {\n    \"telegram\": {\n      \"actions\": {\n        \"sticker\": true\n      }\n    }\n  }\n}\n```\n\n### Tools 配置\n\n```json\n{\n  \"tools\": {\n    \"web\": {\n      \"search\": {\n        \"enabled\": true,\n        \"provider\": \"kimi\",\n        \"kimi\": {\n          \"apiKey\": \"sk-***\"\n        }\n      }\n    }\n  }\n}\n```\n\n## 🚫 禁止事项\n\n| 规则 | 说明 |\n|------|------|\n| ❌ 禁止不备份 | 每次修改必须先备份 |\n| ❌ 禁止不脱敏 | 展示给用户前必须脱敏 |\n| ❌ 禁止不验证 | 修改前必须验证 JSON 格式 |\n| ❌ 禁止口语确认 | 只认\"ojbk可以改了\" |\n| ❌ 禁止忽略错误 | JSON 错误必须修复 |\n\n## ✅ 正确流程检查清单\n\n- [ ] 读取当前配置\n- [ ] 生成脱敏预览\n- [ ] 验证 JSON 格式\n- [ ] 展示给用户\n- [ ] 等待\"ojbk可以改了\"\n- [ ] 备份当前配置\n- [ ] 执行修改\n- [ ] 验证写入结果\n\n## 📂 文件结构\n\n```\nsafe-config/\n├── SKILL.md           # 本文档\n├── _meta.json         # 元数据（ClawHub）\n├── references/\n│   └── examples.md    # 配置示例\n└── scripts/\n    ├── sanitize.sh    # 脱敏脚本\n    ├── validate.sh    # 验证脚本\n    └── preview.sh     # 预览脚本\n```\n\n## 🔗 相关链接\n\n- [OpenClaw 文档](https://docs.openclaw.ai)\n- [ClawHub 市场](https://clawhub.com)\n","topics":["Json","备份","安全"],"tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":746,"installsAllTime":28,"installsCurrent":2,"stars":0,"versions":1},"createdAt":1772899867544,"updatedAt":1779077826483},"latestVersion":{"version":"1.0.0","createdAt":1772899867544,"changelog":"初始版本发布","license":null},"metadata":null,"owner":{"handle":"justaboyhai-wq","userId":"s17e15ngsnnxr4dexemcr4eazn83nm2q","displayName":"justaboyhai-wq","image":"https://avatars.githubusercontent.com/u/254623848?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1780089795135}}