OpenClaw配置安全防护

# 配置防护：防止配置错误

> 通过 OpenClaw-Skill 参考文档防止配置错误

## 问题背景

OpenClaw 的强大功能需要额外配置 Tools/Skills 才能完整体验，很多都需要修改配置文件 `openclaw.json`。配错一个字段，Gateway 可能起不来。OpenClaw 有 exec 权限可以修改配置，更需要防护。

---

## 解决方案

### 1. 安装 OpenClaw-Skill 参考文档

OpenClaw-Skill 参考文档是一个专门为 **其他AI助手**（如Claude+Antigravity）设计的 Skill，包含 OpenClaw 所有配置项的说明和示例。安装到其他AI助手后，这些助手在帮助您管理OpenClaw时会自动参考正确的配置格式。

> **注意**：这个Skill是给其他AI助手用的，不是给OpenClaw AI本身安装的。OpenClaw AI助手已经具备所有原生功能。

#### 1.1 从 GitHub 安装到其他AI助手

```bash
# 克隆仓库
git clone https://github.com/win4r/OpenClaw-Skill.git

# 复制到其他AI助手的skills目录（以Antigravity为例）
cp -r OpenClaw-Skill ~/.gemini/antigravity/skills/openclaw
```

#### 1.2 验证安装

```bash
# 检查 skill 是否成功复制到其他AI助手目录
ls ~/.gemini/antigravity/skills/openclaw/

# 应该看到：
# SKILL.md  references/
```

#### 1.3 重启其他AI助手使Skill生效

重启您安装此Skill的AI助手（如Antigravity），Skill会自动加载。

> **注意**：此Skill安装在其他AI助手，不需要重启OpenClaw Gateway。

---

### 2. 验证 Skill 已加载

安装后，AI 应该能够查询配置项的正确格式：

```
用户: 查询 channels.feishu 的配置格式
AI: [读取 openclaw-skill 参考文档]
    根据文档，channels.feishu 的配置格式如下：
    {
      "enabled": true,
      "dmPolicy": "pairing",
      "accounts": {
        "main": {
          "appId": "cli_xxx",
          "appSecret": "xxx"
        }
      }
    }
```

---

### 3. 在 MEMORY.md 中写入约束规则

```markdown
# MEMORY.md 中的约束

- **修改 gateway 配置前必须先查 OpenClaw 手册**，确认配置项正确再改
- **重启 gateway 前必须先告知**，不要静默重启
```

这样 AI 在修改配置时会：
1. 先查询 openclaw-skill 参考文档
2. 确认配置项格式正确
3. 告知用户后再执行修改
---

### 4. 设置定时任务检查 Skill 更新

OpenClaw 配置项可能随版本更新变化，建议定期检查参考文档更新。

#### 4.1 配置定时任务

在 Gateway 配置文件 `~/.openclaw/openclaw.json` 中添加 cron 任务：

```json5
{
  cron: {
    jobs: [
      {
        "name": "check-skill-updates",
        "schedule": { "kind": "cron", "expr": "0 9 * * *" },
        "payload": { 
          "kind": "agentTurn", 
          "message": "检查已安装的 Skill 是否有更新，如有更新则提醒用户" 
        },
        "sessionTarget": "isolated",
        "enabled": true
      }
    ]
  }
}
```

#### 4.2 使用 cron 工具添加（推荐）

通过对话让 AI 添加定时任务：

```
用户: 帮我添加一个每天早上 9 点检查 Skill 更新的定时任务
AI: [使用 cron 工具添加任务]
```

或直接执行：

```bash
# 添加定时任务
openclaw cron add check-skill-updates \
  --schedule "0 9 * * *" \
  --message "检查已安装的 Skill 是否有更新"
```

#### 4.3 查看和管理定时任务

```bash
# 列出所有定时任务
openclaw cron list

# 手动触发检查
openclaw cron run check-skill-updates

# 查看任务执行历史
openclaw cron runs check-skill-updates
```

#### 4.4 任务执行效果

每天早上 9 点，AI 会自动：
1. 检查 ClawHub 上已安装 Skill 的版本
2. 对比本地版本，如有更新则提醒用户
3. 用户确认后执行更新

---

## 工作原理

```
用户请求修改配置
      ↓
AI 读取 MEMORY.md 约束
      ↓
AI 查询 openclaw-skill 参考文档
      ↓
确认配置项格式正确
      ↓
告知用户后执行修改
      ↓
重启 Gateway（先告知）
```

---

## 效果对比

| 场景 | 未安装参考文档 | 已安装参考文档 |
|------|---------------|---------------|
| 修改配置 | 可能配错字段 | 参考文档，格式正确 |
| 增加功能 | 猜测配置方式 | 查文档，准确配置 |
| 故障排查 | 盲目尝试 | 参考文档定位问题 |

---

## 验证：测试配置安全机制

安装 OpenClaw-Skill 参考文档后，需要验证机制是否生效。

### 场景 1：安装 Skill 时触发检查

```
用户: 帮我安装一个 Telegram channel 的 skill

AI: [读取 MEMORY.md 约束]
    ⚠️ 这需要修改 gateway 配置，我先查阅 OpenClaw 手册确认配置项...
    [查询 openclaw-skill 参考文档]
    根据文档，Telegram channel 配置格式如下：
    {
      "channels": {
        "telegram": {
          "enabled": true,
          "botToken": "xxx"
        }
      }
    }
    确认配置格式正确，是否继续安装？
```

### 场景 2：修改配置时触发检查

```
用户: 把 gateway 端口改成 8080

AI: [读取 MEMORY.md 约束]
    ⚠️ 这需要修改 gateway 配置，我先查阅 OpenClaw 手册...
    [查询 openclaw-skill 参考文档]
    根据文档，端口配置项是 gateway.port，默认 18789。
    ⚠️ 即将修改 gateway 端口为 8080，确认吗？
```

### 场景 3：重启 Gateway 时触发提醒

```
用户: 重启 gateway

AI: [读取 MEMORY.md 约束]
    ⚠️ 即将重启 Gateway，这会短暂中断服务（约 5-10 秒），确认吗？
```

### 验证步骤

**步骤 1：确认约束已写入 MEMORY.md**

```bash
grep "操作约束\|修改 gateway" ~/.openclaw/workspace/MEMORY.md
```

**步骤 2：确认 openclaw-skill 已安装到其他AI助手**

```bash
# 检查其他AI助手目录（以Antigravity为例）
ls ~/.gemini/antigravity/skills/openclaw/ 2>/dev/null || echo "未安装到其他AI助手"

# 应该看到：
# SKILL.md  references/
```

**步骤 3：在其他AI助手中触发测试**

在安装了OpenClaw-Skill的其他AI助手（如Claude+Antigravity）中请求OpenClaw配置帮助，观察是否：
1. 能够正确引用openclaw-skill参考文档
2. 提供准确的OpenClaw配置格式
3. 给出正确的操作建议

**步骤 4：验证Skill功能**

测试其他AI助手是否具备OpenClaw知识：

```
用户（对其他AI助手）: 如何配置Telegram频道？
其他AI助手: [应该能够引用openclaw-skill提供详细配置指南]
```

> **注意**：此验证是在其他AI助手中进行，不是OpenClaw AI助手本身。

---

## 相关链接

- [案例 03：安装 OpenClaw-Skill 参考文档](../cases/case-03-install-openclaw-skill.md)
- [OpenClaw-Skill 参考文档](https://github.com/win4r/OpenClaw-Skill)
- [ClawHub Skill 市场](https://clawhub.ai)

---

[返回目录](../openclaw-enterprise-hands-on-guide.md)

*最后更新：2026-03-18*