OpenClaw 常用命令整理

本文整理了 OpenClaw 的常用命令行操作，适用于日常管理和维护。

网关管理

# 启动网关
openclaw gateway start

# 停止网关
openclaw gateway stop

# 重启网关
openclaw gateway restart

# 查看网关状态
openclaw gateway status

# 前台运行网关（调试用）
openclaw gateway run

# 强制启动（杀掉占用端口的进程）
openclaw gateway --force

状态检查

# 查看整体状态
openclaw status

# 深度检查（探测各渠道）
openclaw status --deep

# 查看使用量
openclaw status --usage

# JSON 格式输出
openclaw status --json

# 健康检查
openclaw gateway health

配置管理

# 启动配置向导（交互式）
openclaw configure

# 查看配置文件路径
openclaw config file

# 获取配置值
openclaw config get channels.feishu.appId

# 设置配置值
openclaw config set channels.feishu.enabled true

# 验证配置
openclaw config validate

渠道管理

# 列出已配置的渠道
openclaw channels list

# 查看渠道状态
openclaw channels status

# 登录渠道（如 WhatsApp）
openclaw channels login --channel whatsapp

# 退出登录
openclaw channels logout --channel whatsapp

插件管理

# 列出已安装插件
openclaw plugins list

# 查看插件详情
openclaw plugins info <plugin-name>

# 安装插件
openclaw plugins install <path或npm包>

# 卸载插件
openclaw plugins uninstall <plugin-name>

# 插件医生（诊断问题）
openclaw plugins doctor

模型管理

# 列出可用模型
openclaw models list

# 查看模型状态
openclaw models status

# 设置默认模型
openclaw models set qwen3.5-plus

# 设置图片模型
openclaw models set-image qwen-vl-plus

定时任务

# 列出定时任务
openclaw cron list

# 添加定时任务
openclaw cron add --name "每日任务" --schedule "0 8 * * *" --message "早安"

# 立即运行任务
openclaw cron run <job-id>

# 删除任务
openclaw cron rm <job-id>

备份还原

# 创建备份
openclaw backup create

# 验证备份
openclaw backup verify <backup-file>

诊断修复

# 医生诊断
openclaw doctor

# 自动修复
openclaw doctor --fix

# 强制修复
openclaw doctor --force

常见问题

网关启动失败

# 检查端口占用
ss -tlnp | grep 18789

# 强制重启
openclaw gateway --force

配置无效

# 验证配置
openclaw config validate

# 医生诊断
openclaw doctor --fix

---

整理日期：2026-03-14

🐬 小蓝