config-safe

# Config Safe

安全地修改 OpenClaw 配置，避免写入无效配置导致 Gateway 无法启动。

## 核心理念

**配置修改是高风险操作。**
- OpenClaw 有严格的配置验证，**任何错误都会导致 Gateway 拒绝启动**
- 一旦配置损坏，Gateway 崩溃，**无法与你通信**，只能通过 CLI 修复

**核心原则：先预览，后验证，再确认，绝不直接修改。**

## 验证方法

在修改配置之前，可以使用以下方法验证配置是否有效：

### 方法 1: Schema 验证（静态检查）

获取配置的 JSON Schema，检查字段类型和必填项：

```bash
openclaw gateway call config.schema --params '{}'
```

**用途：**
- 检查字段名是否正确
- 检查值的类型是否正确
- 检查必填字段是否遗漏

**示例：**
```json
// Schema 返回结构
{
  "schema": {
    "type": "object",
    "properties": {
      "channels": { "type": "object" },
      "agents": { "type": "object" }
    },
    "required": ["agents"]
  }
}
```

### 方法 2: 模拟写入验证（动态检查）

使用 `config.patch` 尝试验证配置（**不会实际写入**，除非验证通过）：

```bash
openclaw gateway call config.patch --params '{
  "raw": "{\"channels\":{\"telegram\":{\"enabled\":true}}}",
  "baseHash": "<current-hash>"
}'
```

**行为：**
- 如果配置无效 → 返回错误，**不写入**，Gateway 继续运行
- 如果配置有效 → 写入并重启 Gateway

**注意：** 验证通过后会实际写入配置，所以要先向用户展示预览并获得确认。

## 工作流程

### Step 1: 读取官方最新文档

在修改任何配置之前，先阅读相关文档：

```bash
# 配置总览和验证规则
cat /opt/homebrew/lib/node_modules/openclaw/docs/gateway/configuration.md

# 配置示例（常见场景）
cat /opt/homebrew/lib/node_modules/openclaw/docs/gateway/configuration-examples.md
```

**必读内容：**
- 严格配置验证 (Strict config validation)
- 配置字段的类型和默认值
- 相关功能的具体配置示例

### Step 2: 获取当前配置（只读）

```bash
openclaw gateway call config.get --params '{}'
```

**只读取，不修改。** 保存返回的 JSON 和 hash。

### Step 3: Schema 验证（可选但推荐）

先用 schema 验证配置结构：

```bash
openclaw gateway call config.schema --params '{}'
```

检查你的变更是否符合 schema 要求。

### Step 4: 生成预览

向用户...