OpenClaw指令分类详解与使用指南

发布时间：2026-05-11 14:58:29 作者：LoserChaser

OpenClaw提供丰富命令行工具,分为CLI和聊天斜杠命令两大类,涵盖系统、配置管理、网关服务、模型管理、渠道管理、技能管理、消息与对话管理等多方面功能,本文总结了OpenClaw的命令使用频率统计、实用技巧及最佳实践,并提供配置管理、定时任务等高级功能介绍

一、基础与安装命令

1.1 版本与环境

命令	功能	示例
`openclaw --version` / `-V`	查看当前版本	`openclaw --version`
`openclaw --help` / `-h`	显示所有命令帮助	`openclaw --help`
`openclaw tui`	启动终端交互界面	`openclaw tui`
`openclaw dashboard`	打开网页管理控制台	`openclaw dashboard`

1.2 安装与初始化

命令	功能	说明
`openclaw setup`	初始化配置和工作区	首次安装后必须执行
`openclaw onboard`	交互式引导流程	依次配置Gateway、工作区、Skills
`openclaw configure`	交互式配置向导	修改模型、频道、技能等核心配置
`openclaw update`	更新CLI到最新版本	`openclaw update --channel stable`
`openclaw uninstall`	卸载Gateway服务和相关数据	`openclaw uninstall --all --yes`

1.3 全局选项

选项	功能	说明
`--dev`	开发模式	独立配置+端口18790
`--profile <name>`	多配置文件隔离	工作/个人环境分开
`--log-level <level>`	设置日志级别	silent/fatal/error/warn/info/debug/trace
`--no-color`	禁用彩色输出	脚本中使用
`--json`	JSON格式输出	机器可读格式

二、配置管理命令

2.1 配置读写

命令	功能	示例
`openclaw config get <path>`	读取指定配置值	`openclaw config get gateway.port`
`openclaw config set <path> <value>`	设置配置值	`openclaw config set gateway.port 18789`
`openclaw config unset <path>`	删除配置项	`openclaw config unset channels.telegram`
`openclaw config file`	显示配置文件路径	`openclaw config file`
`openclaw config validate`	校验配置文件有效性	`openclaw config validate`

2.2 常用配置路径

# 设置网关模式
openclaw config set gateway.mode local
# 设置绑定模式
openclaw config set gateway.bind loopback
# 设置API密钥
openclaw config set providers.anthropic.apiKey "sk-ant-xxxxx"
# 禁用记忆搜索
openclaw config set agents.defaults.memorySearch.enabled false

三、网关服务命令

3.1 生命周期管理

命令	功能	说明
`openclaw gateway` / `openclaw gateway run`	前台运行Gateway	常搭配screen或tmux使用
`openclaw gateway start`	后台启动Gateway服务	系统服务方式运行
`openclaw gateway stop`	停止Gateway服务	临时暂停或维护
`openclaw gateway restart`	重启Gateway服务	修改配置后最常用
`openclaw gateway status`	探测Gateway RPC状态	检查服务是否存活

3.2 服务安装

命令	功能	说明
`openclaw gateway install`	安装为系统服务	systemd/launchd等
`openclaw gateway uninstall`	卸载系统服务	彻底移除服务

3.3 调试与发现

命令	功能	示例
`openclaw gateway call <method>`	调用指定RPC方法	`openclaw gateway call health`
`openclaw gateway probe`	探测Gateway	调试连接问题时使用
`openclaw gateway discover`	发现局域网中的Gateway实例	多实例环境使用

3.4 网关选项

# 指定端口启动
openclaw gateway --port 18789

# 强制杀掉占用端口并启动
openclaw gateway --force

# 详细日志输出
openclaw gateway --verbose

# 设置命令超时时间
openclaw gateway --timeout 30000

# 绑定模式设置
openclaw gateway --bind loopback  # 仅本地
openclaw gateway --bind lan       # 局域网
openclaw gateway --bind tailnet   # Tailscale网络

四、模型管理命令

4.1 基本操作

命令	功能	示例
`openclaw models list`	列出所有可用模型	`openclaw models list`
`openclaw models status`	模型状态概览	`openclaw models status`
`openclaw models status --probe`	带探测的模型状态检查	深度检查模型可用性
`openclaw models set <name>`	设置默认模型	`openclaw models set glm-4.7-flash`
`openclaw models set-image <name>`	设置图片生成模型	`openclaw models set-image dalle-3`

4.2 别名管理

命令	功能	示例
`openclaw models aliases list`	列出模型别名	`openclaw models aliases list`
`openclaw models aliases add <alias> <model>`	添加模型别名	`openclaw models aliases add gpt gpt-4`
`openclaw models aliases remove <alias>`	移除模型别名	`openclaw models aliases remove gpt`

4.3 回退模型

命令	功能	说明
`openclaw models fallbacks list`	列出回退模型列表	主模型不可用时使用
`openclaw models fallbacks add <model>`	添加回退模型	`openclaw models fallbacks add glm-4.7`
`openclaw models fallbacks remove <model>`	移除回退模型	清理不需要的回退模型
`openclaw models fallbacks clear`	清空回退模型列表	重置回退配置

4.4 认证管理

命令	功能	说明
`openclaw models auth add`	添加模型认证	配置API密钥
`openclaw models auth setup-token`	交互式设置API token	推荐使用OAuth流程
`openclaw models auth paste-token`	直接粘贴API token	快速配置
`openclaw models auth order get`	查看认证提供商顺序	优先级排序
`openclaw models auth order set`	设置认证提供商顺序	调整认证优先级

五、渠道管理命令

5.1 渠道操作

命令	功能	示例
`openclaw channels list`	显示所有已配置频道	`openclaw channels list`
`openclaw channels status`	检查频道健康状态	`openclaw channels status`
`openclaw channels status --probe`	带深度探测的频道状态检查	详细诊断
`openclaw channels add`	向导式添加新频道	`openclaw channels add`
`openclaw channels login`	交互式登录	WhatsApp扫码登录
`openclaw channels login --channel <name>`	登录指定频道	`openclaw channels login --channel whatsapp`
`openclaw channels logout`	登出频道	断开连接
`openclaw channels remove`	禁用并移除频道	`openclaw channels remove --channel telegram`

5.2 渠道添加示例

# Telegram
openclaw channels add --channel telegram --token "BOT_TOKEN"

# Discord
openclaw channels add --channel discord --token "BOT_TOKEN"

# WhatsApp（扫码登录）
openclaw channels login --channel whatsapp

# 飞书
openclaw channels add --channel feishu --app-id "APP_ID" --app-secret "APP_SECRET"

六、技能与插件命令

6.1 技能管理

命令	功能	示例
`openclaw skills list`	列出所有已加载技能	`openclaw skills list`
`openclaw skills info <name>`	查看指定技能详细信息	`openclaw skills info browser`
`openclaw skills check`	就绪/缺失状态摘要	检查技能依赖
`openclaw skills install <name>`	安装新技能	`openclaw skills install browser`
`openclaw skills enable <name>`	启用技能	`openclaw skills enable browser`
`openclaw skills disable <name>`	禁用技能	`openclaw skills disable browser`

6.2 插件管理

命令	功能	示例
`openclaw plugins list`	发现并列出所有插件	`openclaw plugins list`
`openclaw plugins info <name>`	查看插件详细信息	`openclaw plugins info feishu`
`openclaw plugins install <name>`	安装插件	支持本地路径、tgz或npm包名
`openclaw plugins enable <name>`	启用插件	`openclaw plugins enable feishu`
`openclaw plugins disable <name>`	禁用插件	`openclaw plugins disable feishu`
`openclaw plugins doctor`	插件加载错误诊断报告	排查插件问题

6.3 ClawHub社区技能

# 搜索技能
clawhub search "weather"

# 安装技能
clawhub install weather

# 同步所有技能
clawhub sync --all

# 列出已安装技能
clawhub list

七、消息与会话命令

7.1 消息操作

命令	功能	示例
`openclaw message send`	发送消息	`openclaw message send --target +15555550123 --message "Hi"`
`openclaw message edit`	编辑已发送的消息	`openclaw message edit --message-id 123 --message "Updated"`
`openclaw message delete`	删除消息	`openclaw message delete --message-id 123`
`openclaw message poll`	创建投票	`openclaw message poll --question "Snack?" --option Pizza --option Sushi`
`openclaw message react`	添加/移除反应	`openclaw message react --emoji "✅"`
`openclaw message broadcast`	广播消息到多个目标	群发消息

7.2 会话管理

命令	功能	示例
`openclaw sessions list`	列出所有会话	`openclaw sessions list`
`openclaw sessions history`	查看会话历史	`openclaw sessions history <session-key>`
`openclaw memory`	管理记忆	`openclaw memory search "会议记录"`
`openclaw memory index`	重建向量索引	修复记忆索引错误

7.3 Agent管理

命令	功能	示例
`openclaw agents list`	列出所有已配置的agents	`openclaw agents list`
`openclaw agents add [name]`	通过向导添加新agent	`openclaw agents add assistant`
`openclaw agents delete <name>`	删除指定agent	`openclaw agents delete old-assistant`
`openclaw agents bindings`	列出所有路由绑定	查看agent与渠道的绑定关系
`openclaw agents bind`	添加路由绑定	将agent绑定到频道/群组
`openclaw agents unbind`	移除路由绑定	解除绑定关系

八、诊断与维护命令

8.1 健康检查

命令	功能	说明
`openclaw doctor`	最有用的单条命令	全面健康检查并提供快速修复建议
`openclaw doctor --fix`	自动修复常见问题	自动修正配置文件权限等
`openclaw doctor --deep`	深度诊断	复杂故障排查
`openclaw health`	获取运行中Gateway的健康状态	快速确认核心组件状态
`openclaw status`	显示会话健康状态和最近接收者	整体运行状态概览

8.2 日志管理

命令	功能	示例
`openclaw logs`	查看Gateway日志	`openclaw logs`
`openclaw logs --follow`	实时查看运行日志	类似 `tail -f`
`openclaw logs --filter error`	仅查看错误日志	快速定位故障
`openclaw logs --start "2026-03-13"`	指定开始时间	时间范围查询
`openclaw logs --search "error"`	关键词过滤	搜索特定内容

8.3 系统管理

命令	功能	示例
`openclaw system event --text <msg>`	向系统事件队列入队一条事件	测试事件系统
`openclaw system heartbeat last`	查看上次心跳时间	检查定时任务
`openclaw system heartbeat enable`	启用心跳	开启定时任务
`openclaw system heartbeat disable`	禁用心跳	关闭定时任务
`openclaw system presence`	列出系统在线状态	查看连接状态

8.4 安全与备份

命令	功能	说明
`openclaw security audit`	安全审计	检查安全配置
`openclaw security audit --deep`	深度安全审计	全面安全检查
`openclaw secrets reload`	刷新敏感密钥	重新加载密钥
`openclaw backup create`	创建系统备份	备份配置和数据
`openclaw reset`	重置系统状态	谨慎使用，保留CLI
`openclaw uninstall --all --yes`	彻底卸载	清理所有数据

九、聊天斜杠命令（Slash Commands）

9.1 会话管理

命令	功能	说明
`/new`	开启新会话线程	清空上下文，节省token
`/new <描述>`	带目标启动新会话	指定会话目标
`/reset`	重置当前会话	同 `/new`
`/status`	查看当前会话状态	包括模型、上下文、队列等信息
`/compact`	压缩上下文	释放上下文窗口空间
`/history`	查看会话历史记录	浏览对话历史
`/pause`	暂停当前任务	临时停止AI执行

9.2 模型控制

命令	功能	示例
`/model <名称>`	切换模型	`/model glm-4.7-flash`
`/reasoning`	开启/关闭深度推理模式	`/reasoning on`
`/reasoning <级别>`	调整推理级别	`/reasoning high`
`/think <级别>`	设置思考级别	`/think medium`
`/verbose on/off`	开启/关闭详细输出	`/verbose on`

9.3 技能与工具

命令	功能	示例
`/skills`	查看已安装技能	列出所有可用技能
`/skill <name> [input]`	直接运行技能	`/skill weather 北京`
`/agents`	查看可用Agent	列出所有Agent
`/memory`	查看或管理AI的记忆	查询AI记住的信息
`/forget`	忘记特定信息	清除记忆

9.4 操作控制

命令	功能	说明
`/stop`	中止当前正在运行的任务	紧急停止
`/approve`	批准配对请求	允许新联系人
`/deny`	拒绝配对请求	拒绝新联系人
`/cancel`	取消当前操作	取消正在执行的任务
`/undo`	撤销上一步操作	回退操作

9.5 信息查询

命令	功能	说明
`/help`	显示帮助信息	列出可用命令列表
`/commands`	查看所有命令	同 `/help`
`/cost`	查看使用费用	查询API调用成本
`/version`	查看版本信息	显示OpenClaw版本
`/ping`	测试连接状态	检查服务是否正常
`/deliver`	交付当前任务结果	完成并输出结果

十、高级与扩展命令

10.1 定时任务

命令	功能	示例
`openclaw cron list`	查看定时任务	`openclaw cron list`
`openclaw cron add`	添加定时任务	`openclaw cron add "0 9 * * *" "check_disk"`
`openclaw cron edit <id>`	编辑定时任务	修改任务配置
`openclaw cron rm <id>`	删除定时任务	移除指定任务
`openclaw cron run <id>`	立即执行定时任务	手动触发任务

10.2 浏览器控制

命令	功能	示例
`openclaw browser start`	启动浏览器	开启浏览器实例
`openclaw browser open <url>`	打开网页	`openclaw browser open https://example.com`
`openclaw browser click <selector>`	点击元素	`openclaw browser click "#login"`
`openclaw browser type <selector> <text>`	输入文本	`openclaw browser type "#username" "admin"`
`openclaw browser screenshot`	截图	保存当前页面截图

10.3 节点管理

命令	功能	说明
`openclaw node run`	前台运行headless node host	调试模式
`openclaw node start`	启动node host服务	后台运行
`openclaw node stop`	停止node host服务	关闭节点
`openclaw node restart`	重启node host服务	重新启动
`openclaw node status`	显示node host状态	检查节点状态
`openclaw nodes`	管理移动节点	查看所有节点

10.4 配对管理

命令	功能	说明
`openclaw pairing list`	查看待处理的配对请求	审批新联系人
`openclaw pairing approve`	批准配对请求	允许新联系人
`openclaw pairing deny`	拒绝配对请求	拒绝新联系人

十一、故障排查流程

11.1 标准排查步骤

# 1. 检查状态
openclaw gateway status

# 2. 查看日志
openclaw logs --follow

# 3. 健康检查
openclaw doctor

# 4. 自动修复
openclaw doctor --fix

# 5. 重启服务
openclaw gateway restart

11.2 常见问题解决

问题	解决方案
配置修改不生效	`openclaw gateway restart`
JSON语法错误	`openclaw doctor --fix`
网关宕机	`openclaw doctor --deep`
记忆索引错误	`openclaw memory index`
授权过期	`openclaw models auth setup-token`
不回复私聊	进入Pairing List手动批准
群聊静默	检查MentionPatterns配置

十二、命令使用频率统计

高频命令（每日使用）

openclaw gateway restart - 修改配置后必用
openclaw doctor - 出问题先跑这个
openclaw status - 快速检查状态
openclaw logs --follow - 实时查看日志
/new - 开启新会话

中频命令（每周使用）

openclaw models set - 切换模型
openclaw skills install - 安装新技能
openclaw channels status - 检查渠道连接
openclaw config set - 修改配置
clawhub search - 搜索技能

低频命令（每月使用）

openclaw update - 更新版本
openclaw backup create - 创建备份
openclaw security audit - 安全审计
openclaw reset - 重置配置
openclaw uninstall - 卸载系统

十三、实用技巧与最佳实践

13.1 多环境管理

# 工作环境
openclaw --profile work gateway start

# 个人环境
openclaw --profile personal gateway start

# 开发环境
openclaw --dev gateway start

13.2 脚本自动化

# 批量执行命令
openclaw run --batch commands.txt

# 管道输入
echo "分析这段代码" | openclaw run

# JSON输出处理
openclaw models list --json | jq '.models[] | select(.provider=="openai")'

13.3 快捷键与别名

# 创建别名（在~/.bashrc或~/.zshrc中）
alias claw='openclaw'
alias claw-status='openclaw gateway status'
alias claw-restart='openclaw gateway restart'
alias claw-logs='openclaw logs --follow'
alias claw-doctor='openclaw doctor --fix'

13.4 配置文件位置

主配置：~/.openclaw/openclaw.json
工作区：~/.openclaw/workspace/
技能目录：~/.openclaw/skills/
Agent数据：~/.openclaw/agents/
日志文件：~/.openclaw/logs/

十四、总结

OpenClaw的命令体系设计清晰，分为CLI命令和斜杠命令两大类别，覆盖了从系统管理到日常使用的所有场景。掌握这些命令，您就能充分发挥OpenClaw作为个人AI助手的强大能力。

核心要点：

配置修改后必须重启网关：openclaw gateway restart
出问题先跑诊断：openclaw doctor
实时查看日志：openclaw logs --follow
多环境隔离：使用--profile参数
技能扩展：通过ClawHub社区安装

这份命令大全基于2026年5月的最新资料整理，涵盖了OpenClaw的所有核心功能。建议收藏本文，使用时通过Ctrl+F快速查找所需命令。

以上就是OpenClaw指令分类详解与使用指南的详细内容，更多关于OpenClaw指令分类与使用的资料请关注脚本之家其它相关文章！

Tag：OpenClaw 指令分类使用

OpenClaw的核心指令使用方法详解
OpenClaw 是一个开源的个人 AI 助手框架，支持通过命令行界面（CLI）进行全面的配置、管理和操作,此外，它还支持在 macOS/iOS/Android 上进行语音交互，并提供实时画布界面
2026-04-01
一文总结openclaw小龙虾常用指令(建议收藏)
OpenClaw是一个自主通信网关，它将WhatsApp、Telegram、Discord和iMessage等主流即时通讯应用与可编程人工智能代理连接起来,这篇文章主要为大家整理了一些openclaw常用指令
2026-03-23
OpenClaw 指令大全(全网最全)
OpenClaw 是一个强大的 AI 助手框架，但有 40+ 核心命令,本文就来介绍一下OpenClaw 指令大全，文中通过示例代码介绍的非常详细，需要的朋友们下面随着小编来一起学习学习吧
2026-03-23
浅谈windows下openclaw的操作指令小结
本文档详细介绍了Windows系统下OpenClaw的操作指令,包括基础操作、Gateway网关管理、模型管理、技能管理、通道管理、Agent管理、浏览器自动化、定时任务、系统与日志以及配
2026-03-16
OpenClaw常用操作命令完整速查手册：从入门到精通的终端 CLI & 聊
作为 OpenClaw 生态（包括 PicoClaw、ZeroClaw、losterAI、EasyClaw 等系列开源应用）的核心用户，我根据开源资料和个人使用体验整理了这份全网最全的命令速查手册
2026-03-09
openclaw常用指令的使用小结
OpenClaw 是一款功能强大的开源 AI 助手框架，支持对接多种大模型和通讯平台,下面就来介绍一下openclaw常用指令，需要的朋友们下面随着小编来一起学习学习吧
2026-03-04