Openclaw(俗称“小龙虾”)是一款轻量化、开源易用的本地AI助手，Windows个人用户通过PowerShell操作，既能实现一键部署、快速启停，也能完成日常管理、故障排查，相比图形界面更灵活、更省资源。
本文所有命令均来自官方文档+实测验证，针对个人用户日常高频场景整理，无冗余指令、无风险操作，新手也能直接复制使用。
- 重要前提：操作前务必以管理员身份打开PowerShell(Win+X快捷键选择「Windows PowerShell(管理员)」/「终端(管理员)」)，避免权限不足导致命令执行失败。
个人用户高频命令速查表
|
使用场景 |
PowerShell命令 |
备注 |
|---|---|---|
|
开启脚本权限 |
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force |
首次必做 |
|
国内镜像安装 |
iwr -useb https://clawd.org.cn/install.ps1 | iex |
无网络条件可选 |
|
启动网关服务 |
openclaw gateway start |
日常运行 |
|
查看运行状态 |
openclaw status |
排查故障 |
|
重启服务 |
openclaw gateway restart |
改配置后必做 |
|
全面诊断修复 |
openclaw doctor --fix |
急救首选 |
其他常用命令
OpenClaw 常用命令如下：
| 命令 | 作用 | 备注 / 参数 |
|---|---|---|
openclaw status |
查看 Gateway 状态 | 检查网关是否可达及运行状况 |
openclaw health |
健康检查 | 主要检测 core 运行和依赖情况 |
openclaw doctor |
综合诊断与修复建议 | 可配合 --yes / --non-interactive 自动执行 |
openclaw configure |
交互式配置向导 | 用于设置模型、通道、凭据等 |
openclaw config get <path> |
获取配置值 | 指定路径提取配置 |
openclaw config set <path> <value> |
设置配置项 | 支持 JSON5/raw 文本 |
openclaw config unset <path> |
清除配置项 | 移除单个键值 |
openclaw channels list |
列出已登录通道 | 可观察 WhatsApp/Telegram 等登录状态 |
openclaw channels login |
登录新的通道账号 | 用于扫描/授权链接 |
openclaw skills list |
列出技能 | 查看可用/已安装的技能 |
openclaw skills info <skill> |
技能详情 | 观察某项技能参数或版本 |
openclaw plugins list |
列出插件 | 查看已安装插件 |
openclaw plugins install <id> |
安装插件 | 例如 @openclaw/voice-call |
openclaw plugins enable <id> |
启用插件 | 之后通常需要重启网关 |
openclaw logs --follow |
显示日志 | --json / --plain / --limit 等组合使用 |
openclaw gateway install |
安装系统服务 | 根据平台注册 Gateway 守护进程 |
openclaw gateway start |
启动 Gateway 服务 | 系统服务模式下启动 |
openclaw gateway stop |
停止 Gateway 服务 | 同上 |
openclaw gateway restart |
重启 Gateway 服务 | 适合配置变更后应用 |
openclaw gateway status |
网关系统服务状态 | 不同于 openclaw status，会探测服务单元 |
openclaw uninstall |
卸载 Gateway 服务及数据 | 官方推荐使用 |
openclaw uninstall --all --yes --non-interactive |
全自动卸载 | 包含状态、workspace、插件等 |
openclaw uninstall --state |
删除状态文件 | 不删除 workspace/CLI |
openclaw uninstall --workspace |
删除工作区 | 移除 agent/workspace 文件 |
openclaw uninstall --service |
仅卸载服务 | 不删除数据 |
openclaw uninstall --dry-run |
模拟卸载 | 显示结果但不实际执行 |
一、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 start
停止服务(关机前/暂不使用时)：
openclaw gateway stop
重启服务(修改配置/卡顿修复)：
openclaw gateway restart
5. 查看运行状态与帮助
查看服务在线状态、端口占用情况(排查无法访问问题)：
openclaw gateway 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工具：
openclaw uninstall
个人用户使用小贴士
- 安全提示：仅使用本文提供的官方/镜像命令，不随意执行来源不明的脚本，保护电脑数据安全;
- 效率技巧：常用命令可保存为.bat批处理文件，双击即可运行，无需每次手动输入;
- 适配建议：个人电脑内存≥8GB即可流畅运行，优先选择轻量AI模型，避免卡顿。
本文持续更新，同步Openclaw官方最新命令迭代，确保个人用户始终能用最稳定、最便捷的方式操作小龙虾AI助手。
- 相关信息参考来源：
- OpenClaw官方文档 https://docs.openclaw.ai/zh-CN
- OpenClaw中文镜像社区 https://clawd.org.cn/