OpenClaw 运维

OpenClaw 在实际部署中的网络、配置、服务管理与故障排查方法论。

核心环境参数

• Clash 代理端口：127.0.0.1:7897
• Gateway 端口：18789
• Node.js 版本：v24.13.1（通过 fnm 管理）

常见问题分类

• 网络类：network_error（代理未启动/上下文超限/服务故障）、fetch failed（Node.js fetch 不支持 HTTP_PROXY）
• 配置类：Config invalid（废弃键如 mcp、label）、默认账号未配置、插件重复
• 服务类：Gateway 无法启动、LaunchAgent 丢失、代理配置被 install 覆盖

关键运维原则

• 升级必备份：openclaw.json 和 ai.openclaw.gateway.plist 升级前必须备份。
• install 必恢复：openclaw gateway install 会重置代理配置，需手动恢复 HTTP_PROXY/HTTPS_PROXY/NO_PROXY/NODE_OPTIONS。
• 定期巡检：每日检查 Clash/Gateway/消息响应；每周看日志；每月备份与更新规则。

Coding Agent 在运维中的角色

• Claude Code：复杂配置修复、批量修改
• Cursor：可视化编辑 plist、需要 GUI 确认的场景
• OpenCode：快速诊断、轻量修复
• Kimi CLI：中文环境下的配置修复

来源

• src-OpenClaw运维手册