OpenClaw 常用维护命令

备注:openclaw gateway 是网关主服务,日常运维优先用 gateway 子命令;openclaw 顶层命令为别名兼容OpenClaw,(npm 原生 CLI,适合搭配 Ollama 本地模型)

一、启停 & 状态查看(最高频)

# 查看网关状态(推荐,包含运行状态、连通性探测)
openclaw gateway status
openclaw gateway status --deep     # 深度健康探测

# 启停网关服务
openclaw gateway start
openclaw gateway stop
openclaw gateway restart

# 简易别名(等价网关)
openclaw start
openclaw stop
openclaw restart
openclaw status

# 指定端口启动网关
openclaw start --port 3000

# 调试模式启动,输出详细日志
openclaw start --debug

二、日志查看,排错核心

# 实时跟踪日志(最常用)
openclaw logs --follow

# 查看最近100行日志
openclaw logs --lines 100

# 只看错误日志
openclaw logs --level error

# plain纯文本输出,关闭颜色
openclaw logs --plain

# 按profile多环境(dev/work)
openclaw --profile dev logs --follow

日志默认路径:/tmp/openclaw/(Linux/macOS);Windows 在系统临时目录OpenClaw

三、系统诊断 & 健康检查(故障排查第一步)

# 全量系统自检,检查依赖、配置、网络、provider连通性
openclaw doctor

# 测试AI模型后端连通性(Ollama/API)
openclaw ping

# 测试技能/插件可用性
openclaw test-skill

# 查看token消耗统计
openclaw usage --last 30d

四、版本、更新、安装卸载

# 查看版本
openclaw --version
openclaw version

# 检查是否有新版本
openclaw version --check

# 一键升级openclaw+所有技能插件,升级后自动重启网关
openclaw update

# 预览更新,不实际执行
openclaw update --dry-run

# 切换beta/dev开发通道更新
openclaw update --channel beta

# npm全局安装/卸载
npm install -g openclaw
npm uninstall -g openclaw

五、配置、备份、重置、缓存

# 导出完整配置备份json
openclaw export-config > backup.json

# 从备份文件恢复配置
openclaw import-config backup.json

# 清理API缓存、临时文件
openclaw clear-cache

# 交互式初始化配置
openclaw setup
openclaw onboard

# 重置所有配置与工作区(危险!先备份)
openclaw reset

六、密钥 Secrets 管理(Ollama/API Key)

# 列出密钥(值会掩码隐藏)
openclaw secrets list

# 设置密钥,例如ollama api key
openclaw secrets set ollama_api_key

# 删除密钥
openclaw secrets delete ollama_api_key

# 重载密钥,无需重启网关
openclaw secrets reload

七、模型管理(搭配本地 Ollama)

# 列出已识别模型
openclaw models list

# 设置默认模型 ollama/qwen2.5:7b
openclaw models set ollama/qwen2.5:7b

# 直接调用推理测试模型
openclaw infer model run --model ollama/qwen2.5:7b "你好"

# 节点工作器(远端Ollama节点接入网关)
openclaw node run --host http://gatewayIP:18789 --display-name "LocalOllama"
openclaw nodes pending
openclaw nodes approve <nodeRequestId>
openclaw nodes status --connected

八、插件 / Skill 管理

openclaw plugins install <包名/本地tgz>
openclaw plugins enable <plugin-id>
openclaw plugins disable <plugin-id>
openclaw plugins doctor

九、Docker Compose 部署专用命令(容器版)

# 查看容器状态
docker compose ps

# 实时网关日志
docker compose logs -f openclaw-gateway

# 在容器内执行openclaw cli
docker compose run --rm openclaw-cli status
docker compose run --rm openclaw-cli doctor

# 启停容器栈
docker compose up -d
docker compose down

十、Web 聊天内斜杠命令(在 UI 会话里直接发消息执行)

/status        # 会话状态、配额
/new           # 新建会话
/model         # 切换模型
/stop          # 终止当前任务
/compact       # 压缩会话上下文
/debug show    # 调试信息
/restart       # 重启agent会话

标准故障排查顺序(运维推荐流程)

openclaw gateway status
openclaw doctor
openclaw logs --follow
openclaw ping
openclaw models list

Windows 11 下如何安装 OpenClaw:https://www.hao0564.com/6230.html

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注