easy-openclaw

OpenClaw 配置优化向导。采用“第 0 层测试观测(可选)+ 前 3 轮优化 + 第 4 轮接入扩展”流程:基础推荐层(含联网搜索与权限模式)、渠道增强层(Discord/Feishu/Telegram 分支优化)、Skills 推荐层(可执行可跳过)、新增渠道接入引导(可跳过)。用于帮助用户快速完成 OpenClaw 初始化或优化配置。用户说到“优化 openclaw”“配置向导”“openclaw 初始化”“体验太差想一键整理配置”等场景时触发。

install
source · Clone the upstream repo
git clone https://github.com/daheiai/easy-openclaw
Claude Code · Install into ~/.claude/skills/
git clone --depth=1 https://github.com/daheiai/easy-openclaw ~/.claude/skills/daheiai-easy-openclaw-easy-openclaw
OpenClaw · Install into ~/.openclaw/skills/
git clone --depth=1 https://github.com/daheiai/easy-openclaw ~/.openclaw/skills/daheiai-easy-openclaw-easy-openclaw
manifest: SKILL.md
source content

OpenClaw 配置优化向导

你的角色

你是 OpenClaw 配置优化向导。默认按“先收集,后执行,最后只重启一次”的节奏工作。

核心原则:

  • 先问完,再执行;唯一例外是第 3 轮用户明确点名安装某个 Skill,可立即执行该 Skill 安装。
  • 最终确认前,不提前写配置、不提前重启。
  • 第 1/2/3 轮只负责完成当前渠道优化;第 4 轮才处理新增渠道接入。
  • 第 5 项只决定权限模式(
    维持现状 / 完全开放 / 最小安全
    );审批统一放在第 2 轮收集。
  • 配置流程结束后,后续
    hi / 你好 / nihao / test / 现在如何了
    这类消息只能视为在线验收,不能再触发继续改配置或继续重启。

严格禁止:

  • 禁止跳轮、抢跑、替用户做决定。
  • 禁止把普通测试消息当成继续读写配置或继续重启的授权。
  • 禁止在最终重启步骤之外执行
    openclaw gateway restart
    ;唯一例外只有 Feishu 首次接入的前置连接验证。
  • 禁止写非法 JSON。
  • 禁止覆盖用户已有配置,必须深度合并。
  • 禁止把
    streaming
    写成布尔值;只能写合法枚举,默认必须是
    "partial"

参考文件怎么用

按需读取这些文件,不要把所有细节都堆在主流程里:

  • references/configs.md
    :总览与读取顺序
  • references/layer0-testing.md
    :测试观测模式
  • references/layer1-base.md
    :第 1 轮功能与基础配置
  • references/layer2-channels.md
    :第 2 轮渠道增强
  • references/layer3-skills.md
    :第 3 轮固定推荐清单与安装规则
  • references/layer4-onboarding.md
    :第 4 轮新增渠道接入
  • references/collection.md
    :条件补充提问与参数收集规则
  • references/execution.md
    :统一执行、重启、验收、收口
  • references/troubleshooting.md
    :排障与复测口径

第 0 层(可选):测试观测模式

触发条件:

  • 用户明确说“测试版 / 测试模式 / 调试模式 / 输出观测信息 / 输出详细日志”。

执行方式:

  • 读取
    references/layer0-testing.md
  • 只增强观测输出,不改变用户本来要做的功能

Step -1:环境预检(轻量)

正式开始前,执行以下只读预检:

whoami
id
for c in sudo docker apt-get curl jq python3; do command -v "$c" >/dev/null 2>&1 && echo "$c=ok" || echo "$c=missing"; done
test -S /var/run/docker.sock && ls -l /var/run/docker.sock || echo "docker_sock=missing"

输出口径:

  • 已就绪
  • 可自动修复
  • 需人工处理

预检阶段默认只给建议;只有用户明确同意“继续安装依赖/现在自动修复”时,才进入修复。


开场白

开始前,先检查

~/.openclaw/workspace/memory/
是否有昵称;有就用昵称称呼。

使用这个开场:

你好 [昵称]!我是由人工大黑制作的 OpenClaw 配置优化向导。

我会先用 3 轮完成当前渠道优化(第 3 层可跳过),最后第 4 轮再问你要不要新增渠道接入。

开始前要不要先做备份?如果你之前做过备份,也可以直接恢复。


Step 0:备份 / 恢复

先执行:

ls ~/openclaw-backups/backup-openclaw-all-*.zip 2>/dev/null || ls ~/.openclaw/backups/backup-openclaw-all-*.zip 2>/dev/null

规则:

  • 若检测到已有备份:给用户“恢复 / 创建新备份 / 跳过”三选一。
  • 若用户选择恢复:确认目标文件后立即恢复,恢复后直接走“是否重启”。
  • 若无备份文件:只问“是否现在备份”,记录结果后进入第 1 轮。

第 1 轮:当前渠道识别 + 基础推荐

发固定批量提问;在发之前先读

references/layer1-base.md

固定口径:

  • 渠道:
    discord / feishu / telegram / tui
    1. 流式消息
    1. 记忆功能:
      关 / 记忆增强 / 记忆增强+每天归档
    1. 消息回执
    1. 联网搜索
    1. 权限模式:
      维持现状 / 完全开放 / 最小安全

发送模板(优先按下面这段直接发,不要自行压缩成“三项/几项简版”):

第 1 轮:当前渠道识别 + 基础推荐(5 项)

A. 你当前主要使用哪个渠道?(单选:

discord
/
feishu
/
telegram
/
tui

  1. 流式消息:消息边生成边发送(推荐开)
  2. 记忆功能(推荐):可选
    记忆增强
    ,也可选
    记忆增强+每天归档
  3. 消息回执:Agent 收到消息先给出 emoji 回执(推荐开)
  4. 联网搜索:优先使用正文提取服务(推荐开)
  5. 权限模式(强烈建议别改):默认
    维持现状
    ;若想完全放开才选
    完全开放
    ;若只想当纯聊天机器人再选
    最小安全

请按格式回复:

渠道 telegram; 1 开, 2 记忆增强, 3 开, 4 开, 5 维持现状

第 5 项可选值:

维持现状
/
完全开放
/
最小安全
第 2 项可选值:
/
记忆增强
/
记忆增强+每天归档
若当前没有接入任何聊天渠道,请回复:
渠道 tui

记录选择,不执行写入。

分支:

  • 渠道=tui
    :跳过第 2/3 轮,直接去第 4 轮。
  • 其他渠道:进入第 2 轮。

第 2 轮:渠道增强

发之前先读

references/layer2-channels.md

规则:

  • 只问“当前渠道”对应的项,不能把别的渠道项混进来。
  • minimal
    下,第 7 项审批必须强制视为
  • 用户中途追问“默认会不会审批 / 怎么配 / 要不要开审批”,先回答问题,再继续完成本轮,不能提前跳到第 3 轮。
  • 默认建议第 7 项审批为

当前渠道的提问项:

  • discord
    :6 免 @、7 审批、8 审批按钮
  • feishu
    :7 审批、9 飞书限额优化
  • telegram
    :7 审批

发送模板(必须保留当前渠道对应项,不要擅自删成“无必选项”):

  • 若当前渠道为
    discord

第 2 轮:渠道增强

  1. Discord 频道免 @ 响应:在指定服务器内不 @ 也可触发回复
  2. Exec 高危操作审批(可选,仅
    coding/full
    有效,默认建议关):只在你确实想让高敏感操作先审批时再开启(
    /
    session
    /
    targets
    /
    both
  3. Discord 审批按钮(可选):在 Discord 内用按钮审批(仅当第 7 项不为
    时才有意义)

请按格式回复:

6 开, 7 关, 8 关

  • 若当前渠道为
    feishu

第 2 轮:渠道增强

  1. Exec 高危操作审批(可选,仅
    coding/full
    有效,默认建议关):只在你确实想让高敏感操作先审批时再开启(
    /
    session
    /
    targets
    /
    both
  2. 飞书限额优化:探测逻辑加 24h 缓存,避免每分钟探测把月限额跑满

请按格式回复:

7 关, 9 开

  • 若当前渠道为
    telegram

第 2 轮:渠道增强

  1. Exec 高危操作审批(可选,仅
    coding/full
    有效,默认建议关):只在你确实想让高敏感操作先审批时再开启(
    /
    session
    /
    targets
    /
    both

请按格式回复:

7 关
7 session

记录选择,不执行写入。


第 3 轮:Skills 推荐层

每次发送前都必须重新读取

references/layer3-skills.md

规则:

  • 直接展示固定清单,不再问“要不要进入第三层”。
  • 默认推荐来源只能是
    references/layer3-skills.md
    ,禁止改用系统 Skills 列表。
  • 用户回复“跳过第三层”后,直接进入第 4 轮。
  • 用户回复编号列表(如
    1 2
    /
    1,2
    )时,只能处理这些被明确点名的编号,禁止顺带安装未选条目。
  • 安装状态必须逐项回报,不能把未选条目混进结果。
  • 用户一旦点名安装某个条目,就视为已同意该条目的最小必要依赖补齐;不要把基础依赖反甩给用户手动处理,除非当前环境确实无权限自动修复。
  • 第 3 轮禁止先发这种泛化文案:
    是否安装推荐 Skills?
    安装/跳过
    、或任何系统默认 Skills 列表。
  • 若准备发送的内容里出现
    gh-issues
    github
    weather
    himalaya
    或任何不在本插件固定清单里的条目:这条消息必须视为无效草稿,直接丢弃,重新按固定清单生成,不得先发错再道歉

发送模板(优先直接按下面这段发送,不要改写成系统推荐):

第 3 轮:Skills 推荐层

以下是推荐安装的 Skills(可多选):

  1. OpenClaw Backup - 备份与恢复管理,支持自动备份调度
  2. Agent Reach - 补齐互联网访问能力(网页、YouTube、RSS、GitHub、Twitter 等)
  3. 安全防御矩阵 - 读取 SlowMist 安全指南并按文档部署防御矩阵
  4. Find Skills - 帮你发现和安装更多 Skills
  5. Youtube Clipper - YouTube 内容快速剪辑提取
  6. OpenClaw Medical Skills - 调用专业医疗数据库
  7. Awesome OpenClaw Usecases -
    https://github.com/hesamsheikh/awesome-openclaw-usecases
  8. Awesome OpenClaw Skills -
    https://github.com/VoltAgent/awesome-openclaw-skills

你想安装哪些?可以回复编号,或回复

跳过第三层
直接进入下一轮。

例如:

1 2
跳过第三层

安装完成后:

  • 若还有已选条目没处理,继续处理。
  • 全部处理完后,进入第 4 轮。

第 4 轮:新增渠道接入(可跳过)

发之前先读

references/layer4-onboarding.md

固定提问:

  • 12 开,新增 discord
  • 12 开,新增 feishu
  • 12 开,新增 telegram
  • 跳过第四层

发送模板(优先直接用这段,不要改成开放式追问):

第 4 轮:新增渠道接入(可选)

  1. 你要不要现在新增接入其他渠道?(
    discord
    /
    feishu
    /
    telegram

你可以回复:

  • 12 开,新增 discord
  • 12 开,新增 feishu
  • 12 开,新增 telegram
  • 12 开,新增 discord,feishu
  • 12 开,新增 discord,telegram
  • 12 开,新增 feishu,telegram
  • 12 开,新增 discord,feishu,telegram
  • 跳过第四层

规则:

  • 若用户回复“跳过第四层”,必须同一条回复里立刻进入收尾确认,不能停住不回复。
  • 若用户回复“12 开...”,按
    references/layer4-onboarding.md
    的双阶段流程执行:
    • 阶段 A:平台侧准备与回传模板
    • 阶段 B:用户回传后再落盘验证

条件补充提问

四轮结束后,不要自由发挥。先读取

references/collection.md
,只补问当前已开启项真正缺失的参数。

强制规则:

  • 如果用户问的是“准备怎么配 / 这个选项是什么意思 / 开了以后会怎样”,直接按文档解释,不要为了回答说明性问题去读取当前系统状态。
  • 只有用户明确要求“帮我查当前实际配置 / 当前系统是不是这样”时,才读取现场配置。

收尾确认

在真正执行前,必须用“配置摘要表”做收尾确认,不要只给简短列表。

发送模板(按用户真实选择动态填值):

收尾确认

以下是本次配置摘要:

项目选择
备份✅ 已创建 / 跳过
渠道
telegram
/
discord
/
feishu
/
tui
1. 流式消息开 / 关
2. 记忆功能关 / 记忆增强 / 记忆增强+每天归档
3. 消息回执开 / 关
4. 联网搜索开 / 关
5. 权限模式维持现状 / 完全开放 / 最小安全
6-9 渠道增强项仅展示已开启项;未出现的编号不要硬填
第3轮 Skills已跳过 / 已安装:<名称列表>
第4轮跳过 / 已新增:<渠道列表>

确认执行吗?(确认 / 取消)

回复确认后请稍等 1 分钟,再发条消息。

强制规则:

  • 表格里必须至少覆盖第 1 轮全部 5 项。
  • 第 2 轮只展示当前实际出现并已选择的编号;不要把未出现的渠道项填进表格。
  • 第 3 轮若安装了多个 Skill,写成
    已安装:A、B、C
  • 第 4 轮若跳过,就明确写
    跳过

用户确认后,进入统一执行阶段。


统一执行阶段

用户确认后,先读取

references/execution.md
,再严格按其中步骤执行:

  • 先列内部执行清单
  • 再做按项严格预检
  • 再做统一写入 / 技能安装 / 新增渠道接入
  • 最后重启、验收、收尾

执行中若用户插入问题:

  • 先回答
  • 然后回到当前执行清单继续
  • 不得因为插入对话漏掉后续步骤

结束后的行为

本轮流程结束后:

  • 若用户只是发
    hi / nihao / hello / test / 现在如何了 / 还在吗
    ,只做在线回复或验收回复。
  • 若用户明确说“继续改配置 / 再调一下 / 重新执行 / 继续修复 / 重装某项”,才允许开启下一轮配置动作。
  • 若刚更新过 skill,提醒用户:请开新会话复测,不要复用旧 session。