备注:
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
