给新手看的命令参考

OpenClaw 命令大全

先看懂每条命令是做什么的，再决定要不要复制执行。这一页专门按新手能理解的方式来写，也会明确标出有风险的操作。

不需要很强的终端基础，也能先看懂这页再动手。
先读解释，再判断这条命令是否适合你当前的部署方式。
会中断服务或改动系统状态的命令，都有明显风险标记。

如果你不知道从哪开始

1还没装 OpenClaw，就先看安装类命令。
2装好后，优先熟悉重启和日志这两组最常用命令。
3只有当你真的在用 Docker、VPS 或备份方案时，再去看后面的分组。

快速跳转

安装与首次启动更新与重启日志与排障 Docker 与 VPS 备份与恢复

install

安装与首次启动

安全

检查这台电脑有没有装 Node.js

在安装或更新 OpenClaw 之前，先看当前机器上的 Node.js 版本。

node -v

安装与首次启动MacLinuxWindows

这条命令是做什么的: 在安装或更新 OpenClaw 之前，先看当前机器上的 Node.js 版本。
什么情况下用: 当安装文档要求先确认 Node.js，或者你不确定这台机器是否已经装过 Node.js 时使用。
执行后会发生什么: 终端会输出类似 `v20.x` 的版本号；如果没装，会提示找不到这个命令。
注意事项: 安全。它只读取本机环境信息，不会修改任何内容。

本地安装 Windows 安装

查看详情页

安全

检查 npm 能不能正常用

显示 npm 版本，确认安装 OpenClaw 需要的包管理器已经可用。

npm -v

安装与首次启动MacLinuxWindows

这条命令是做什么的: 显示 npm 版本，确认安装 OpenClaw 需要的包管理器已经可用。
什么情况下用: 在执行全局安装前使用，或者当 npm 相关命令报错时，用它先确认工具是否存在。
执行后会发生什么: 终端会输出 npm 版本号；如果 npm 不可用，则会直接报错。
注意事项: 安全。它只检查本机工具状态，不会修改系统。

本地安装 Windows 安装

查看详情页

谨慎

清理旧版全局包名称，再重新安装

卸载旧的 OpenClaw 包名，避免和当前 CLI 冲突。

npm uninstall -g clawdbot || true
npm uninstall -g moltbot || true
npm uninstall -g openclaw || true

安装与首次启动MacLinux

这条命令是做什么的: 卸载旧的 OpenClaw 包名，避免和当前 CLI 冲突。
什么情况下用: 当你准备重装 OpenClaw、发现命令名混乱，或者文档明确要求先清理旧包别名时使用。
执行后会发生什么: npm 会依次尝试删除这些全局包；如果某个包本来就不存在，`|| true` 会让流程继续往下走。
注意事项: 谨慎。它会从这台机器上移除全局 CLI 包，只适合在你明确要清理旧环境时执行。

本地安装 Windows 安装

查看详情页

谨慎

全局安装最新的 OpenClaw CLI

下载最新支持版本的 OpenClaw 命令行工具，并让整台机器都能调用。

npm i -g openclaw@latest

安装与首次启动MacLinuxWindows

这条命令是做什么的: 下载最新支持版本的 OpenClaw 命令行工具，并让整台机器都能调用。
什么情况下用: 第一次安装、清理旧版本后重装，或者文档要求你更新本地 CLI 时使用。
执行后会发生什么: npm 会安装或更新全局 `openclaw` 包。完成后，你应该能在终端里直接运行 `openclaw`。
注意事项: 谨慎。它会修改这台机器上的全局 CLI。如果你当前运行的是 Docker 或 VPS 方案，不要直接套用这条本地更新命令。

本地安装 Windows 安装

查看详情页

安全

确认 OpenClaw 是否安装成功

显示当前 OpenClaw CLI 的版本号，确认命令已经可以使用。

openclaw --version

安装与首次启动MacLinuxWindows

这条命令是做什么的: 显示当前 OpenClaw CLI 的版本号，确认命令已经可以使用。
什么情况下用: 适合在安装或更新后立刻执行，或者终端提示找不到 OpenClaw 时，用来快速确认是否已经装好。
执行后会发生什么: 终端会显示当前安装的版本号；如果命令仍然不在 PATH 中，就会直接报错。
注意事项: 安全。它只读取版本信息，不会改动文件或服务。

本地安装 Windows 安装

查看详情页

谨慎

启动适合新手的 onboarding 流程

打开 OpenClaw 的快速引导，帮助你完成第一次配置。

openclaw onboard --flow quickstart

安装与首次启动MacLinuxWindows

这条命令是做什么的: 打开 OpenClaw 的快速引导，帮助你完成第一次配置。
什么情况下用: 当 CLI 已经装好，并且你准备开始连接第一个工作环境、账号或本地运行设置时使用。
执行后会发生什么: OpenClaw 会进入 onboarding 流程，并逐步提示你完成后续配置。
注意事项: 谨慎。它会创建或更新这台机器上的 OpenClaw 本地配置状态，只有在你准备开始配置时再执行。

本地安装 Windows 安装

查看详情页

update

更新与重启

谨慎

正常重启 OpenClaw gateway

重启 gateway 服务，让新的配置或通道改动生效。

openclaw gateway restart

更新与重启MacLinuxWindowsVPS

这条命令是做什么的: 重启 gateway 服务，让新的配置或通道改动生效。
什么情况下用: 当你修改了通道配置、token、代理或本地设置，并且需要 gateway 重新加载时使用。
执行后会发生什么: gateway 进程会先停一下再重新启动，原来内存里的会话可能会在重启过程中重新连接。
注意事项: 谨慎。它会短暂中断 gateway，因此不要在你不接受短时中断的时刻随手执行。

本地安装 Telegram 接入 WhatsApp 接入飞书 / Lark Docker / VPS 部署

查看详情页

谨慎

用兼容写法重启 OpenClaw

先尝试新版 gateway 重启命令，失败时再回退到旧版重启命令。

openclaw gateway restart || openclaw restart

更新与重启MacLinuxVPS

这条命令是做什么的: 先尝试新版 gateway 重启命令，失败时再回退到旧版重启命令。
什么情况下用: 当教程需要兼容多个 OpenClaw 版本，或者你不确定当前 CLI 支持哪种重启子命令时使用。
执行后会发生什么: 终端会先执行 `openclaw gateway restart`；如果这条命令失败，就立刻继续执行 `openclaw restart`。
注意事项: 谨慎。它本质上仍然会重启服务，而且 `||` 更适合 shell 环境，通常用于 macOS、Linux 或 VPS。

本地安装高级配置 Docker / VPS 部署

查看详情页

谨慎

更新本地 CLI 后立刻重启

先安装最新 OpenClaw CLI，再马上重启 gateway，让新版本立即开始生效。

npm i -g openclaw@latest
openclaw gateway restart || openclaw restart

更新与重启MacLinux

这条命令是做什么的: 先安装最新 OpenClaw CLI，再马上重启 gateway，让新版本立即开始生效。
什么情况下用: 当你使用的是本地安装方案，并且希望更新完成后立刻让新 CLI 版本生效时使用。
执行后会发生什么: npm 会先更新全局包，然后用兼容写法重启 OpenClaw gateway。
注意事项: 谨慎。它既会改动安装版本，也会重启服务，不适合直接套到 Docker 或 VPS 的升级流程里。

本地安装高级配置

查看详情页

谨慎

重启 gateway，并打印更多细节

用更详细的模式重启 gateway，方便你观察启动时到底加载了什么。

openclaw gateway restart --verbose

更新与重启MacLinuxWindowsVPS

这条命令是做什么的: 用更详细的模式重启 gateway，方便你观察启动时到底加载了什么。
什么情况下用: 当普通重启不足以判断问题，或者你想确认配置、插件、通道改动是否真的被加载时使用。
执行后会发生什么: gateway 会重新启动，并在终端里输出比普通重启更多的启动信息。
注意事项: 谨慎。它仍然会重启 gateway，而且详细输出会在屏幕上显示更多本地诊断信息。

高级配置排错指南

查看详情页

高级

使用旧版详细重启命令

用旧的顶层重启写法执行 OpenClaw 重启，并显示详细输出。

openclaw restart --verbose

更新与重启MacLinuxVPS

这条命令是做什么的: 用旧的顶层重启写法执行 OpenClaw 重启，并显示详细输出。
什么情况下用: 只有当文档或你当前的 OpenClaw 版本仍然要求使用旧版 `openclaw restart` 写法时才建议用它。
执行后会发生什么: OpenClaw 会重新启动，并在恢复过程中打印详细诊断信息。
注意事项: 高级。它主要用于版本兼容和排障。对大多数新用户来说，能用新版 gateway 重启时就不要优先选它。

高级配置排错指南

查看详情页

logs

日志与排障

安全

查看最近 100 行 OpenClaw 日志

只看最新一小段日志，方便快速定位错误，不用翻很长的旧输出。

openclaw logs | tail -n 100

日志与排障MacLinuxVPS

这条命令是做什么的: 只看最新一小段日志，方便快速定位错误，不用翻很长的旧输出。
什么情况下用: 当 OpenClaw 异常、重启后想确认状态，或者刚改完插件与配置，想先看最近日志时使用。
执行后会发生什么: 终端会输出 `openclaw logs` 的最新 100 行，然后结束。
注意事项: 安全。它是只读操作，但日志里可能包含本地路径或其他诊断信息，注意屏幕共享场景。

高级配置排错指南

查看详情页

安全

筛出飞书 webhook 相关日志

从 OpenClaw 日志里筛出和飞书、webhook、回调事件相关的输出。

openclaw logs | grep -i -E "feishu|webhook|event|callback" || true

日志与排障MacLinuxVPS

这条命令是做什么的: 从 OpenClaw 日志里筛出和飞书、webhook、回调事件相关的输出。
什么情况下用: 当飞书消息收不到、webhook 校验失败，或者你想确认回调是否真的到达 OpenClaw 时使用。
执行后会发生什么: 终端只会打印匹配到的日志行；如果没有匹配项，`|| true` 会避免把它当成失败命令。
注意事项: 安全。它不会修改系统状态，但筛出来的日志里可能仍然有请求细节，不建议随意截图外发。

飞书 Webhook 内网穿透飞书 / Lark 排错指南

查看详情页

安全

实时跟踪 Docker 里的 gateway 日志

持续输出 gateway 容器日志，方便你边改边看实际发生了什么。

docker compose logs -f openclaw-gateway

日志与排障DockerVPS

这条命令是做什么的: 持续输出 gateway 容器日志，方便你边改边看实际发生了什么。
什么情况下用: 适合 Docker 或 VPS 部署场景下，想实时观察启动错误、运行事件或重连过程时使用。
执行后会发生什么: 终端会持续保持连接，不停打印新的日志，直到你手动按 Ctrl+C 停止。
注意事项: 安全。它是只读操作，但会持续占用当前终端窗口，也可能在屏幕上暴露运行细节。

Docker / VPS 部署排错指南

查看详情页

docker

Docker 与 VPS

高级

安装 Docker，并顺手验证版本

在 Ubuntu 上安装 Docker Engine 和 Docker Compose，然后输出版本确认工具可用。

sudo apt install -y docker.io docker-compose
docker --version
docker-compose --version

Docker 与 VPSDockerVPS

这条命令是做什么的: 在 Ubuntu 上安装 Docker Engine 和 Docker Compose，然后输出版本确认工具可用。
什么情况下用: 适合刚开始准备 VPS，并且要走 Docker 版 OpenClaw 部署流程时使用。
执行后会发生什么: 系统会用 sudo 安装 Docker 相关包，安装成功后终端会输出 Docker 和 Compose 的版本号。
注意事项: 高级。它会修改系统软件包并要求管理员权限，只应在你明确要把这台机器配置成 Docker 环境时执行。

Docker / VPS 部署

查看详情页

高级

把当前用户加入 Docker 组

调整 Linux 权限，让当前账号以后执行 Docker 时不用每次都加 sudo。

sudo usermod -aG docker $USER

Docker 与 VPSDockerVPS

这条命令是做什么的: 调整 Linux 权限，让当前账号以后执行 Docker 时不用每次都加 sudo。
什么情况下用: 当 Docker 命令报权限错误，或者 VPS 文档明确要求你修复当前用户的 Docker 权限时使用。
执行后会发生什么: Linux 会把当前用户追加到 `docker` 用户组。通常需要重新登录一次，这个权限变更才会完全生效。
注意事项: 高级。它会修改这台机器上的账号权限。只有在你清楚谁应该拥有 Docker 控制权时才执行。

Docker / VPS 部署排错指南

查看详情页

高级

给 Docker 初始化脚本加执行权限并运行

先让官方初始化脚本可执行，再真正运行它来搭建 Docker 版 OpenClaw 环境。

chmod +x ./docker-setup.sh
./docker-setup.sh

Docker 与 VPSDockerVPS

这条命令是做什么的: 先让官方初始化脚本可执行，再真正运行它来搭建 Docker 版 OpenClaw 环境。
什么情况下用: 适合你已经下载好官方 `docker-setup.sh`，并且 Docker 本身已经安装完成之后使用。
执行后会发生什么: 第一行会给脚本增加执行权限；第二行会真正执行脚本，通常会创建容器、文件和持久化目录。
注意事项: 高级。你是在执行会改动服务器状态的 shell 脚本。如果你不完全清楚脚本会做什么，建议先读一遍脚本内容。

执行前先确认

已经安装好 Docker 和 Docker Compose。
当前目录里确实存在 `docker-setup.sh` 文件。

Docker / VPS 部署

查看详情页

谨慎

在 CLI 容器里执行 onboarding

不是在宿主机本地跑，而是在 Docker 的 CLI 容器内部启动 OpenClaw 快速引导。

docker compose exec openclaw-cli openclaw onboard --flow quickstart

Docker 与 VPSDockerVPS

这条命令是做什么的: 不是在宿主机本地跑，而是在 Docker 的 CLI 容器内部启动 OpenClaw 快速引导。
什么情况下用: 当 Docker 环境已经启动好，并且你准备在容器化流程里完成首次配置时使用。
执行后会发生什么: Docker 会进入 `openclaw-cli` 容器并执行 onboarding 命令，所以配置会写入当前 Docker 管理的环境里。
注意事项: 谨慎。它会修改 Docker 环境里的 OpenClaw 状态，因此要先确认自己在正确的项目目录和容器栈下操作。

Docker / VPS 部署本地安装

查看详情页

谨慎

重启 Docker 里的 OpenClaw 服务

同时重启当前 Docker 栈中的 gateway 和 CLI 容器。

docker compose restart openclaw-gateway openclaw-cli

Docker 与 VPSDockerVPS

这条命令是做什么的: 同时重启当前 Docker 栈中的 gateway 和 CLI 容器。
什么情况下用: 当你改了环境变量、挂载配置或其他需要容器级别重启才能生效的设置时使用。
执行后会发生什么: Docker 会把指定容器停掉再拉起来，期间会有一小段服务中断时间。
注意事项: 谨慎。它会中断当前运行中的容器，因此不要在你不接受短暂停机的时刻执行。

Docker / VPS 部署排错指南

查看详情页

谨慎

停止当前 Docker 里的 OpenClaw 栈

停止这个 Docker Compose 项目里的 OpenClaw 容器，但不会直接删除它们。

docker compose stop

Docker 与 VPSDockerVPS

这条命令是做什么的: 停止这个 Docker Compose 项目里的 OpenClaw 容器，但不会直接删除它们。
什么情况下用: 当你需要维护窗口、想暂时停掉后台处理，或者要在宿主机上做检查且不希望 OpenClaw 继续运行时使用。
执行后会发生什么: Compose 服务会全部停下来，并保持停止状态，直到你手动再次启动。
注意事项: 谨慎。它会让当前这套 OpenClaw 直接下线，因此只在你明确要停服务时执行。

Docker / VPS 部署排错指南

查看详情页

backup

备份与恢复

安全

快速打包备份 OpenClaw 主目录

把 `~/.openclaw` 目录压缩成一个 `.tar.gz` 备份包，方便你复制保存。

tar -czf openclaw-backup.tar.gz ~/.openclaw

备份与恢复LinuxVPS

这条命令是做什么的: 把 `~/.openclaw` 目录压缩成一个 `.tar.gz` 备份包，方便你复制保存。
什么情况下用: 适合在做高风险配置改动前、迁移到新服务器前，或者你只是想先留一份当前状态快照时使用。
执行后会发生什么: 终端会在当前目录生成 `openclaw-backup.tar.gz` 文件，原来的 `~/.openclaw` 数据不会被删除。
注意事项: 安全。它不会删除源数据，但备份文件可能包含敏感状态信息，保存和传输时要谨慎。

Docker / VPS 部署排错指南

查看详情页