Openclaw(俗称“小龙虾”)是一款轻量化、开源易用的本地AI助手,Windows个人用户通过PowerShell操作,既能实现一键部署、快速启停,也能完成日常管理、故障排查,相比图形界面更灵活、更省资源。
本文所有命令均来自官方文档+实测验证,针对个人用户日常高频场景整理,无冗余指令、无风险操作,新手也能直接复制使用。
如已正常安装使用Openclaw可直接下滑至第六项:个人用户高频命令速查表
- 重要前提:操作前务必以管理员身份打开PowerShell(Win+X快捷键选择「Windows PowerShell(管理员)」/「终端(管理员)」),避免权限不足导致命令执行失败。

一、PowerShell前置准备:Openclaw运行基础配置
个人用户首次使用Openclaw,需先完成PowerShell权限与环境配置,这是后续所有命令正常运行的关键,避免出现“脚本无法运行”“命令不识别”等问题。
1. 开启PowerShell脚本执行权限(必做)
Windows默认禁用脚本运行,执行以下命令开启权限,全程无额外手动操作:
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force
执行后无报错即生效,无需重启终端,可直接进行后续安装步骤。
2. 验证PowerShell环境兼容性
检查当前PowerShell版本,Openclaw支持PowerShell 5.1及以上版本,Win10/Win11默认自带,无需额外升级:
$PSVersionTable.PSVersion
二、Openclaw核心基础命令
这类命令覆盖个人用户安装、启动、查看、更新等高频场景,是日常使用Openclaw的核心,建议收藏备用。
1. 一键安装Openclaw(国内镜像+官方双选)
针对国内网络优化,优先使用镜像命令,下载更快、更稳定;网络通畅时可选用官方命令,自动适配Node.js等依赖环境,全程自动化部署。
国内镜像安装(推荐个人用户):
iwr -useb https://clawd.org.cn/install.ps1 | iex
官方原版安装:
iwr -useb https://openclaw.ai/install.ps1 | iex
2. 验证安装是否成功
安装完成后,执行命令查看版本号,出现版本信息即代表安装成功,环境变量自动生效:
openclaw --version
3. 初始化Openclaw(首次使用必做)
生成配置文件、设置数据目录,支持开机自启(个人用户可选关闭,节省开机资源):
openclaw onboard --install-daemon
执行后按回车默认配置即可,无需手动修改路径,数据默认存储在C:\Users\你的用户名\.openclaw目录。
4. 快速启动/停止/重启服务
日常使用中,按需启停Openclaw网关服务,修改配置后必须重启才能生效:
启动网关服务(核心运行命令):
openclaw gateway
停止服务(关机前/暂不使用时):
openclaw stop
重启服务(修改配置/卡顿修复):
openclaw restart
5. 查看运行状态与帮助
查看服务在线状态、端口占用情况(排查无法访问问题):
openclaw status
查看所有可用命令(忘记指令时快速查阅):
openclaw --help
三、个人用户日常管理命令
针对AI模型、配置、插件、日志等日常管理需求,整理极简操作命令,无需复杂参数。
1. AI模型管理(个人用户核心)
Openclaw需绑定AI模型才能使用,个人用户推荐轻量模型,通过PowerShell快速管理:
查看已配置的所有模型:
openclaw models list
切换默认使用的模型(替换尖括号内内容,例:qwen2.5-coder:7b):
openclaw models set <模型名称>
2. 配置文件管理
查看当前完整配置(只读模式,避免误改):
openclaw config
编辑配置文件(手动修改API密钥、模型参数等):
openclaw config edit
3. 插件与技能管理
拓展Openclaw功能,个人用户常用插件(如飞书、文档总结)一键启用/禁用:
查看可用插件列表:
openclaw plugins list
启用指定插件(替换尖括号内插件名):
openclaw plugins enable <插件名>
禁用指定插件:
openclaw plugins disable <插件名>
4. 日志查看与更新
查看运行日志(排查报错、卡顿原因):
openclaw logs
一键更新Openclaw至最新稳定版(修复漏洞、新增功能):
openclaw update
四、故障排查命令
遇到Openclaw无法启动、连接失败、响应卡顿等问题,按以下顺序执行命令,90%以上问题可快速解决。
1. 全面健康检查(首选排查)
自动检测依赖、权限、端口、配置等问题,生成诊断报告:
openclaw doctor
2. 自动修复常见问题
诊断后直接执行修复,无需手动干预:
openclaw doctor --fix
3. 端口占用排查(网关无法启动)
Openclaw默认端口18789.若被占用可执行以下命令查找并关闭占用进程:
netstat -ano | findstr :18789
taskkill /F /PID 进程号
五、卸载命令(谨慎使用)
个人用户不再使用Openclaw时,按顺序执行命令,彻底清理服务与残留文件:
停止网关服务:
openclaw gateway stop
卸载Openclaw工具:
npm uninstall -g openclaw-cn
六、个人用户高频命令速查表
|
使用场景 |
PowerShell命令 |
备注 |
|---|---|---|
|
开启脚本权限 |
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force |
首次必做 |
|
国内镜像安装 |
iwr -useb https://clawd.org.cn/install.ps1 | iex |
推荐 |
|
启动网关服务 |
openclaw gateway |
日常运行 |
|
查看运行状态 |
openclaw status |
排查故障 |
|
重启服务 |
openclaw restart |
改配置后必做 |
|
全面诊断修复 |
openclaw doctor --fix |
急救首选 |
个人用户使用小贴士
- 安全提示:仅使用本文提供的官方/镜像命令,不随意执行来源不明的脚本,保护电脑数据安全;
- 效率技巧:常用命令可保存为.bat批处理文件,双击即可运行,无需每次手动输入;
- 适配建议:个人电脑内存≥8GB即可流畅运行,优先选择轻量AI模型,避免卡顿。
本文持续更新,同步Openclaw官方最新命令迭代,确保个人用户始终能用最稳定、最便捷的方式操作小龙虾AI助手。