VPN07

OpenClaw CLI核心子命令手册：doctor/sessions/memory/logs实战2026

2026-03-09 阅读约15分钟 CLI手册 命令参考

本文定位：OpenClaw CLI 子命令实战手册。很多用户只会用 openclaw start 和 openclaw status，但实际上 OpenClaw 提供了 30+ 个功能强大的 CLI 子命令。本文重点讲解最实用的 8 个核心子命令：doctor、status、sessions、memory、logs、gateway、health、models，每个命令含常用参数说明、典型使用场景和实际输出示例。

doctor
自动诊断修复
status
运行状态总览
sessions
会话管理
memory
记忆操作
logs
日志查询
gateway
网关控制
health
健康检查
models
模型管理

openclaw doctor — 自动诊断与修复

doctor 是 OpenClaw 最重要的排障命令。它会系统检测所有配置项、网络连接、API 认证状态、权限设置等，并在发现问题时提供修复建议甚至自动修复。

Terminal
# 完整诊断（只看问题，不修复）
openclaw doctor

# 自动诊断并修复（推荐首选）
openclaw doctor --fix

# 指定诊断范围（只检查网络相关）
openclaw doctor --scope network

# 只检查认证配置
openclaw doctor --scope auth
典型输出示例
✓ Node.js v22.4.0 (minimum: v20)
✓ openclaw 1.8.3 (latest)
✓ anthropic key: sk-ant-api03-*** · valid · tier: tier-2
⚠ github-copilot token cache: stale (last refreshed 91d ago)
  → Run: openclaw models auth login --provider github-copilot
✗ network api.anthropic.com: ETIMEDOUT (proxy may be needed)
  → Check: export HTTPS_PROXY=http://127.0.0.1:7890

openclaw status — 全局运行状态

status 提供 OpenClaw 当前运行状态的综合视图，包括 Gateway 状态、活跃会话数、Provider 配额、内存使用等关键指标。

# 基本状态（默认）
openclaw status

# 显示所有 Provider 的详细信息
openclaw status --all

# 显示 Token 用量统计
openclaw status --usage

# JSON 格式输出（适合脚本解析）
openclaw status --json

status 命令重点字段解读

gateway: runningGateway 正常运行，可以接受消息
sessions: 3 active当前有 3 个活跃会话（不同通讯渠道）
anthropic: 47% leftClaude API 月度配额剩余 47%
uptime: 3d 14hOpenClaw 已连续运行 3 天 14 小时

openclaw sessions — 会话管理

OpenClaw 为每个通讯渠道（Telegram 私聊、Telegram 群组、Discord 频道等）维护独立的会话。sessions 子命令让你查看、管理和操作这些会话。

# 列出所有活跃会话
openclaw sessions list

# 列出所有会话（含已结束）
openclaw sessions list --all

# 查看特定会话的详情
openclaw sessions get <session-id>

# 导出会话为 HTML（保存对话历史）
openclaw sessions export <session-id> --format html

# 删除特定会话（清除对话历史）
openclaw sessions delete <session-id>

# 删除所有已结束的会话（清理磁盘）
openclaw sessions prune
实战场景：找到卡住的会话并中止
# 找出正在运行任务的会话
openclaw sessions list --filter running
# 输出：session-1234 telegram:main running started: 2min ago

# 通过 agent 子命令发送中止信号
openclaw agent --session-id 1234 --message "/stop"

openclaw memory — AI 记忆管理

OpenClaw 的 AI 助理具有持久记忆能力——它能记住你的个人偏好、重要信息、工作习惯。memory 子命令让你直接操作这个记忆数据库。

# 查看所有记忆条目
openclaw memory list

# 搜索特定关键词的记忆
openclaw memory search "工作偏好"

# 查看特定记忆条目详情
openclaw memory get <memory-id>

# 手动添加一条记忆
openclaw memory add --content "用户偏好：所有邮件摘要用中文输出"

# 删除特定记忆条目
openclaw memory delete <memory-id>

# 导出所有记忆（备份）
openclaw memory export --output ~/openclaw-memory-backup.json

# 导入记忆（从备份恢复）
openclaw memory import --input ~/openclaw-memory-backup.json

记忆管理的注意事项

记忆是 AI 助理个性化的核心，误删记忆会导致助理"失忆"，需要重新建立偏好设置
更换设备时，务必先 memory export 备份，再在新设备 memory import 恢复
记忆文件默认存储在 ~/.openclaw/memory/，建议纳入定期备份策略

openclaw logs — 日志查询与分析

当 OpenClaw 行为异常时，日志是排查问题的第一手资料。logs 子命令提供强大的日志查询能力。

# 实时跟踪日志（最常用，等同于 tail -f）
openclaw logs --follow

# 查看最近 100 条日志
openclaw logs --last 100

# 只看错误级别日志（排查问题时用）
openclaw logs --level error

# 过滤特定关键词
openclaw logs --grep "429"
openclaw logs --grep "ETIMEDOUT"

# 查看特定时间段的日志
openclaw logs --since "2026-03-09T10:00:00" --until "2026-03-09T11:00:00"

# 查看特定会话的日志
openclaw logs --session <session-id>

# 导出日志到文件（用于提 Bug 报告）
openclaw logs --last 500 --output ~/openclaw-debug.log

openclaw gateway — 网关服务控制

Gateway 是 OpenClaw 的核心守护进程，负责监听所有通讯渠道的消息、调度 AI 任务、管理会话生命周期。gateway 子命令控制这个核心服务。

# 在前台启动（调试用，可看到所有输出）
openclaw gateway start --foreground

# 在后台启动（生产环境推荐）
openclaw gateway start

# 停止 Gateway
openclaw gateway stop

# 重启 Gateway（修改配置后必须重启）
openclaw gateway restart

# 热重载配置（不中断服务）
openclaw gateway reload

# 查看 Gateway 的详细状态
openclaw gateway status

gateway reload vs restart 的区别

reload 是热重载，不会中断正在进行的会话和任务，只更新配置。restart 会完全停止并重启 Gateway，会中断所有进行中的 AI 任务，已发送的消息会在重启后重新排队处理。修改了 providers 等核心配置时使用 restart；只修改了 messages 等显示配置时用 reload。

openclaw health — 健康检查

health 是比 status 更轻量的快速检查命令，主要用于监控脚本或 CI/CD 环境中验证 OpenClaw 是否正常运行。

# 快速健康检查（返回 ok 或 error）
openclaw health

# JSON 格式输出（脚本友好）
openclaw health --json
# 输出：{"status": "ok", "gateway": "running", "uptime": 12345}

# 在 shell 脚本中检查 OpenClaw 是否正常
if openclaw health --quiet; then
  echo "OpenClaw 运行正常"
else
  echo "OpenClaw 出现问题，尝试重启..."
  openclaw gateway restart
fi

openclaw models — 模型与认证管理

models 子命令用于管理 AI 模型 Provider 的认证、列出可用模型、设置默认模型等，是 Token 管理的核心工具。

# 列出所有可用模型（按 Provider 分组）
openclaw models list

# 设置 API Token（通用）
openclaw models auth setup-token --provider anthropic
openclaw models auth setup-token --provider openai

# OAuth 登录（适用于 Copilot/Google 等）
openclaw models auth login --provider github-copilot

# 查看所有 Provider 的认证状态
openclaw models auth status

# 删除特定 Provider 的认证
openclaw models auth remove --provider anthropic

# 查看 Token 用量（按 Provider）
openclaw models usage
openclaw models usage --provider anthropic

常用命令组合工作流

工作流1：OpenClaw 启动异常排查

openclaw doctor # 诊断所有问题
openclaw health # 确认服务状态
openclaw logs --level error --last 50 # 查最近错误
openclaw gateway restart # 重启服务
openclaw status # 确认恢复正常

工作流2：Claude 限流后快速切换 Provider

openclaw status --usage # 确认哪个 Provider 超限
openclaw models auth login --provider github-copilot # 激活备用
openclaw gateway reload # 热重载（无需重启）
openclaw status --all # 确认新 Provider 已激活

工作流3：迁移到新设备

# 旧设备：备份所有数据
openclaw memory export --output ~/openclaw-memory.json
openclaw sessions export all --output ~/openclaw-sessions/
cp ~/.openclaw/openclaw.json ~/openclaw-config.json

# 新设备：还原
openclaw setup # 初始配置
cp ~/openclaw-config.json ~/.openclaw/openclaw.json
openclaw memory import --input ~/openclaw-memory.json
openclaw models auth login --provider anthropic
openclaw gateway start

进阶技巧：用 CLI 构建自动化运维脚本

OpenClaw 的 CLI 命令支持 JSON 输出格式，让你可以轻松将其集成到 Shell 脚本、cron 定时任务或监控系统中，实现 OpenClaw 的自动化运维：

自动健康检查脚本（保存为 check-openclaw.sh）
#!/bin/bash
# OpenClaw 自动健康检查与重启脚本

STATUS=$(openclaw health --json 2>/dev/null)
GATEWAY=$(echo $STATUS | python3 -c "import sys,json; d=json.load(sys.stdin); print(d.get('gateway','unknown'))")

if [ "$GATEWAY" != "running" ]; then
  echo "$(date): OpenClaw 异常，尝试重启..."
  openclaw gateway restart
  sleep 10
  openclaw doctor --fix
  echo "$(date): 重启完成"
fi

# 将此脚本加入 crontab 每5分钟检查一次
# */5 * * * * /path/to/check-openclaw.sh >> /var/log/openclaw-monitor.log

Token 用量超限自动切换 Provider

# 检查 Claude 用量，超过 90% 自动切换 Copilot
USAGE=$(openclaw models usage --provider anthropic --json | python3 -c "import sys,json; d=json.load(sys.stdin); print(d.get('used_pct', 0))")
if [ $(echo "$USAGE > 90" | bc -l) -eq 1 ]; then
  openclaw models auth login --provider github-copilot
  openclaw gateway reload
fi

定期清理过期会话和日志

# 每周清理过期会话（保留最近 7 天）
openclaw sessions prune --older-than 7d

# 压缩旧日志（节省磁盘空间）
openclaw logs --older-than 30d --archive ~/openclaw-logs-archive/

完整 CLI 子命令速查表

掌握 CLI 子命令的另一个好处是，你可以在没有聊天界面（如 Telegram 或 Discord）的情况下，直接通过命令行与 OpenClaw 交互和管理。特别是在服务器端（Linux/VPS）部署场景下，当 Telegram Bot 出现问题时，CLI 提供了完整的备用操作通道，确保 OpenClaw 的管理工作不会因通讯渠道故障而中断。此外，CLI 命令支持 SSH 远程执行，你可以在任何地方的终端登录服务器，用上述命令远程诊断和管理你的 AI 助理实例。

除了本文重点介绍的 8 个核心子命令，OpenClaw 还提供了 cron（管理定时任务）、skills（管理 AI 技能文件）、browser（控制浏览器自动化）、secrets（管理加密的 API Key 存储）等专项子命令。完整的命令列表可通过 openclaw --help 查看，每个子命令都支持 --help 参数获取详细用法说明。

命令 主要用途 常用参数
setup / onboard初始配置向导首次安装使用
doctor诊断所有问题--fix --scope
status运行状态总览--all --usage --json
health快速健康检查--json --quiet
gateway服务生命周期start/stop/restart/reload
sessions会话管理list/get/export/delete/prune
memoryAI记忆管理list/add/delete/export/import
logs日志查询--follow --level --grep --since
models模型与认证list/auth setup-token/auth login
agent发送CLI消息--agent --session-id --message
update更新到最新版openclaw update
config配置文件管理get/set/show

VPN07 — CLI 命令也需要稳定网络

doctor/models/status 每条命令都会连接境外 API

OpenClaw 的每一个 CLI 命令背后，都可能需要连接 Anthropic、GitHub、Google 等境外服务器。doctor --fix 修复 API Key 需要验证连接，models auth login 需要完成 OAuth 回调，status --usage 需要查询 Provider 用量。没有稳定网络，这些命令会频繁超时失败。VPN07 运营十年，1000Mbps 千兆带宽，70+ 国家节点，让每一条 CLI 命令都稳定执行，¥9/月超值，30 天退款保障。

¥9/月
超低月费
1000Mbps
千兆带宽
70+国家
全球节点
30天
退款保证
免费试用VPN07 查看价格方案

相关文章推荐

OpenClaw 10大常见报错修复指南

401/429/OAuth失效等全部错误的逐步修复操作

阅读更多 →

OpenClaw /think六档思考级别详解

off到xhigh速度与Token消耗完整对比，省Token技巧

阅读更多 →
月费¥9 · 运营十年
免费试用 VPN07