刚装好OpenClaw(小龙虾)是不是被密密麻麻的指令整懵了?别慌!这篇文章把所有常用指令都分类整理好了,从安装、升级到模型管理、监控排查,覆盖日常99%使用场景,还标注了小白必看的避坑要点,跟着做就能快速搞定系统配置,避免踩坑~
一、安装核心指令
| 指令 |
作用 |
适用场景 |
| openclaw install |
安装 OpenClaw(最新版) |
全新安装,默认路径 |
| openclaw install –path /usr/local/openclaw |
指定安装路径 |
需自定义安装目录,避免权限冲突 |
| openclaw install –version 1.0.0 |
安装指定版本 |
需兼容旧模型 / 插件,不使用最新版 |
| openclaw install –source |
从源码安装 |
需自定义编译参数、参与二次开发 |
| openclaw install –docker |
使用 Docker 安装 |
快速部署,隔离环境,新手首选 |
| openclaw verify |
验证安装完整性 |
安装后排查文件缺失、依赖异常 |
| openclaw info |
查看安装详细信息 |
确认安装路径、版本、依赖状态 |
二、升级&版本管理指令
| 指令 |
作用 |
适用场景 |
| openclaw upgrade |
升级到最新版 |
需使用新功能、修复旧版本 bug |
| openclaw upgrade –version 1.1.0 |
升级到指定版本 |
仅兼容特定版本,不盲目跟新 |
| openclaw check-update |
检查是否有可用更新 |
定期巡检,避免版本过旧 |
| openclaw version |
查看当前 OpenClaw 版本 |
确认版本号,排查版本兼容问题 |
| openclaw changelog |
查看更新日志 |
了解版本迭代细节、变更内容 |
三、卸载核心指令
| 指令 |
作用 |
适用场景 |
| openclaw uninstall |
彻底卸载 OpenClaw |
需重装、清理所有数据 |
| openclaw uninstall –keep-config |
卸载但保留配置文件 |
重装后需沿用旧配置 |
| openclaw uninstall –keep-data |
卸载但保留业务数据 |
保留模型、会话、监控数据 |
| openclaw uninstall –keep-all |
卸载但保留配置 + 数据 |
仅重置程序,保留所有用户数据 |
| openclaw uninstall –force |
强制卸载 |
程序异常无法正常卸载时使用 |
四、模型管理指令
1、模型列表指令
| 指令 |
作用 |
适用场景 |
| openclaw models list |
查看所有模型 |
快速浏览已添加的模型列表 |
| openclaw models list –status online |
查看在线模型 |
筛选可连接、可操作的模型 |
| openclaw models list –status offline |
查看离线模型 |
排查连接异常、未启用的模型 |
| openclaw models list –type robotic_arm |
查看指定类型模型 |
仅查看机械臂类模型,精准筛选 |
| openclaw models list –verbose |
查看模型详细信息 |
需了解模型参数、配置详情 |
| openclaw models list –export models.csv |
导出模型列表为 CSV |
批量统计、分析模型数据 |
2、模型详情指令
| 指令 |
作用 |
适用场景 |
| openclaw models show –name ur5e |
查看指定模型详情 |
排查模型配置、状态异常 |
| openclaw models show –name ur5e –show joints |
查看模型关节信息 |
机械臂调试、运动参数配置 |
| openclaw models show –name ur5e –show sensors |
查看模型传感器数据 |
传感器校准、数据异常排查 |
| openclaw models show –name ur5e –show config |
查看模型配置文件 |
编辑配置前先查看当前参数 |
| openclaw models show –name ur5e –show status |
查看模型运行状态 |
快速判断模型是否正常运行 |
| openclaw models show –name ur5e –show logs |
查看模型运行日志 |
定位模型启动、运行报错问题 |
3、添加模型指令
| 指令 |
作用 |
适用场景 |
| openclaw models add –name ur5e –type robotic_arm –manufacturer “Universal Robots” –model “UR5e” –serial_number “UR5E-2024-001” |
手动添加单个模型 |
新增指定型号模型,精准配置参数 |
| openclaw models add –file models.yaml |
从配置文件添加模型 |
批量添加模型,配置复杂参数 |
| openclaw models add –batch models_list.csv |
批量添加模型 |
一次性导入多个模型,高效批量部署 |
| openclaw models add –name ur5e –auto-connect |
添加模型并自动连接 |
新增后直接启用,无需手动操作 |
| openclaw models add –name ur5e –default-params |
添加模型并设置默认参数 |
快速部署,使用官方默认配置 |
4、添加删除指令
| 指令 |
作用 |
适用场景 |
| openclaw models delete –name ur5e |
删除指定模型 |
清理无用模型,精简列表 |
| openclaw models delete –name ur5e –keep-config |
删除模型但保留配置 |
暂不使用,后续可快速恢复 |
| openclaw models delete –name ur5e –keep-data |
删除模型但保留数据 |
保留模型历史数据,仅删除配置 |
| openclaw models delete –batch models_list.csv |
批量删除模型 |
清理多个无用模型,高效操作 |
| openclaw models delete –name ur5e –force |
强制删除模型 |
模型异常无法正常删除时使用 |
5、模型更新指令
| 指令 |
作用 |
适用场景 |
| openclaw models update –name ur5e –config config.yaml |
更新模型配置文件 |
修改模型参数、配置项 |
| openclaw models update –name ur5e –params params.yaml |
更新模型运动参数 |
调整机械臂运动速度、加速度等 |
| openclaw models update –name ur5e –firmware |
更新模型固件 |
修复固件 bug、适配新功能 |
| openclaw models update –name ur5e –driver |
更新模型驱动程序 |
解决驱动兼容、连接异常问题 |
| openclaw models update –batch models_list.csv |
批量更新模型 |
多个模型统一更新配置 / 参数 |
五、模型控制指令
1、启动指令
| 指令 |
作用 |
适用场景 |
| openclaw start |
启动所有模型 |
批量启用所有已添加模型 |
| openclaw start –name ur5e |
启动指定模型 |
单独启用单个模型,精准控制 |
| openclaw start –name ur5e –name panda |
启动多个模型 |
同时启用多个模型,批量操作 |
| openclaw start –auto-connect |
启动并自动连接 |
启动后直接建立设备连接 |
| openclaw start –config config.yaml |
启动并加载指定配置 |
自定义配置启动,灵活适配场景 |
2、停止指令
| 指令 |
作用 |
适用场景 |
| openclaw stop |
停止所有模型 |
批量关闭所有运行中模型 |
| openclaw stop –name ur5e |
停止指定模型 |
单独关闭单个模型,避免误操作 |
| openclaw stop –name ur5e –name panda |
停止多个模型 |
同时关闭多个模型,批量操作 |
| openclaw stop –emergency |
紧急停止所有模型 |
突发情况(如设备碰撞、危险) |
| openclaw stop –save-state |
停止并保存当前状态 |
后续恢复时延续之前的位置 / 参数 |
3、重启指令
| 指令 |
作用 |
适用场景 |
| openclaw restart |
重启所有模型 |
批量重置所有模型运行状态 |
| openclaw restart –name ur5e |
重启指定模型 |
模型运行卡顿、无响应时 |
| openclaw restart –name ur5e –name panda |
重启多个模型 |
多个模型同时异常时批量处理 |
| openclaw restart –config config.yaml |
重启并加载新配置 |
修改配置后生效,无需单独停止 |
| openclaw restart –restore-state |
重启并恢复之前状态 |
延续停止前的位置、参数配置 |
六、运动控制指令
| 指令 |
作用 |
适用场景 |
| openclaw move –name ur5e –joints [0.0, -0.79, 0.0, -2.36, 0.0, 1.57] |
移动到指定关节位置 |
机械臂关节角度调试、精准定位 |
| openclaw move –name ur5e –position [0.5, 0.3, 0.8] –orientation [0.0, 0.0, 0.0, 1.0] |
移动到指定笛卡尔坐标 |
空间位置移动、场景布局调试 |
| openclaw move –name ur5e –velocity 0.5 |
设置运动速度 |
调整机械臂移动快慢,适配安全 / 效率需求 |
| openclaw move –name ur5e –acceleration 0.5 |
设置运动加速度 |
控制运动平稳度,避免急停 / 抖动 |
| openclaw move –name ur5e –trajectory trajectory.csv |
执行预设轨迹 |
批量重复运动、复杂路径规划 |
七、状态控制指令
| 指令 |
作用 |
适用场景 |
| openclaw home –name ur5e |
控制模型回零 |
初始化设备,恢复初始位置 |
| openclaw reset –name ur5e |
复位模型 |
清除异常状态,重置设备参数 |
| openclaw save-position –name ur5e –position-name home |
保存当前位置 |
自定义命名保存,后续快速调用 |
| openclaw load-position –name ur5e –position-name home |
加载保存的位置 |
快速回到预设位置,无需重复调试 |
| openclaw list-positions –name ur5e |
列出所有保存的位置 |
查看已保存的位置点,管理调用 |
八、监控&排查指令
1、系统状态监控
| 指令 |
作用 |
适用场景 |
| openclaw status |
查看系统整体状态 |
快速判断 OpenClaw 运行是否正常 |
| openclaw status –name ur5e |
查看指定模型状态 |
单独排查单个模型运行异常 |
| openclaw status –all |
查看所有模型状态 |
批量巡检所有设备状态 |
| openclaw status –watch |
实时监控系统状态 |
动态查看状态变化,调试时使用 |
| openclaw status –export status.csv |
导出状态数据 |
统计分析状态数据,生成报告 |
2、数据监控指令
| 指令 |
作用 |
适用场景 |
| openclaw monitor –name ur5e –data joints |
查看关节位置数据 |
机械臂运动数据调试、分析 |
| openclaw monitor –name ur5e –data velocities |
查看关节速度数据 |
运动速度异常排查、优化 |
| openclaw monitor –name ur5e –data torques |
查看关节力矩数据 |
负载异常、碰撞检测排查 |
| openclaw monitor –name ur5e –data sensors |
查看传感器实时数据 |
传感器校准、数据异常排查 |
| openclaw monitor –name ur5e –watch |
实时监控数据变化 |
动态查看数据,精准调试 |
| openclaw monitor –name ur5e –export data.csv |
导出监控数据 |
数据分析、问题溯源 |
3、性能监控指令
| 指令 |
作用 |
适用场景 |
| openclaw monitor –performance cpu |
查看 CPU 使用率 |
系统卡顿、性能不足排查 |
| openclaw monitor –performance memory |
查看内存使用率 |
内存溢出、程序崩溃排查 |
| openclaw monitor –performance disk |
查看磁盘使用率 |
存储不足、日志清理排查 |
| openclaw monitor –performance network |
查看网络状态 |
设备连接卡顿、延迟高排查 |
| openclaw monitor –performance load |
查看系统负载 |
高并发场景下性能巡检 |
| openclaw monitor –performance –export performance.csv |
导出性能数据 |
性能优化、容量规划 |
九、日志管理指令
1、日志查看指令
| 指令 |
作用 |
适用场景 |
| openclaw logs |
查看系统整体日志 |
排查 OpenClaw 核心运行问题 |
| openclaw logs –name ur5e |
查看指定模型日志 |
单独排查模型相关报错 |
| openclaw logs –level error |
查看错误级别日志 |
定位严重报错、崩溃问题 |
| openclaw logs –level warn |
查看警告级别日志 |
排查潜在风险、异常提示 |
| openclaw logs –level info |
查看信息级别日志 |
了解系统运行流程、正常操作 |
| openclaw logs –follow |
实时查看日志输出 |
动态监控日志,调试时使用 |
2、日志搜索指令
| 指令 |
作用 |
适用场景 |
| openclaw logs –search “error” |
搜索包含指定关键词的日志 |
快速定位特定报错信息 |
| openclaw logs –start “2024-01-01 00:00:00” –end “2024-01-01 23:59:59” |
搜索指定时间范围的日志 |
追溯特定时间段的问题 |
| openclaw logs –name ur5e –search “error” |
搜索指定模型的错误日志 |
单独排查单个模型的报错 |
| openclaw logs –level error –search “connection” |
搜索指定级别 + 关键词的日志 |
精准定位连接异常相关问题 |
| openclaw logs –export logs.csv |
导出日志文件 |
日志分析、问题反馈 |
3、日志管理指令
| 指令 |
作用 |
适用场景 |
| openclaw logs –clean |
清理所有日志 |
释放磁盘空间,定期维护 |
| openclaw logs –clean –days 7 |
清理 7 天前的日志 |
保留近期日志,清理历史冗余 |
| openclaw logs –compress |
压缩日志文件 |
节省存储空间,便于备份 |
| openclaw logs –archive |
归档日志文件 |
长期保存日志,合规留存 |
| openclaw logs –stats |
查看日志统计信息 |
了解日志数量、级别分布 |
十、配置管理指令
1、配置查看指令
| 指令 |
作用 |
适用场景 |
| openclaw config |
查看配置 |
快速查看系统所有配置的概览 |
| openclaw config –show system |
查看系统配置 |
查看系统级参数配置 |
| openclaw config –show models |
查看模型配置 |
查看所有模型的配置参数 |
| openclaw config –show api |
查看API配置 |
排查API服务异常、接口调用问题 |
| openclaw config –show dashboard |
查看Dashboard配置 |
排查可视化面板异常、访问问题 |
| openclaw config –export config.yaml |
导出配置 |
便于后续恢复、迁移或配置复用 |
2、配置修改命令
| 指令 |
作用 |
适用场景 |
| openclaw config –set system.port=8080 |
修改配置 |
自定义修改指定配置项 |
| openclaw config –load config.yaml |
从文件加载配置 |
快速恢复配置,减少重复设置操作 |
| openclaw config –reset |
重置配置 |
恢复默认配置,快速排查问题 |
| openclaw config –validate |
验证配置 |
修改配置后,验证配置文件的正确性 |
| openclaw config –backup |
备份配置 |
防止配置丢失或误改后无法恢复 |
3、配置管理命令
| 指令 |
作用 |
适用场景 |
| openclaw config –list |
列出配置文件 |
查看所有配置文件的列表 |
| openclaw config –diff config1.yaml config2.yaml |
比较配置 |
快速定位配置修改点 |
| openclaw config –merge config1.yaml config2.yaml |
合并配置 |
整合不同配置项,提高配置效率 |
| openclaw config –restore backup.yaml |
恢复配置 |
通过备份文件恢复到之前的正常配置 |
| openclaw config –sync |
同步配置 |
,同步配置文件,保证配置一致性 |
十一、系统命令
1、服务管理命令
| 指令 |
作用 |
适用场景 |
| openclaw service start |
启动服务 |
启动OpenClaw相关服务 |
| openclaw service stop |
停止服务 |
维护、升级或无需使用时 |
| openclaw service restart |
重启服务 |
服务异常、卡顿或配置修改后 |
| openclaw service status |
查看服务状态 |
快速查看服务运行状态 |
| openclaw service logs |
查看服务日志 |
查看日志定位报错原因 |
| openclaw service enable |
启用开机自启 |
希望系统开机后自动启动 |
| openclaw service disable |
禁用开机自启 |
不需要系统开机自动启动服务 |
2、系统信息命令
| 指令 |
作用 |
适用场景 |
| openclaw system info |
查看系统信息 |
用于系统排查和维护 |
| openclaw system version |
查看版本信息 |
确认当前系统版本 |
| openclaw system dependencies |
查看依赖信息 |
排查依赖缺失导致的异常 |
| openclaw system environment |
查看环境信息 |
查看系统运行环境参数 |
| openclaw system network |
查看网络信息 |
查看系统网络配置、连接状态 |
| openclaw system storage |
查看存储信息 |
查看系统存储使用情况 |
3、系统维护命令
| 指令 |
作用 |
适用场景 |
| openclaw system clean –cache |
清理缓存 |
释放存储空间、提升运行速度 |
| openclaw system clean –logs |
清理日志 |
释放磁盘空间 |
| openclaw system clean –temp |
清理临时文件 |
清理系统运行中产生的临时文件 |
| openclaw system clean –all |
清理所有 |
批量清理缓存、日志、临时文件 |
| openclaw system optimize –database |
优化数据库 |
提升数据读写速度,避免数据库卡顿 |
| openclaw system optimize –storage |
优化存储 |
提升存储读写效率,合理分配存储资源 |
| openclaw system diagnose |
系统诊断 |
全面诊断系统运行状态 |
| openclaw system check |
系统检查 |
检查系统组件、配置、依赖等是否正常 |
十二、API命令
1、API服务命令
| 指令 |
作用 |
适用场景 |
| openclaw api start |
启动API服务 |
需要通过API接口调用OpenClaw功能时 |
| openclaw api stop |
停止API服务 |
无需使用API接口时 |
| openclaw api restart |
重启API服务 |
API服务异常、卡顿或配置修改后 |
| openclaw api status |
查看API服务状态 |
快速查看API服务运行状态 |
| openclaw api logs |
查看API服务日志 |
API接口调用异常时 |
| openclaw api docs |
查看API文档 |
开发、调用API接口时 |
| openclaw api test |
测试API |
API服务启动后 |
2、API管理命令
| 指令 |
作用 |
适用场景 |
| openclaw api keys –list |
查看API密钥 |
查看所有已创建的API密钥,便于管理和权限控制 |
| openclaw api keys –generate |
生成API密钥 |
新增API调用权限,为不同用户或应用生成独立API密钥 |
| openclaw api keys –delete key_id |
删除API密钥 |
撤销指定API密钥的调用权限,保障API接口安全 |
| openclaw api stats |
查看API统计 |
查看API调用次数、频率等统计信息,分析API使用情况 |
| openclaw api logs |
查看API日志 |
查看API调用日志,定位调用异常、权限问题等 |
| openclaw api keys –reset |
重置API密钥 |
API密钥泄露或权限异常时,重置密钥,保障接口安全 |
十三、Dashboard命令
1、Dashboard服务命令
| 指令 |
作用 |
适用场景 |
| openclaw dashboard start |
启动Dashboard服务 |
需要通过可视化面板管理OpenClaw时,启动Dashboard服务 |
| openclaw dashboard stop |
停止Dashboard服务 |
无需使用可视化面板时,停止服务,释放系统资源 |
| openclaw dashboard restart |
重启Dashboard服务 |
Dashboard面板异常、卡顿或配置修改后,重启服务恢复正常 |
| openclaw dashboard status |
查看Dashboard服务状态 |
快速查看Dashboard服务运行状态,排查面板无法访问问题 |
| openclaw dashboard logs |
查看Dashboard服务日志 |
Dashboard面板异常时,查看日志定位报错原因,进行排查 |
| openclaw dashboard open |
访问Dashboard |
快速打开Dashboard可视化面板,方便进行系统管理操作 |
2、Dashboard管理命令
| 指令 |
作用 |
适用场景 |
| openclaw dashboard user –list |
查看用户列表 |
查看所有Dashboard用户,便于用户管理和权限分配 |
| openclaw dashboard user –add –username newuser –password password –role operator |
添加用户 |
新增Dashboard用户,并分配对应角色(如操作员),控制访问权限 |
| openclaw dashboard user –delete –username newuser |
删除用户 |
删除无用或权限异常的Dashboard用户,保障面板安全 |
| openclaw dashboard user –update –username newuser –password newpassword |
修改用户密码 |
用户密码泄露或需要定期更换时,修改Dashboard用户密码 |
| openclaw dashboard stats |
查看Dashboard统计 |
查看Dashboard使用统计、系统运行数据等,便于管理分析 |
十四、快捷操作命令
| 指令 |
作用 |
适用场景 |
| openclaw quick start |
快速启动 |
快速启动所有相关服务和模型,简化启动操作流程 |
| openclaw quick stop |
快速停止 |
快速停止所有相关服务和模型,无需逐一操作 |
| openclaw quick restart |
快速重启 |
快速重启所有相关服务和模型,提升操作效率 |
| openclaw quick status |
快速查看状态 |
快速查看系统、服务、模型的整体状态,无需复杂指令 |
| openclaw quick logs |
快速查看日志 |
快速查看关键日志信息,快速排查简单异常 |
| openclaw quick config |
快速配置 |
快速进入配置界面或加载默认配置,简化配置操作 |
(QQ扫码加入OpenClaw小龙虾交流群)
(微信扫码加入OpenClaw小龙虾交流群)
立即加入腾讯频道【OpenClaw小龙虾交流群】:点击直达频道