Skip to content

operations-runbook.zh-CN.md

Latest commit

 

History

History
128 lines (87 loc) · 2.85 KB

operations-runbook.zh-CN.md

File metadata and controls

128 lines (87 loc) · 2.85 KB

ZeroClaw 运维操作手册

本操作手册适用于维护可用性、安全态势和事件响应的运维人员。

最后验证时间：2026年2月18日。

范围

本文档适用于日常运维操作：

  • 启动和监管运行时
  • 健康检查和诊断
  • 安全发布和回滚
  • 事件分类和恢复

首次安装请从 one-click-bootstrap.zh-CN.md 开始。

运行时模式

模式 命令 使用场景
前台运行时 zeroclaw daemon 本地调试、短期会话
仅前台网关 zeroclaw gateway webhook 端点测试
用户服务 zeroclaw service install && zeroclaw service start 持久化运维管理的运行时

运维基线检查清单

  1. 验证配置：
zeroclaw status
  1. 验证诊断：
zeroclaw doctor
zeroclaw channel doctor
  1. 启动运行时：
zeroclaw daemon
  1. 对于持久化用户会话服务：
zeroclaw service install
zeroclaw service start
zeroclaw service status

健康和状态信号

信号 命令 / 文件 预期结果
配置有效性 zeroclaw doctor 无严重错误
渠道连通性 zeroclaw channel doctor 配置的渠道健康
运行时摘要 zeroclaw status 预期的提供商/模型/渠道
守护进程心跳/状态 ~/.zeroclaw/daemon_state.json 文件定期更新

日志和诊断

macOS / Windows（服务包装器日志）

  • ~/.zeroclaw/logs/daemon.stdout.log
  • ~/.zeroclaw/logs/daemon.stderr.log

Linux（systemd 用户服务）

journalctl --user -u zeroclaw.service -f

事件分类流程（快速路径）

  1. 快照系统状态：
zeroclaw status
zeroclaw doctor
zeroclaw channel doctor
  1. 检查服务状态：
zeroclaw service status
  1. 如果服务不健康，干净重启：
zeroclaw service stop
zeroclaw service start

  1. 如果渠道仍然失败，验证 ~/.zeroclaw/config.toml 中的白名单和凭证。

  2. 如果涉及网关，验证绑定/认证设置（[gateway]）和本地可达性。

安全变更流程

应用配置更改前：

  1. 备份 ~/.zeroclaw/config.toml
  2. 每次只应用一个逻辑变更
  3. 运行 zeroclaw doctor
  4. 重启守护进程/服务
  5. 使用 status + channel doctor 验证

回滚流程

如果发布导致行为退化：

  1. 恢复之前的 config.toml
  2. 重启运行时（daemon 或 service）
  3. 通过 doctor 和渠道健康检查确认恢复
  4. 记录事件根本原因和缓解措施

相关文档