从安装到日常使用,一篇搞定 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

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 Agent 对话时,可以使用以下斜杠命令快速控制交互流程。

命令

说明

/undo

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

/stop

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

/new

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

/feishu doctor

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

/status

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