LLM Wiki

src-OpenClaw运维手册

来源 openclaw 运维 故障排查 来源数 1 Fri Apr 10 2026 08:00:00 GMT+0800 (China Standard Time)

src-OpenClaw运维手册

原始来源： raw/tech-docs/OpenClaw运维手册.md 作者： 水的离子积 日期： 2026-03-25 状态： 已整理

一句话摘要

OpenClaw 的实战运维手册，涵盖网络/配置/服务三类常见问题、日常巡检清单、故障排查流程、版本升级指南，以及用 Coding Agent 自动修复的完整方案。

关键收获

  1. 环境要求：Clash 代理端口 127.0.0.1:7897、Gateway 端口 18789、Node.js v24.13.1。
  2. 网络类问题：
    • network_error：代理未启动 / 上下文超限 / 服务故障。
    • fetch failed：Node.js 原生 fetch 不支持 HTTP_PROXY，需用 undici 预加载脚本覆盖。
  3. 配置类问题：
    • Config invalid：openclaw.json 中含废弃键（mcp、label）。
    • Feishu account 'default' not configured：重复/空配置的 default 账号。
    • Duplicate feishu plugin detected：~/.openclaw/extensions/feishu/ 与内置插件冲突。
  4. 服务类问题：LaunchAgent 丢失、代理配置被 install 覆盖、Gateway 无法启动。
  5. 日常巡检：每日检查 Clash/Gateway/消息响应；每周看日志；每月备份配置和检查 plist。
  6. 版本升级关键：先备份 openclaw.json 和 plist → 升级 → install → 重新恢复代理配置 → 启动验证。
  7. Coding Agent 自动修复：Claude Code 适合复杂配置修复/批量修改；Cursor 适合可视化编辑 plist；OpenCode 适合快速诊断；Kimi CLI 适合中文环境。

提及的实体

提及的概念