从安装到日常使用，一篇搞定 OpenClaw 的核心命令，长期更新，建议收藏

一、安装 OpenClaw

OpenClaw 基于 Node.js 运行，安装前需要先配置好 Node.js 环境。以下是在 Ubuntu/Debian 系统上的完整安装流程。

STEP 1 · 安装 Node.js

sudo apt install nodejs
# 安装过程中输入 y，确认安装
node -v

STEP 2 · 安装 npm

sudo apt install npm
# 安装过程中输入 y，确认安装
npm -v

STEP 3 · 安装 n 版本管理器 & 升级 Node

sudo npm install -g n
sudo N_NODE_MIRROR=https://npmmirror.com/mirrors/node n lts
hash -r

说明： 使用 国内镜像源 安装 LTS 版本的 Node.js，速度更快。

STEP 4 · 升级 npm

sudo npm install npm@latest -g

STEP 5 · 配置 npm 镜像源

npm config set registry https://registry.npmmirror.com
npm config get registry

说明： 将 npm 默认源切换为 国内镜像，后续安装包会快很多。

STEP 6 · 安装 Git

sudo apt install git
git -v

STEP 7 · 安装 OpenClaw

sudo npm install -g openclaw
openclaw -v

STEP 8 · 初始化引导

openclaw onboard

二、使用 OpenClaw 常用命令

安装完成后，以下是你日常会用到的核心管理命令。

openclaw dashboard

打开 Web 控制面板，可视化管理你的 Agent 配置和状态。

openclaw gateway restart

重启 Gateway 服务。修改配置后常用此命令让改动生效。

openclaw doctor --fix

运行健康检查并自动修复发现的问题。遇到异常时首选此命令。

openclaw configure

进入配置交互界面，调整 Agent、模型、频道等设置。

openclaw models list

列出当前可用的所有模型，查看模型别名和状态。

openclaw models set 模型名称

切换默认使用的模型，例如 openclaw models set gpt-4o。

openclaw models fallbacks clear

清空所有回退模型，恢复单一主模型模式。

openclaw models fallbacks add 模型名称

模型名称添加回退模型，主模型不可用时，按添加顺序依次尝试。

三、对话命令

在与 OpenClaw Agent 对话时，可以使用以下斜杠命令快速控制交互流程。

命令

说明

/undo

撤销上一条消息，回退到之前的状态。发错了？撤回重来。

/stop

停止当前正在进行的回复或任务。Agent 正在输出时可以随时中断。

/new

开启一个全新的对话会话，清除当前上下文。

/feishu doctor

诊断飞书频道的连接状态，排查消息收发问题。

/status

输入后会返回当前会话的状态卡片

四、安装 MiniMax CLI

MiniMax CLI 是官方命令行工具，装好后可解锁多模态。

STEP 1 · 安装 mmx-cli

sudo npm install -g mmx-cli

STEP 2 · 登录认证

mmx auth login --api-key sk-xxxxx

说明： 把 sk-xxxxx 替换成自己的 API key，完成账号绑定。

STEP 3 · 拉取 CLI 源码

git clone https://ghfast.top/https://github.com/MiniMax-AI/cli.git /tmp/minimax-cli --depth=1

说明： 通过 ghfast 加速拉取 GitHub 仓库，--depth=1 只克隆最近一次提交,体积小、速度快。

STEP 4 · 安装扩展 Skills

npx skills add /tmp/minimax-cli -y -g

说明： -y 自动确认，-g 全局安装，所有项目都可调用。

STEP 5 · 清理临时目录

rm -rf /tmp/minimax-cli

STEP 6 · 验证安装

mmx quota

说明： 正常输出版本与额度信息即表示安装成功。