本文说明：OpenClaw 的 Gateway 是整个系统的核心枢纽，负责接收聊天消息、路由到 AI 代理、管理会话和频道连接。本文系统整理 Gateway 相关的所有 CLI 管理命令，包括 gateway、health、doctor、logs、status、update、reset、uninstall，每条附实用 Q&A。
一、Gateway 是什么？为什么要管理它？
Gateway 是 OpenClaw 的「大脑中枢」，它是一个运行在你机器上的后台服务进程，所有聊天消息的接收、AI 调用、工具执行都通过它转发。
二、openclaw gateway 命令详解
openclaw gateway [--port 18789]
前台启动
Q：openclaw gateway 和 openclaw gateway status 有什么区别？
openclaw gateway 在前台启动 Gateway（适合调试，关闭终端就停止）；openclaw gateway status 查询已在运行的 Gateway 服务状态（已安装为系统服务时使用）。
Q：如何让 Gateway 在后台持续运行（不关闭终端）？
方法1：执行 openclaw onboard --install-daemon，将 Gateway 安装为系统服务，开机自动启动。方法2：临时使用 nohup openclaw gateway &（重启后失效）。推荐方法1。
Q：--port 参数有什么用？默认端口是多少？
默认端口 18789，启动后可通过 http://127.0.0.1:18789/ 访问 Control UI 控制面板。如果端口冲突，用 openclaw gateway --port 18790 修改。
openclaw gateway status|start|stop|restart
服务管理
gateway status
显示 Gateway 服务的运行状态、PID、运行时间、监听端口。是排查「AI不响应」的第一步命令。
gateway start
启动已安装的 Gateway 系统服务（通过 --install-daemon 安装的）。
gateway stop
停止 Gateway 服务。注意：停止后所有聊天平台连接断开，AI 无法收到新消息。
gateway restart
重启 Gateway。修改配置文件（openclaw.json）后必须重启才生效，比 stop+start 更便捷。
三、openclaw health 命令详解
openclaw health
健康检查
Q：openclaw health 能检查哪些内容？
检查 Gateway 核心组件的健康状态，包括：API 连接是否正常、数据库/状态文件是否可读写、各频道连接状态（WhatsApp/Telegram 等）、端口是否监听。返回 JSON 格式的健康报告。
Q：health 检查通过但 AI 还是不响应，怎么办？
health 只检查本地组件。AI 不响应可能是网络问题（无法访问 Anthropic/OpenAI API 服务器）。请运行 openclaw doctor 进行更深入的诊断。
四、openclaw doctor 命令详解
openclaw doctor
系统诊断
Q：doctor 和 health 有什么区别？
health 是快速轻量检查（本地组件）；doctor 是综合深度诊断，会检查 Node.js 版本、依赖完整性、网络连通性（访问 AI API）、配置文件格式、频道认证状态等。报告更详细，有具体修复建议。
Q：doctor 显示「API connection failed」怎么解决？
这是最常见的错误——无法访问 Anthropic 或 OpenAI 的 API 服务器。国内网络直连这些服务器延迟极高，经常超时失败。解决方案：使用 1000Mbps 高速国际网络加速工具，确保终端流量走代理。
Q：doctor 报告 Node.js 版本不够怎么办？
OpenClaw 需要 Node.js 22+。运行 node --version 查看当前版本。升级：macOS 用 brew install node，Linux 用 nvm（nvm install 22 && nvm use 22），Windows 从官网下载安装包。
五、openclaw logs 命令详解
openclaw logs [--follow] [--lines 100] [--level debug|info|warn|error]
日志查看
Q：logs 命令的常用参数有哪些？
--follow / -f
实时追踪日志（类似 tail -f），调试时持续监控
--lines 200
显示最近 N 行日志，默认100行
--level error
仅显示错误级别日志，快速定位问题
--level debug
显示所有调试信息，最详细
Q：日志里看到大量 timeout/ECONNREFUSED 错误怎么解决？
timeout 表示连接 AI API 服务器超时；ECONNREFUSED 表示连接被拒绝。两种错误都是网络问题。确认你的 Node.js 进程能通过代理访问国际网络（设置 HTTP_PROXY 或 HTTPS_PROXY 环境变量）。
六、openclaw status 命令详解
openclaw status [--usage]
运行状态
Q：openclaw status 和 gateway status 有什么不同？
openclaw status 显示整体系统状态（Gateway + 所有频道 + AI 模型），加 --usage 参数可查看 API 使用量统计；openclaw gateway status 专注于 Gateway 服务进程本身的状态（是否运行、端口、PID）。
Q：如何用 status 排查「AI不说话」？
按顺序执行：① openclaw status（Gateway是否运行）→ ② openclaw health（组件是否正常）→ ③ openclaw doctor（深度诊断）→ ④ openclaw logs --level error（查看具体错误）。
七、update / reset / uninstall 命令详解
openclaw update
版本更新
Q：openclaw update 如何更新？会丢失配置吗？
执行 openclaw update 下载并安装最新版本，配置文件（~/.openclaw/openclaw.json）和 Memory/Skills 数据均安全保留，不会丢失。也可通过 npm update -g openclaw 更新（npm 安装的情况）。
Q：更新失败，网络超时怎么办？
update 需要从 npm registry 下载文件，国内直连 npm 速度慢。配置终端代理：export https_proxy=http://127.0.0.1:端口，或使用 1000Mbps 高速 VPN 确保稳定下载。
openclaw reset [--hard] [--config] [--state]
重置
Q：reset 会删除哪些数据？各参数区别是什么？
--config
仅重置配置文件（openclaw.json），保留 Memory 和 Skills
--state
重置状态数据（会话、频道连接），需要重新配对频道
--hard
⚠️ 危险：清除所有数据（配置+状态+记忆），恢复出厂状态
openclaw uninstall [--keep-data]
卸载
Q：如何完整卸载 OpenClaw？能保留数据吗？
执行 openclaw uninstall 停止服务并卸载程序。加 --keep-data 保留 Memory/Skills/配置（方便日后重装恢复）。也可通过 npm uninstall -g openclaw 卸载 npm 包。
八、openclaw setup / configure / dashboard 命令
openclaw setupQ：setup 和 onboard 有什么区别？
setup 是高级配置向导，专为已经完成 onboard 的用户提供更细粒度的配置（频道高级设置、代理配置等）；onboard 是首次上手的完整引导流程。
openclaw configureQ：configure 命令能配置什么？
直接编辑 ~/.openclaw/openclaw.json 配置文件的交互式界面。支持修改 AI 模型、频道设置、安全策略等所有选项，比手动编辑 JSON 更安全（有格式验证）。
openclaw dashboardQ：dashboard 命令是什么？
打开浏览器 Control UI 控制面板（默认 http://127.0.0.1:18789/）。无需配置任何频道即可开始聊天，适合新手快速体验和测试。
openclaw tuiQ：tui 命令有什么用？
Terminal User Interface——在终端内运行的图形化管理界面，不依赖浏览器。适合远程 SSH 管理服务器上的 OpenClaw 实例，显示实时状态和会话列表。