运维与插件

这一课你将能做到

1. 熟练使用 openclaw doctor 做健康检查与修复
2. 创建状态备份与灾难恢复
3. 用 MCP 扩展 Gateway 的集成能力，理解插件生命周期

为什么要学

bot 上线只是开始，运维是持久战：版本更新会不会搞坏配置？磁盘满了怎么办？新同事要接入 MCP 服务怎么配？这一课解决的是「让 bot 活到下一年」的问题——健康巡检、状态备份、插件治理、灾难恢复。

人话：运维不是救火，是提前把火源掐灭。

先建立图像

运维工具箱

健康检查：openclaw doctor [--fix|--lint|--json]
  ├── 配置合法性校验
  ├── 插件加载状态
  ├── SQLite 维护
  └── 会话一致性检查

备份：openclaw backup create
  └── 打包 ~/.openclaw/ 全部状态（配置、会话、记忆、插件）

更新：openclaw update [--channel stable|dev]
  ├── 软件更新
  ├── 插件迁移
  └── 配置自动修复

扩展层
  ├── MCP：外部服务协议（数据库、API、内部系统）
  ├── Plugin：OpenClaw 原生插件（渠道、Provider、工具）
  └── Skill：轻量能力包（工具+说明书）

跟着做

步骤 1：运行健康检查

# 交互式健康检查
openclaw doctor

# 只读 JSON 报告（CI 友好）
openclaw doctor --json

# 自动修复
openclaw doctor --fix

# 严格检查（CI gate）
openclaw doctor --lint --json

步骤 2：创建备份

# 完整备份
openclaw backup create

# 查看备份位置
openclaw backup list

# 恢复
openclaw backup restore <backup-id>

备份包含配置、会话、记忆、插件安装状态。迁移到新机器时直接恢复即可。

步骤 3：更新与回滚

# 稳定版更新
openclaw update

# 追开发版新特性
openclaw update --channel dev

# 查看更新历史
openclaw update status

# 回滚
openclaw update --rollback

步骤 4：管理 MCP 服务

# 查看已保存的 MCP 服务器
openclaw mcp registry list

# 添加 MCP 服务器
openclaw mcp registry add my-db \
  --command "npx -y @modelcontextprotocol/server-postgres" \
  --env DATABASE_URL="postgresql://..."

# 以 MCP 服务器模式运行 OpenClaw
openclaw mcp serve

步骤 5：管理插件

# 列出已安装插件
openclaw plugins list

# 安装社区插件
openclaw plugins install @openclaw/telegram-enhanced

# 检查插件健康
openclaw plugins inspect

# 更新插件
openclaw plugins update --all

步骤 6：查看会话与状态

# 查看活跃会话
openclaw sessions list

# 查看系统状态
openclaw status --verbose

# 查看日志
openclaw logs --tail 50

讲清楚要点

1. doctor 是运维核心工具：不只是检查，还能 --fix 自动修复配置迁移、--lint 做 CI gate、--state-sqlite compact 做数据库维护。上线前、升级后、出问题时都要跑。
2. 备份是状态全量打包：openclaw backup create 备份 下全部状态，恢复后 Gateway、记忆、会话、配置全回来。定期备份是底线要求。