Openclaw Config Expert

OpenClaw 配置管理专家。精通所有正确配置、智能修复配置、提供最佳实践、版本感知。使用场景：配置验证与修复、Agent 智能配置、模型路由优化、插件管理、版本迁移助手、紧急恢复。触发词："配置"、"修改 agent"、"调优"、"路由"、"版本升级"、"验证配置"、"优化配置"、"回滚"、"恢复"、"重启 Gateway"。

samlinfj@samlinfj

Install

openclaw skills install @samlinfj/openclaw-config-expert

OpenClaw 配置专家 Skill

版本: 2.0.0
创建时间: 2026-04-18
更新: 融合优化版本 - 整合配置专家技能包完整功能
参考: https://docs.openclaw.ai/concepts/architecture

🎯 核心能力

能力	说明	触发词	执行者
配置验证与修复	验证 openclaw.json 正确性，自动修复无效字段	"验证配置"、"修复配置"	迪逗/Hermes
Agent 智能配置	添加/删除/修改 agent，优化子 agent 权限	"添加 agent"、"agent 配置"	迪逗/Hermes
模型路由优化	配置智能路由规则，优化任务分发	"路由"、"任务分发"	迪逗
插件管理	启用/禁用插件，配置插件参数	"插件"、"memory-wiki"	迪逗
版本迁移助手	版本更新时自动迁移配置	"版本升级"、"迁移"	迪逗
紧急恢复	OpenClaw 崩溃时回滚配置、重启 Gateway	"回滚"、"恢复"、"崩溃"	Hermes

🚨 Hermes 紧急恢复功能

使用场景

当 OpenClaw 出现以下情况时，Hermes 可以执行紧急恢复：

配置错误导致 Gateway 无法启动
Dashboard 无法访问
Agent 崩溃无法恢复
系统更新后配置不兼容
网络连接问题导致模型全部超时

Hermes 调用方式

python

# 在 Hermes 的 prompt 中调用
emergency_script = "~/.openclaw/skills/openclaw-config-expert/scripts/emergency_recovery.py"

# 完整恢复流程
subprocess.run(["python3", emergency_script, "recover"])

# 回滚到指定备份
subprocess.run(["python3", emergency_script, "rollback", "--backup", "openclaw.json.bak"])

# 重启 Gateway
subprocess.run(["python3", emergency_script, "restart"])

# 检查状态
subprocess.run(["python3", emergency_script, "status"])

恢复流程

text

OpenClaw 崩溃
    ↓
Hermes 检测 (Gateway 未响应)
    ↓
执行 emergency_recovery.py recover
    ↓
1. 检查 Gateway 状态
2. 查找最新备份
3. 回滚配置
4. 重启 Gateway
5. 验证 Dashboard 可访问
    ↓
恢复成功 → 返回 Dashboard URL
恢复失败 → 返回详细错误日志

示例对话

text

用户：OpenClaw 崩溃了，Gateway 启动不了

Hermes: 检测到 Gateway 未运行，正在执行紧急恢复...

[紧急恢复流程]
1. ✅ 检查 Gateway 状态 - 未运行
2. ✅ 找到备份 - openclaw.json.bak
3. ✅ 配置已回滚
4. ✅ Gateway 重启成功
5. ✅ Dashboard 可访问

✅ 恢复成功！
Dashboard: http://127.0.0.1:18789
日志：~/.openclaw/logs/emergency-recovery.log

🔧 细粒度配置管理

配置修改命令

bash

# 修改单个配置项
python3 config_validator.py modify \
  --key "agents.defaults.model.primary" \
  --value "qwen/qwen-turbo"

# 修改嵌套配置
python3 config_validator.py modify \
  --key "channels.feishu.groupPolicy" \
  --value "allowlist"

# 修改多个配置项
python3 config_validator.py modify \
  --updates '{
    "session.reset.idleMinutes": 60,
    "tools.fs.workspaceOnly": true
  }'

配置优化命令

bash

# 应用省钱配置
python3 agent_optimizer.py optimize --target cost-saving

# 应用性能配置
python3 agent_optimizer.py optimize --target performance

# 应用本地优先配置
python3 agent_optimizer.py optimize --target local-first

# 自定义优化
python3 agent_optimizer.py optimize \
  --model-primary "qwen/qwen-turbo" \
  --max-context 120000 \
  --compaction-threshold 0.6 \
  --idle-minutes 60

配置验证命令

bash

# 验证配置
python3 config_validator.py validate

# 验证并修复
python3 config_validator.py validate --fix

# 输出 JSON 报告
python3 config_validator.py validate --json

# 详细验证
python3 config_validator.py validate --verbose

插件管理命令

bash

# 列出所有插件
python3 plugin_manager.py --list

# 启用飞书插件
python3 plugin_manager.py --enable feishu

# 禁用插件
python3 plugin_manager.py --disable memory-wiki

# 生成插件报告
python3 plugin_manager.py --report

版本迁移命令

bash

# 分析迁移需求
python3 version_migrator.py --analyze

# 执行迁移到最新版本
python3 version_migrator.py --migrate --target 2026.4.15

# 检查版本兼容性
python3 version_migrator.py --check

📁 文件结构

text

~/.openclaw/skills/openclaw-config-expert/
├── SKILL.md                        # 本文件
├── config_validator.py             # 配置验证器 (488 行)
├── agent_optimizer.py              # Agent 优化器 (407 行)
├── model_router.py                 # 模型路由器 (110 行)
├── plugin_manager.py               # 插件管理器 (480 行)
├── version_migrator.py             # 版本迁移器 (562 行)
├── openclaw_config_expert.py       # 统一入口
├── scripts/
│   ├── agents.py                   # Agent 管理
│   ├── emergency_recovery.py       # 紧急恢复 (Hermes 专用)
│   ├── validate.py                 # 快速验证脚本
│   └── model_router.py             # 模型路由脚本
├── config_templates/
│   ├── minimal.json                # 最小有效配置
│   ├── standard.json               # 标准生产配置
│   ├── enterprise.json             # 企业级配置
│   ├── development.json            # 开发环境配置
│   ├── cost-saving.json            # 省钱配置
│   ├── performance.json            # 性能配置
│   └── local-first.json            # 本地优先配置
└── references/
    ├── architecture.md             # 官方架构摘要
    └── changelog.md                # 版本更新日志

🎯 意图识别路由

python

ROUTING_RULES = {
    # 紧急恢复 → Hermes
    r"崩溃 | 挂掉 | 启动不了 | 无法访问 | 回滚 | 恢复": "hermes",
    
    # 编程任务 → Hermes
    r"编程 | 代码|debug|脚本 | 开发": "hermes",
    
    # Compassion 任务 → Ollama 本地
    r"CRM|客户 | 订单 | 经销商": "crm-analyst",
    r"心理学 | 谈判 | 话术 | 沟通": "psychology-analyst",
    r"工控|PLC|HMI|伺服 | 技术": "industrial-analyst",
    r"标准 | 规范 | 认证 | 国标": "standards-analyst",
    r"商业 | 市场 | 竞争 | 策略": "weikong-business",
    
    # 配置管理 → 本 skill
    r"配置 | 设置 | 优化 | 调优 | 验证 | 修改": "openclaw-config-expert",
    
    # 版本相关 → 本 skill
    r"版本 | 升级 | 迁移 | 更新": "openclaw-config-expert",
    
    # 插件管理 → 本 skill
    r"插件 | plugin | 启用 | 禁用": "openclaw-config-expert",
    
    # 模型路由 → 本 skill
    r"模型 | model | 路由 | routing": "openclaw-config-expert",
}

📊 配置 Schema 核心字段

agents.defaults

字段	类型	默认值	说明
`model.primary`	string	qwen/qwen3.5-plus	主模型
`model.fallback`	string	deepseek/deepseek-chat	备用模型
`workspace`	string	~/OpenClaw 输出	工作目录
`subagents.allowAgents`	array	["hermes"]	允许的子 agent
`timeoutSeconds`	number	172800	超时时间 (48h)

session

字段	类型	默认值	说明
`store`	string	.openclaw-memory	会话存储目录
`dmScope`	string	per-channel-peer	DM 作用域
`reset.mode`	string	idle	重置模式
`reset.idleMinutes`	number	60	空闲超时
`scope`	string	per-sender	会话作用域

models.providers.qwen

字段	类型	说明
`baseUrl`	string	https://dashscope.aliyuncs.com/compatible-mode/v1
`apiKey`	string	sk-xxx (阿里 API Key)
`api`	string	openai-completions
`models[]`	array	模型列表

tools

字段	类型	默认值	说明
`profile`	string	coding	工具配置集
`elevated`	object	{}	提权工具配置
`fs.workspaceOnly`	boolean	true	文件系统限制
`agentToAgent.enabled`	boolean	true	Agent 间通信

channels.feishu

字段	类型	默认值	说明
`enabled`	boolean	true	启用飞书
`appId`	string	cli_xxx	飞书应用 ID
`appSecret`	string	xxx	飞书应用密钥
`dmPolicy`	string	allowlist	DM 策略
`groupPolicy`	string	allowlist	群聊策略

plugins.entries.memory-wiki

字段	类型	默认值	说明
`enabled`	boolean	true	启用插件
`config.vaultPath`	string	~/.openclaw-memory/wiki	Wiki 存储路径
`config.autoCreate`	boolean	true	自动创建页面

📝 使用示例

示例 1：Hermes 紧急恢复

text

用户：OpenClaw 崩溃了，Dashboard 打不开

Hermes: 检测到 Gateway 未运行，执行紧急恢复...

[执行 emergency_recovery.py recover]

✅ 恢复成功！
- 配置已回滚到：openclaw.json.bak
- Gateway 已重启
- Dashboard: http://127.0.0.1:18789

日志：~/.openclaw/logs/emergency-recovery.log

示例 2：细粒度修改配置

text

用户：把主模型改成 qwen-turbo，空闲超时改成 30 分钟

openclaw-config-expert:
正在修改配置...

✅ 配置已更新:
- agents.defaults.model.primary: qwen/qwen-turbo
- session.reset.idleMinutes: 30

正在重启 Gateway...
✅ Gateway 已重启

新配置已生效！

示例 3：优化配置

text

用户：帮我优化配置，节约成本

openclaw-config-expert:
正在应用省钱配置模板...

✅ 优化完成:
- 主模型：qwen3.5-plus → qwen-turbo (节约 90%)
- 自动压缩：启用 (threshold=0.6)
- 空闲超时：60 分钟
- Compassion 任务：全部 Ollama 本地

预计月度成本：¥500 → ¥50 (节约 90%)

示例 4：版本迁移

text

用户：升级到最新版本，配置需要迁移吗？

openclaw-config-expert:
正在分析版本差异...

📊 版本分析报告:
- 当前版本：2026.2.28
- 目标版本：2026.4.15
- 废弃字段：3 个
- 新增功能：5 个

正在执行迁移...
✅ 迁移完成！
- 已删除废弃的 memory 配置
- 已启用新的 session.store 格式
- 已更新插件配置结构

备份：openclaw.json.bak

示例 5：插件管理

text

用户：启用飞书插件，禁用 memory-wiki

openclaw-config-expert:
正在管理插件...

✅ 插件状态已更新:
- feishu: enabled → enabled ✅
- memory-wiki: enabled → disabled ⏸️

正在重启 Gateway...
✅ Gateway 已重启

🔗 相关技能

skill-creator: 创建和编辑技能
ontology: 存储配置实体和关系
self-improving-agent: 从配置错误中学习
wiki-maintainer: 维护记忆 Wiki

📞 故障排查

Gateway 无法启动

bash

# Hermes 执行紧急恢复
python3 ~/.openclaw/skills/openclaw-config-expert/scripts/emergency_recovery.py recover

# 查看日志
cat ~/.openclaw/logs/gateway.log

# 检查网络连通性
ping open.feishu.cn
curl -I https://api.deepseek.com

# 手动启动
openclaw gateway start

配置验证失败

bash

# 查看详细错误
python3 config_validator.py validate --verbose

# 自动修复
python3 config_validator.py validate --fix

# 回滚到上一个可用版本
python3 emergency_recovery.py rollback

Dashboard 无法访问

bash

# 检查 Gateway 状态
python3 emergency_recovery.py status

# 重启 Gateway
python3 emergency_recovery.py restart

# 检查端口
lsof -i :18789

模型全部超时（网络问题）

bash

# 检查 DNS 解析
nslookup open.feishu.cn
nslookup api.deepseek.com

# 检查代理设置
echo $HTTP_PROXY
echo $HTTPS_PROXY

# 测试网络连通性
curl -v https://api.deepseek.com/v1/models

# 查看错误日志
tail -100 ~/.openclaw/logs/gateway.log

🎯 最佳实践

配置修改流程

验证当前配置 - validate
备份配置 - 自动备份到 .bak
修改配置 - modify 或 optimize
再次验证 - validate
重启 Gateway - gateway restart
验证功能 - 访问 Dashboard 测试

紧急恢复流程

检测故障 - Hermes 自动检测或用户报告
执行恢复 - emergency_recovery.py recover
验证结果 - 检查 Dashboard 可访问性
记录日志 - 保存到 emergency-recovery.log
通知用户 - 返回恢复结果和 Dashboard URL

定期维护

bash

# 每周检查配置健康
python3 config_validator.py validate --report

# 每月检查版本更新
python3 version_migrator.py --check-updates

# 每季度优化 Agent 配置
python3 agent_optimizer.py --optimize

# 清理旧日志
find ~/.openclaw/logs -name "*.log" -mtime +30 -delete

📦 配置模板库

minimal.json - 最小有效配置

json

{
  "gateway": {"mode": "local", "bind": "loopback", "port": 18789},
  "agents": {
    "defaults": {"model": {"primary": "deepseek/deepseek-chat"}},
    "list": [{"id": "main", "default": true, "name": "Main Agent"}]
  }
}

standard.json - 标准生产配置

多模型 Provider 支持
飞书集成配置
多 Agent 专业配置
完整的工作空间设置

enterprise.json - 企业级配置

高级安全设置
多环境支持
监控和日志配置
高可用性设置

development.json - 开发环境配置

调试模式启用
详细日志输出
本地模型支持
快速迭代配置

cost-saving.json - 省钱配置

使用低成本模型
启用自动压缩
优化缓存策略
本地优先处理

🔄 维护与更新

更新配置知识库

bash

# 更新配置模板
python3 config_validator.py --update-templates

# 同步版本信息
python3 version_migrator.py --sync-versions

# 检查技能更新
python3 version_migrator.py --check-updates

贡献

欢迎提交：

新的配置模板
验证规则改进
优化算法
故障排除案例

维护者: 迪逗 🫘
最后更新: 2026-04-18
版本: 2.0.0 (融合优化版 - 整合配置专家技能包)