一篇搞懂 OpenClaw 常用的终端命令与聊天指令，包含应用场景

工作 2026-03-25 onebyte 手机阅读
一篇搞懂 OpenClaw 常用的终端命令与聊天指令，包含应用场景-一字节.OneByte
网关管理、消息发送、定时任务、渠道配置—这些是每天都会用到的操作，别的先不管，把这些搞懂就够了。
腾讯云coding plan https://go.wangzhijie.com/txcoding 腾讯云低价云主机 https://go.wangzhijie.com/txecs 阿里云一键部署openclaw https://go.wangzhijie.com/aliyunopenclaw 阿里云领7000万token https://go.wangzhijie.com/aliyunai 阿里云轻量服务器68/年 99/年 https://go.wangzhijie.com/aliyun 阿里云百炼Coding Plan https://go.wangzhijie.com/aliyuncoding

一、终端常用命令

1. 启动和状态

openclaw gateway run        # 前台运行网关，调试用，日志直接打在终端
openclaw gateway start      # 后台运行，开机自启后用这个
openclaw gateway status     # 看网关有没有在跑、RPC 通不通
openclaw gateway stop       # 停掉后台网关
什么时候用：
  • 改完配置想立刻生效：gateway restart
  • 连不上：gateway status 看服务状态，gateway probe 探测问题
  • 全新安装后：gateway install 装开机自启服务

2. 看日志

openclaw logs               # 实时滚动日志。终端看
openclaw logs --limit 100  # 只看最近100行
openclaw logs --json       # 程序员友好，程序解析用
什么时候用：
  • 消息发不出去，看 channel 日志有没有报错
  • 调查问题时先跑这个，比猜快多了

3. 排查问题

openclaw doctor             # 自动体检 + 修复提示，出了问题先跑这个
openclaw doctor --fix       # 自动修复已知问题（会备份原配置）
openclaw doctor --deep      # 深挖模式，扫描系统里有没有别的网关在跑
什么时候用：
  • 网关起不来、渠道连不上，先跑 doctor
  • doctor 扫完会告诉你哪里有问题、怎么修

4. 发消息

# 基础发消息
openclaw message send --channel telegram --target @用户名 --message "你好"

# 发投票
openclaw message poll --channel discord \
  --target channel:123456 \
  --poll-question "中午吃什么？" \
  --poll-option 米饭 --poll-option 面条

# 广播到多个渠道
openclaw message broadcast \
  --targets channel:群A --targets channel:群B \
  --message "系统通知"
什么时候用：
  • 定时任务发通知、广播公告
  • 创建投票收集意见

5. 定时任务

openclaw cron list                    # 看现在有哪些定时任务
openclaw cron add                     # 交互式创建新任务
openclaw cron run <ID>                # 立刻触发一次，测试用
openclaw cron runs <ID>               # 看这个任务的历史执行情况
openclaw cron rm <ID>                 # 删除任务
openclaw cron enable <ID>             # 启用
openclaw cron disable <ID>            # 暂停
什么时候用：
  • 每天早上自动发早报
  • 每周汇总数据发到群里
  • 整点提醒喝水、站起来活动
创建定时任务的逻辑（必选参数）： 
# 时间三选一，时间必须有
--at "2026-04-01 09:00"   # 一次性，到点执行
--every 8h                 # 周期执行
--cron "0 9 * * *"        # 标准 cron 表达式，每天9点

# 内容二选一，内容必须有
--system-event --text "发送内容"  # 发系统事件
--message "聊天内容"              # 发聊天消息
实际例子： 
# 每天早上9点发早报（发到配置好的默认渠道）
openclaw cron add \
  --name "早报" \
  --cron "0 9 * * *" \
  --system-event --text "发送早报"

# 每小时提醒喝水（隔离会话，不污染主对话）
openclaw cron add \
  --name "喝水" \
  --every 1h \
  --session isolated \
  --message "该喝水了" \
  --no-deliver

# 一次性任务，执行后自动删除
openclaw cron add \
  --name "会议提醒" \
  --at "2026-04-01 14:00" \
  --message "会议开始了"

6. 渠道管理

openclaw channels list              # 看配置了哪些渠道、各自状态
openclaw channels status            # 检查各渠道连接是否正常
openclaw channels logs             # 看渠道连接日志
openclaw channels add --channel telegram --token 你的token  # 添加渠道账号
openclaw channels remove --channel telegram --delete  # 删除渠道
openclaw channels login --channel whatsapp  # WhatsApp 扫码登录
什么时候用：
  • 新增一个 Telegram bot：channels add
  • bot 不回消息了：channels status 看连接状态
  • 看 channel 有没有报错：channels logs

7. 换模型

openclaw models list               # 列出所有可用模型
openclaw models status             # 看认证状态、哪些模型能用
openclaw models set anthropic/claude-sonnet-4  # 换成指定模型
openclaw models set-image 你的图片模型  # 换图片生成模型
什么时候用：
  • 换模型：models set <模型名>
  • 想知道现在用的是什么：models status
  • 配好了想验证能不能用：models status --probe

8. 配置管理

openclaw config get agents.defaults.model.primary          # 查看当前模型
openclaw config set agents.defaults.model.primary anthropic/claude-3-5-sonnet  # 换模型
openclaw config file                                       # 看配置文件在哪
openclaw config validate                                   # 验证配置有没有写错
什么时候用：
  • 改配置：config set <路径> <值>
  • 不知道配置在哪：config file
  • 改完想确认写对了：config validate

9. 密钥管理

openclaw secrets audit            # 扫描有没有明文密码、过期密钥
openclaw secrets reload           # 热更新密钥。不用重启网关
openclaw secrets configure        # 交互式配置 API 密钥
什么时候用：
  • 换了 API key：secrets reload 让网关立刻生效
  • 想检查有没有安全隐患：secrets audit
  • 配置新的 API 密钥：secrets configure

10. 插件和技能

openclaw skills list              # 列出已安装的技能
openclaw skills check             # 检查各技能是否就绪
openclaw skills install 技能名    # 从市场安装技能
openclaw skills update            # 更新所有技能
openclaw plugins list             # 列出插件
openclaw plugins doctor           # 排查插件加载问题
什么时候用：
  • 技能不工作：skills check 看缺少什么依赖
  • 想装新技能：skills search <关键词> 搜一下

11. 设备配对

openclaw pairing list             # 看有哪些配对请求待审批
openclaw pairing approve telegram ABC123  # 审批通过
openclaw devices list             # 看已配对的设备
openclaw devices remove 设备ID    # 移除设备
什么时候用：
  • 用户想绑定飞书/Telegram：先 pairing list，再 approve
  • 设备换了想重新配：devices remove 后重新发起

12. 节点管理

openclaw nodes list               # 列出所有已配对节点
openclaw nodes status             # 节点总览
openclaw nodes run --node 节点名 -- git pull  # 在远程节点执行命令
openclaw nodes camera snap --node 节点名  # 让节点拍照
openclaw nodes location get --node 节点名  # 获取节点位置
什么时候用：
  • 远程执行命令：nodes run --node <ID> <命令>
  • 查看节点屏幕/截屏：nodes canvas snapshot
  • 让树莓派拍照：nodes camera snap

13. 备份和重置

openclaw backup create            # 创建备份（时间戳命名）
openclaw backup create --verify   # 创建后验证
openclaw reset                    # 重置配置+凭证+会话
openclaw reset --scope full      # 连工作空间也清掉（更彻底）
openclaw uninstall                # 卸载网关服务（保留 CLI）
什么时候用：
  • 改配置之前先备份：backup create
  • 出问题了想清空重来：reset（不删 CLI）
  • 完全不要了：uninstall

14. 更新

openclaw update                  # 检查更新
openclaw update status           # 看当前版本和通道
openclaw update --channel beta   # 切换到 beta 通道
openclaw update --dry-run        # 预览要更新什么，不实际执行
什么时候用：
  • 收到更新提示：update 直接升级
  • 不想升级只是想看：update status

二、聊天框常用指令（/命令）

在飞书、Telegram、Discord 等聊天窗口里，直接发 /xxx 开头的消息就能触发。不用开终端，不用重启网关。

1. 状态和诊断

指令 用来干什么
/status 查看当前状态、模型用量、渠道是否正常
/whoami 查看自己的用户 ID（调试时有用）
/health 看网关健康状态
/commands 列出所有可用指令

2. 控制 AI 行为

指令 用来干什么
/reasoning on 让 AI 显示思考过程（调查问题时开）
/reasoning off 关闭推理显示（正常对话关掉，群里别暴露）
/think high 深度思考，回答更详细（复杂问题时用）
/think off 快速回答，不思考
/verbose on 开启调试模式，显示详细信息（正常别开）
/verbose off 关闭调试模式

3. 模型控制

指令 用来干什么
/model 切换模型（会显示选择菜单）
/model 3 直接选第3个模型
/model list 列出所有可用模型
/model status 查看认证状态

4. 中断和会话

指令 用来干什么
/stop 让 AI 停止当前正在生成的内容
/reset 或 /new 重置会话。开启新对话
/restart 重启网关服务

5. 配置修改

指令 用来干什么 前提
/config show 查看当前配置 需开启 commands.config
/config set <路径> <值> 修改配置（永久生效） 同上
/debug set <路径> <值> 临时改配置（重启后失效） 需开启 commands.debug

6. 权限

指令 用来干什么
/elevated on 开启提权模式
/elevated off 关闭提权
/elevated ask 每次高权限操作前询问
/elevated full 完全提权，跳过所有确认

7. 语音

指令 用来干什么
/tts off 关闭语音朗读
/tts always 所有回复都读出来
/tts inbound 只读别人发的消息
/tts status 查看 TTS 当前状态

8. 工具和技能

指令 用来干什么
/skill 技能名 运行指定技能
/plugins 查看已发现插件
/plugin show 插件名 查看插件详情

9. 快捷内联

以下指令可以写在普通消息里面，不需要单独发，会自动触发并把剩余文字当正常消息处理： 
/status /whoami /help /commands
比如发"查一下 /status"也会触发状态查询，然后"查一下"这几个字正常走对话流程。

10. 其他有用的

指令 用来干什么
/btw 问题 临时问一个小问题，不留历史，不污染主对话
/compact 压缩会话上下文。节省 token
/export-session 导出会话记录到 HTML
/usage tokens 显示每条回复用了多少 token
/usage cost 打印本地成本汇总

三、实用组合技

场景1：网关起不来 
openclaw doctor --fix
openclaw gateway status
openclaw logs --follow
场景2：换一个 AI 模型 终端：openclaw models set anthropic/claude-3-5-sonnet 聊天框：/model → 选一个 场景3：定时发早报到群里 
openclaw cron add \
  --name "早报" \
  --cron "0 8 * * *" \
  --session isolated \
  --message "发送今日早报" \
  --announce --channel telegram --to "@你的频道"
场景4：给 AI 展示思考过程 聊天框发 /reasoning on，再问问题。 场景5：发现可疑安全问题 
openclaw secrets audit
openclaw security audit
场景6：远程控制另一台电脑（节点） 
openclaw nodes list
openclaw nodes run --node 我的树莓派 -- ls /home/pi
openclaw nodes camera snap --node 我的树莓派

四、注意事项

终端命令 vs 聊天指令
  • 终端命令在服务器/电脑终端里敲。控制全局
  • 聊天指令在对话窗口里发，控制当前会话
斜杠指令需要权限 大部分指令需要发送者被授权（白名单或已配对），未授权用户的指令会被当作普通文字处理。 配置持久化
  • /config 写入磁盘，永久生效
  • /debug 只改内存，重启后失效
  • 想永久改配置用 /config set，临时调试用 /debug set
养成备份好习惯 执行 reset、uninstall 这类操作前，先跑 openclaw backup create。