OpenClaw 常用命令与术语解释
适合新手快速上手：一篇看懂常用命令、常见诊断方式和核心结构概念。
一、常用命令速查
常用命令
# 启动 openclaw 会话
openclaw
# 重新配置（修改模型 / API）
openclaw configure
# 打开 Web 控制台
openclaw dashboard
# 查看运行状态
openclaw status
# 重启 openclaw 服务
openclaw gateway restart
# 查看可用模型
openclaw models
# 首次初始化向导
openclaw onboard
# 进入 AI 终端界面
openclaw tui
# 停止 Gateway
openclaw gateway stop
# 基础检查（常见问题排查）
openclaw doctor
# 查看已安装 Skill
openclaw skills
openclaw skill list
# 自动修复常见问题
openclaw doctor --repair
# 深度检查（系统服务 / 多 Gateway / sandbox）
openclaw doctor --deep
# 删除所有配置
openclaw uninstall
# 卸载 openclaw （通过 npm 安装）
npm uninstall -g openclaw
二、常见命令含义
下面这些命令最容易混淆，按“检查、修复、状态、卸载”来理解会更清楚。
openclaw
启动 AI agent 会话
本质是：启动一个 AI agent 会话，类似打开一个终端交互窗口，开始和 AI 对话。
- 类似：打开一个终端交互窗口、开始和 AI 对话
- 不会做：不会重启服务、不会清空后台状态、不会刷新插件，它只是“连接并使用”
openclaw gateway restart
重启 OpenClaw 后台服务
本质是：重启 OpenClaw 后台服务（gateway）。
- gateway 负责：API 请求、插件加载、skills 执行、webhook / 微信接入
- 会做的事：重新加载 plugins、重新加载 skills、重置连接状态、清理异常状态
openclaw doctor
基础检查
适合排查“无法启动、无法连接、响应异常”等常见问题，会重点检查这些内容：
- Gateway 是否运行
- 模型配置是否正确
- API Key 是否有效
- WhatsApp / Telegram 是否连接
- 端口是否冲突
- 配置文件是否损坏
openclaw doctor --repair
自动修复
用于自动修复常见问题，适合检查后直接尝试恢复服务。
- 重启 Gateway
- 修复配置异常
- 修复 sandbox 等常见运行问题
openclaw doctor --deep
深度检查
适合基础排查和自动修复后仍未解决时继续定位问题。
- 系统服务状态
- 是否存在多个 Gateway 实例
- sandbox 与 agent 环境是否正常
openclaw status
查看当前状态
想确认机器人是不是在线、模型是否正常、频道是否连接时，直接运行这个命令即可。
openclaw uninstall
清理服务，不是卸载 CLI
这个命令更接近“关闭 + 清理服务”，不会把 openclaw 命令本体从系统里删除。
- 会删除：Gateway 服务、后台守护进程、部分运行数据
- 不删除：
openclaw命令本体、npm 全局安装内容
npm uninstall -g openclaw
真正卸载 OpenClaw
这是卸载 OpenClaw CLI 的方式，执行后系统里将不再存在 openclaw 命令。
将会删除：/opt/homebrew/lib/node_modules/openclaw 和 /opt/homebrew/bin/openclaw
三、核心术语解释
CLI
命令行工具入口，用来管理 OpenClaw 的启动、配置、诊断。
Gateway
核心服务进程，负责模型调用、消息转发和会话管理。
Dashboard
Web 控制台，可在浏览器内查看状态、管理配置。
Agent
执行 AI 任务的主体，处理对话、调用技能、输出结果。