最近一直在学习小龙虾,在OpenClaw中,关于龙虾的命令,有一套很清晰的逻辑:openclaw <名词> [子命令] [参数]。
名词就是可用的功能模块——models、channels、skills、hooks、agents、plugins、sessions。
只有少数核心命令用单数:gateway、doctor、config。记住这个规律,基本上就能靠猜猜出大部分命令。
任何命令后面加 --help 或 -h,都能看到该命令的完整说明,这是最好的随身文档。风云总结了小龙虾常用功能的速查手册,复制粘贴即可使用,方便大家收藏查阅:
核心常用命令
1.系统管理类
openclaw gateway start 启动 Gateway(默认端口 18789)
openclaw gateway restart 网关重启,常用于让龙虾配置生效
openclaw --help 查看龙虾所有命令
openclaw status - 查看通道健康状态和最近会话
openclaw doctor - 系统诊断和快速修复
openclaw health - 获取运行中网关的健康状态
openclaw logs - 通过RPC查看网关文件日志
2.配置管理类
openclaw configure - 交互式设置向导(凭证、通道、网关、代理默认值)
openclaw config - 非交互式配置助手(get/set/unset/file/validate)
openclaw setup - 初始化本地配置和代理工作区
openclaw onboard - 打开龙虾配置页面,交互式入门向导(网关、工作区、技能)
openclaw dashboard 打开龙虾控制面板
openclaw config get 查看龙虾所有配置
openclaw config get --section XX 查看龙虾指定配置
openclaw logs --lines 50 查看最近 50 行日志,打开小龙虾日志,调试Bug必要的
openclaw config get --section models 查看特定部分配置
openclaw config unset models. fast 删除特定配置项
openclaw config set models.default mistral:mixtral-8x7b 设置默认模型
openclaw config unset models 重置某个节点
3.代理和会话管理
openclaw agents - 管理隔离代理(工作区、认证、路由)
openclaw sessions - 查看龙虾所有的会话,列出存储的对话会话
openclaw agent - 通过网关运行单次代理操作
openclaw message - 发送、读取和管理消息
4.自动化调度
openclaw cron - 管理网关调度器的定时任务
openclaw system - 系统事件、心跳和存在状态
5、技能管理
openclaw skills search XX 搜索龙虾 XX 技能(技能是 OpenClaw 的能力扩展单元)
openclaw skills list 查看小龙虾安装的所有技能包
openclaw channels show XX 展示龙虾特定频道(频道是 OpenClaw 连接外部通讯平台的接口,支持飞书、企微、QQ、Telegram、Slack、Discord、WhatsApp等)
openclaw skills install XX 安装龙虾 XX 技能
openclaw skills show XX 查看龙虾 XX 技能详情
openclaw skills install XX 安装技能XX
openclaw skills uninstall XX 卸载技能XX
openclaw skills update 更新技能
实用命令示例
发送消息到当前会话
openclaw message send --message "你好"
发送到群组
openclaw message send --channel telegram --target @mychat --message "测试消息"
登录WhatsApp Web
openclaw channels login --verbose
管理连接的聊天通道
openclaw channels *
列出可用技能
openclaw skills list
查看特定技能详情
openclaw skills info healthcheck
发现和配置模型
openclaw models discover
openclaw models config
# 添加定时任务
openclaw cron add --job '{"name":"daily-check","schedule":{"kind":"cron","expr":"0 8 *"},"payload":{"kind":"systemEvent","text":"早上好!"},"sessionTarget":"main"}'
启动网关服务
openclaw gateway start
强制启动(杀死占用端口的进程)
openclaw gateway --force
开发者模式(隔离状态)
openclaw --dev gateway
命令本身不难,难的是知道什么时候该用哪个。建议把这份手册存起来,遇到问题先查这里,再配合 openclaw <命令> --help 看细节参数。大多数情况下,openclaw doctor 能帮你定位 90% 的问题所在。