OpenClaw的安装包拿到手,不等于OpenClaw真的能跑起来。这是我最近被问得最多的一句话。上一篇指南里我把基础安装流程过了一遍,结果后台留言和各路搜索平台的联想词几乎都在问同一类问题:装完之后怎么配置、怎么装技能、怎么换模型、报错了怎么办。这篇命令速查指南(二)就是专门解决“装完之后”这些事的,我会把环境收尾、工作区管理、技能安装、模型接入、升级排错这些高频场景拆开,每条命令讲清楚为什么这么敲、什么时候用得上。不管你是刚装好的新手,还是已经跑了两三天但被各种小坑卡住的进阶用户,都可以按章节直接查。
1. 从安装到能跑:环境收尾阶段的命令补齐
1.1 安装路径与便携包:PowerShell指定目录的问题
很多人在Windows上用PowerShell安装OpenClaw时会遇到一个很实际的问题:默认装到了C盘用户目录,想指定到D盘或某个自定义目录。我查了网上围绕“powershell安装openclaw 能指定目录吗”的讨论,结论是:取决于你用的安装方式。
如果用的是winget安装,可以通过--location参数指定安装目录,但要注意winget对某些包支持得不好,指定目录后可能在PATH里没有自动加上。如果是通过npm或pip这类包管理器安装,更稳妥的做法是先指定全局安装目录,再安装OpenClaw:
powershell复制# 以npm为例
npm config set prefix "D:\tools\npm-global"
npm install -g openclaw
装完之后立刻做两件事,缺一不可:
powershell复制# 1. 确认命令能被识别
openclaw --version
# 2. 确认完整路径
# Windows
where.exe openclaw
# Linux/macOS
which openclaw
如果where能输出路径但直接敲openclaw报错,那就是PATH环境变量没刷新。在PowerShell里执行$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")重新加载,别傻傻重启电脑。
还有一类人用的是“便携包”方案。社区里确实有把OpenClaw和Python运行时/Node运行时打在一起的便携压缩包,解压就能用。我试用过一个Windows便携包,它的好处是彻底绕开安装权限和PATH问题,适合在未管理员环境下使用。但便携包的更新通常要走官方更新命令,所以拿到便携包后第一件事不是急着跑任务,而是先确认版本:
bash复制openclaw update --channel stable
openclaw --version
这里多说一句,任何便携包都别直接往C盘用户目录塞,解压到D:\openclaw-portable这类独立目录,日志、工作区路径都更可控。
1.2 初始化、登录与版本确认命令
安装完成后,OpenClaw一般需要一次初始化引导。这步会自动生成~/.openclaw目录(Windows是C:\Users\你的用户名\.openclaw),里面放配置、工作区、日志、技能目录。官方文档里的说法是首次运行会自动初始化,但很多人在命令行直接敲openclaw会发现没有任何反应,或者提示需要登录/绑定账号。
比较稳的初始化流程是:
bash复制# 查看当前版本和构建信息
openclaw --version
# 查看主命令帮助,先搞清楚这个版本有哪些子命令
openclaw --help
# 跑一次环境自检(如果有doctor子命令)
openclaw doctor
openclaw doctor是我强烈建议每个新手装上后先跑一次的命令。它会检查配置目录权限、模型API连通性、依赖项版本、Python/Node运行时版本等。我遇到过一台Windows机器,OpenClaw所有命令都正常,但一跑任务就报找不到ffmpeg——这类系统级依赖只有doctor能检测出来。
1.3 彻底卸载时容易漏掉的文件位置
卸载OpenClaw这个事,比安装更容易踩坑。官方安装包或包管理器卸载后,~/.openclaw目录往往被留下,里面有各种配置、审批记录、模型缓存、技能文件,几百MB到几个GB都见过。如果你是想彻底清干净重装,除了正常卸载外还要手动清这几个位置:
bash复制# 配置与日志目录
rm -rf ~/.openclaw
# Linux下如果装了systemd用户服务也用默认路径
rm -rf ~/.config/openclaw
# npm全局安装的残留检查
npm ls -g openclaw
npm uninstall -g openclaw
# pip安装的检查
pip show openclaw
pip uninstall openclaw -y
Windows下的位置大同小异:
powershell复制# 用户目录下的隐藏文件夹
Remove-Item -Recurse -Force "$env:USERPROFILE\.openclaw"
# appdata下的配置
Remove-Item -Recurse -Force "$env:APPDATA\openclaw"
别嫌麻烦,有些配置里存了密钥,不清干净重装后旧配置被新版本读到,很容易出现加密格式不兼容的诡异问题。反正我重装前一定把.openclaw整个目录备份到U盘,然后干净删除。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 工作区与运行时元数据:搞清楚AI到底在哪个文件堆里干活
2.1 workspace:你和AI共用的那张桌子
OpenClaw的workspace是它读写文件的工作目录。我看到有人问我一个问题,说在某人的配置里看到一行workspace: c:\users\administrator\.openclaw\workspace,这是什么意思。说白了,这就是你和AI之间的共享文件夹:你扔进去的文件AI能读,AI生成的文件也放这里。
Windows默认路径通常是C:\Users\<用户名>\.openclaw\workspace,Linux是/root/.openclaw/workspace或~/.openclaw/workspace。这个默认位置其实不太合理,尤其Windows的C盘容易
