配置防护：防止配置错误

通过 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 

# 复制到其他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

bashgrep "操作约束\|修改 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 参考文档
• OpenClaw-Skill 参考文档
• ClawHub Skill 市场

返回目录

最后更新：2026-03-18