安全配置流程 (Safe Config Workflow)

用途

安全修改 OpenClaw 配置檔案，自動執行檢查、修復、驗證、學習反饋流程。

觸發條件

當用戶要求： - 修改配置 - 更改 Gateway 設定 - 調整渠道配置 - 修改模型/會話/認證配置 - 任何涉及 ~/.openclaw/openclaw.json 的操作

核心原則

1. 先查文件 — https://docs.openclaw.ai/zh-CN
2. 先參考 config-validator — 修改前查閱 schema 和有效值
3. 先確認 — 向用戶確認修改內容和影響
4. 不猜測 — 沒文件依據就不做
5. 要學習 — doctor --fix 後記錄教訓
6. 要過濾 — doctor 輸出由 AI 過濾，使用者只看關鍵資訊

反饋策略（兩種結合）

執行流程

標準流程（99% 情況）

# 步驟 0: 查閱 config-validator（修改前參考）
# 確認欄位存在和有效值
# 檢視配置示例

# 步驟 1: 修改配置（先向使用者確認）
# 確認模板：
# 📋 配置修改確認
# 修改內容：XXX
# 原因：XXX
# 影響：XXX
# 風險：低/中/高
# 文件依據：https://docs.openclaw.ai/zh-CN/XXX
# 是否繼續？是/否

# 步驟 2: 檢查 + 自動修復
openclaw doctor --fix
# AI 內部過濾關鍵資訊：
# openclaw doctor --fix 2>&1 | grep -E "Doctor changes|Normalized|Config overwrite|Backup|Invalid"

# 步驟 3: 對比備份（必須執行！）
diff ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.bak
# AI 解讀 diff，向用戶說明修改內容

# 步驟 4: 記錄教訓（重要！）
# 把學到的正確配置值記錄到 MEMORY.md

# 步驟 5: 等待熱過載
sleep 3
# 3 秒是合理的：熱過載是程序內重啟（SIGUSR1），官方設計為快速應用

# 步驟 6: 驗證 Gateway 狀態
openclaw gateway status
# 確認 Gateway 正常執行

排障流程（如果 Gateway 啟動失敗）

# Gateway 失敗 ≠ 機器人癱瘓！
# 診斷命令仍然可用，因為它們是檢查檔案系統，不依賴 Gateway RPC

# 步驟 1: 檢視日誌，瞭解失敗原因
openclaw logs --follow
# 檢視錯誤資訊，例如：
#   - Config validation failed: XXX
#   - Port 18789 already in use
#   - Invalid token format

# 步驟 2: 根據日誌手動修復配置
nano ~/.openclaw/openclaw.json
# 針對性修復發現的問題

# 步驟 3: 再次嘗試啟動
openclaw gateway restart

# 步驟 4: 再次驗證
openclaw gateway status

輸出格式

修改前確認

📋 配置修改確認

修改內容：XXX
原因：XXX
影響：XXX
風險：低/中/高
文件依據：https://docs.openclaw.ai/zh-CN/XXX

是否繼續？是/否

doctor --fix 後反饋

AI 向用戶反饋的格式（必須遵守）：

✅ 配置檢查完成

【修復內容】
- 欄位：channels.telegram.streaming
- 原值："invalid_test_value"（無效）
- 新值："off"（有效）

【備份位置】
~/.openclaw/openclaw.json.bak

【其他警告】（與配置無關，可選處理）
- Node 版本警告：系統 Node 16.5.0，建議升級到 22+
- 會話記錄缺失：1/2 sessions 缺少 transcript

小問題（不麻煩使用者）：

✅ 配置檢查完成

doctor 輸出：無問題 / 修復了 XXX（小問題，已自動修復）

已記錄到：MEMORY.md

重要配置（反饋使用者）：

✅ 配置檢查完成

【修復內容】
- 欄位：XXX
- 原值："XXX"（無效）
- 新值："XXX"（有效）

【學到的知識】
- 正確值：XXX
- 含義：XXX
- 文件：https://docs.openclaw.ai/zh-CN/XXX

⚠️ 注意：XXX（影響說明）

已記錄到：MEMORY.md

驗證結果

✅ Gateway 狀態正常

Runtime: running
RPC probe: ok
7w4.net小蔥技能。

失敗排障

❌ Gateway 啟動失敗

錯誤日誌：
XXX（從 logs --follow 獲取）

已手動修復：XXX
正在重啟 Gateway...

✅ Gateway 已恢復正常

doctor --fix 輸出解讀規則（AI 必須遵守）

AI 職責：過濾並總結關鍵資訊

AI 應該執行的過濾（內部處理，使用者不需要看）：

openclaw doctor --fix 2>&1 | grep -E "Doctor changes|Normalized|Config overwrite|Backup|Invalid"

AI 向用戶反饋時明確分類： - 修復項 — Doctor changes、Normalized、Config overwrite - 警告項 — Node 版本、會話記錄、Skills 狀態等

AI 必須執行的操作： 1. 過濾 doctor 輸出，提取關鍵修復資訊 2. 對比備份檔案，解讀 diff 3. 向用戶反饋修復內容（欄位、原值、新值） 4. 記錄教訓到 MEMORY.md 5. 等待 3 秒後驗證 Gateway 狀態

安全規則

1. 修改前必須查文件 — https://docs.openclaw.ai/zh-CN
2. 修改前必須向用戶確認 — 即使是你要求的
3. 絕不猜測欄位值 — 沒文件依據就不做
4. 修復後必須學習 — 記錄到 MEMORY.md
5. Gateway 失敗仍可排障 — 診斷命令不依賴 Gateway
6. 輸出必須過濾 — 使用者只看關鍵資訊，雜項由 AI 處理

已知侷限

相關文件

• 官方配置文件：https://docs.openclaw.ai/zh-CN/gateway/configuration
• 官方 doctor 文件：https://docs.openclaw.ai/zh-CN/cli/doctor
• 官方 Gateway 手冊：https://docs.openclaw.ai/zh-CN/gateway/index.md
• 官方故障排除：https://docs.openclaw.ai/zh-CN/gateway/troubleshooting
• 官方 FAQ：https://docs.openclaw.ai/zh-CN/help/faq.md

版本歷史

• v1.0 (2026-02-26) — 初始版本，包含完整流程和反饋策略
• v1.1 (2026-02-26) — 更新測試驗證後的流程，新增輸出過濾規則和已知侷限

這個 Skill 的文件質量不錯，流程清晰、有測試指南和反饋策略說明。但作為 Skill 來說，它更像一份操作手冊而非可執行的工具，實際功能實現較少。如果需要一個真正能自動執行配置檢查和修復的工具，可能需要進一步補充程式碼實現。