Openclaw(俗称“小龙虾”)是一款轻量化、开源易用的本地AI助手,Windows个人用户通过PowerShell操作,既能实现一键部署、快速启停,也能完成日常管理、故障排查,相比图形界面更灵活、更省资源。

本文所有命令均来自官方文档+实测验证,针对个人用户日常高频场景整理,无冗余指令、无风险操作,新手也能直接复制使用。

如已正常安装使用Openclaw可直接下滑至第六项:个人用户高频命令速查表

  • 重要前提:操作前务必以管理员身份打开PowerShell(Win+X快捷键选择「Windows PowerShell(管理员)」/「终端(管理员)」),避免权限不足导致命令执行失败。

Openclaw小龙虾个人用户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

急救首选

个人用户使用小贴士

  1. 安全提示:仅使用本文提供的官方/镜像命令,不随意执行来源不明的脚本,保护电脑数据安全;
  2. 效率技巧:常用命令可保存为.bat批处理文件,双击即可运行,无需每次手动输入;
  3. 适配建议:个人电脑内存≥8GB即可流畅运行,优先选择轻量AI模型,避免卡顿。

本文持续更新,同步Openclaw官方最新命令迭代,确保个人用户始终能用最稳定、最便捷的方式操作小龙虾AI助手。