Siyang前阵子把 OpenClaw 从本地 Windows 迁到 Linux 服务器时，我被一连串命令折腾得不轻。安装、初始化、模型配置、审批文件迁移、容器日志……每一个环节看起来都有现成的命令，可真到敲命令的时候才发现，资料东一块西一块，关键提示还经常藏在报错信息的最后一行。
所以我把这段时间高频使用的命令整理成了一份速查手册。OpenClaw 本质上是一个命令行优先的智能体运行时，装没装好、跑没跑起来、接了什么渠道、用的哪个模型，几乎都靠命令和配置文件控制。这份手册会从安装初始化讲到日常对话、模型切换、Skill 管理、Active Memory、容器部署和常用报错排查，既能当新手入门路线，也能放在手边当字典查。需要说明的是，OpenClaw 版本迭代很快，命令细节在不同小版本会有差异，遇到不确定的，优先跑 openclaw 子命令 --help，这是最权威的答案。
1. 读懂 OpenClaw 的命令地图，再开始背命令
1.1 为什么 OpenClaw 值得一份命令速查
很多人第一次接触 OpenClaw，是冲着“个人 AI 助理”来的。它和单纯在网页里聊天不一样，OpenClaw 会把对话、工具调用、文件操作、命令审批、渠道接入这些东西全部绑定到一个运行时里。说得直白一点，它更像一个能替你干活的终端管家，而你要做的，就是通过命令行告诉它“用什么模型、按什么策略、允许执行哪些操作”。
也正因为这样，OpenClaw 的命令体系不是一条两条，而是按生命周期铺开的：安装阶段有版本检查和环境自检命令，初始化阶段有 onboard 引导命令，日常使用阶段有交互对话和一次性任务命令，进阶阶段还有 skill 管理、记忆管理、审批迁移等命令。如果没建立一张“命令地图”，你很容易在配置文件、workspace、审批文件这些概念里绕晕。
我的建议是不要零散地记命令，而是把命令分成四层来理解：
- 第一层是安装与自检命令，解决“装没装上、能不能跑”的问题；
- 第二层是初始化与配置命令，解决“用哪个模型、接哪个渠道”的问题；
- 第三层是日常运行命令，解决“怎么和智能体对话、怎么让它干活”的问题；
- 第四层是运维和排障命令，解决“报错了、卡住了、升级之后不兼容”的问题。
这样分层以后，每条命令都有了自己的位置，背起来轻松，遇到问题也知道该往哪个命令去查。
1.2 ~/.openclaw 目录：配置文件、工作区和审批记录都在这
命令虽然很重要，但 OpenClaw 的很多状态并不存在命令参数里，而是落在用户目录下的 .openclaw 文件夹里。无论在 Windows 还是 Linux 上，你都会看到类似这样的结构：
~/.openclaw/openclaw.json或openclaw.yaml：主配置文件，大模型 provider、模型名、平台开关全在这里；~/.openclaw/workspace：智能体工作区，很多文件读写、任务产出都发生在该目录下，热词里出现的c:\users\administrator\.openclaw\workspace就是 Windows 环境的默认路径；~/.openclaw/exec-approvals.json：命令执行审批记录，旧版本升级后会提示迁移；~/.openclaw/skills：skill 相关文件存放目录；~/.openclaw/logs、runtime metadata等状态文件：运行日志和运行时元数据。
为什么要先讲目录结构？因为很多报错根本不是命令敲错了，而是它读的文件不对。比如智能体“假装干活”但没有任何实际操作，八成是审批文件或 skill 目录出了问题；比如换模型后仍然报 unknown model，八成是配置文件的模型字段没有被正确修改。命令只是操作入口，真正决定行为的是命令和文件的配合。这一点在后文的排障部分会反复出现。
1.3 命令入口差异：Windows、Linux 与容器内不一样
OpenClaw 在 Windows 上的常见安装方式是 PowerShell 脚本或 npm 包，在 Linux 上则通过 shell 或容器方式部署。命令本身的动词基本一致，但“如何让命令在终端里可用”就有差异了。
Windows 下最常见的坑，就是开一个全新的 PowerShell 窗口后执行 openclaw，系统提示“无法将 openclaw 项识别为 cmdlet、函数、脚本文件或可运行程序的名称”。这个我在后面第 2 节会专门给排查思路，这里只想点明一个原则：命令入口本质就是可执行文件在不在 PATH 里。npm 全局安装的包，bin 目录默认在 npm 的全局 prefix 下，如果这个目录没加进用户 PATH，就会“命令找不到”。
Linux 和容器内的情况稍微好一点，但也要注意当前用户身份。如果 OpenClaw 装在 root 用户下，切换到普通用户执行命令就找不到配置和命令；如果通过容器部署，则要 docker exec 或 crictl exec 进入容器再执行。遇到问题先花一分钟确认“命令是否在 PATH 中”“配置文件是否在正确用户目录下”，比反复重装高效得多。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 安装与初始化阶段的高频命令，照着敲就行
2.1 检查版本和运行状态
拿到一个新环境，或者升级完 OpenClaw，我建议先跑下面几条命令确认基础状态：
bash复制openclaw --version
openclaw --help
openclaw doctor
--version 会输出版本号，很多排查都要先看版本，因为不同版本的配置字段和命令结构差异很大。doctor 是环境自检命令，会检查配置文件、工作目录、网络连通性和模型配置是否正常。这个命令非常实用，它能把几百字的手动检查压缩成几条提示。
如果提示某个子命令需要单独看参数，我习惯用 openclaw <子命令> --help，比如 openclaw onboard --help。这个用法能帮你在不确定参数名时直接查到当前版本支持什么，不需要去翻网页。
还有一条容易忽略的命令是查看运行时元数据，也就是热词里多次出现的 runtime metadata。这条命令会输出当前运行实例的信息，比如配置文件路径、工作区路径、当前启用的模型等。当你怀疑“它到底读的是哪份配置”时，这条命令是最直接的答案。
2.2 首次初始化 onboard 与环境自检 doctor
新装完 OpenClaw 后，你首先会遇到的是一条交互式引导命令，通