easy-openclaw

# 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：环境预检（轻量）

正式开始前，执行以下只读预检：

```bash
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"
```

输出口径：
- `已就绪`
- `可自动修复`
- `需人工处理`

预检阶段默...

# easy-openclaw：OpenClaw 小白友好配置向导

如果你刚开始用 OpenClaw，觉得配置麻烦、功能太多看不懂，这个项目就是给你用的。

它把复杂配置变成“对话选择题”：你只要回答开/关，OpenClaw 就能帮你把常用优化一次性配好。

## 这个项目能帮你解决什么

- 不想手改配置文件，也不想记命令。
- 不想每个功能单独折腾，想一次搞定。
- 想开安全审批，但怕配错。
- 想接 Discord / Telegram / Feishu，但不知道从哪一步开始。
- 想装一些实用 Skills，但不想自己到处找教程。

## 一共 4 层能力（按顺序）

1. 基础体验优化
- 流式输出（回答边生成边显示）
- 记忆功能（记忆增强；可选每天归档）
- 消息回执（已读反馈）
- 联网搜索（`defuddle` 优先，`r.jina.ai` 备用）
- 权限模式（默认 coding，也可切 full / minimal）

2. 渠道专项优化
- Exec 高危操作审批（第 2 轮统一收集，`coding/full` 有效，默认建议关；开启后优先放行常见命令，尽量只拦真正高敏操作）
- Discord：频道免 @ 响应、审批按钮（可选，需先开启审批）
- Feishu：探测 24h 缓存优化（降低额度消耗）
- Telegram：本层可直接配置审批提示投递

3. Skills 推荐与安装
- 默认直接展示推荐清单
- 你点名要装哪个，AI 立刻执行安装
- 包含：OpenClaw Backup、Agent Reach、安全防御矩阵、Find Skills、Youtube Clipper、OpenClaw Medical Skills
- 同时直接展示两个生态仓库入口：`awesome-openclaw-usecases`、`awesome-openclaw-skills`

4. 新渠道接入引导
- 可以继续新增 Discord / Telegram / Feishu
- 按步骤引导你去平台后台拿必要信息
- 回传后自动写入并验证

## 你怎么用（3 步）

1. 对你的 OpenClaw 说：

> 从 `https://github.com/daheiai/easy-openclaw` 安装并启用这个 skill。

2. 跟着它回答问题（开/关，或按格式回复）。

3. 最后确认写入并重启 Gateway，配置就生效了。

## 新手建议

- 第一次先在测试环境跑一轮。
- 如果你要接 Discord / Telegram，确保：
  - OpenClaw 所在服务器可以访问对应平台
  - 你当前网络环境也可以访问对应平台

## 项目文件说明（想深入再看）

- `SKILL.md`：主流程规则（AI 按这个执行）
- `references/`：各层详细说明

## 项目参考

- OpenClaw：`https://github.com/openclaw-ai/openclaw`
- OpenClaw Backup：`https://clawhub.ai/alex3alex/openclaw-backup`
- Agent Reach：`https://github.com/Panniantong/Agent...