OpenClaw 入门系列 | Day 3: CLI 工具大全——openclaw 命令你真的会用吗?

接上回，我们完成了飞书、钉钉、企业微信的频道接入，AI 已经能在日常聊天软件里对话了。但 OpenClaw 的真正实力，藏在它的 CLI 里。

很多人安装完 openclaw 就跑了一个 onboard 就不管了，以为就是装了个服务。实际上 openclaw 是一个能力非常完整的命令行工具箱，涵盖网关管理、配置调试、渠道消息、会话维护、健康诊断、更新升级六大场景。今天从高频到深度，带你彻底摸清。

一、安装与初始化：openclaw onboard

这是大部分用户的起点。openclaw onboard 是一个交互式向导，把以下事情一口气做完：

• 选择 AI 模型供应商（Anthropic、OpenAI、Google 等）
• 填写 API Key
• 选择工作目录
• 配置网关端口和认证方式
• 选择要接入的聊天频道
• 安装系统服务（开机自启）

跑完了 onboard，你的网关就能直接用。如果只想快速体验，也可以用 openclaw configure --section model 按需配置。

你还可以通过 openclaw configure 查看当前配置，或直接编辑 ~/.openclaw/openclaw.json 来精确控制每一项参数。

# 查看完整配置openclaw configure# 只查看模型配置openclaw configure --section model# 只查看频道配置openclaw configure --section channels

二、网关生命周期：openclaw gateway

openclaw gateway 是整个网关的”总开关”。只要网关在运行，你的 AI 就在线。

# 查看运行状态openclaw gateway status# 启动网关openclaw gateway start# 重启网关（改完配置后常用）openclaw gateway restart# 停止网关openclaw gateway stop# 安装系统服务（systemd / launchd）openclaw gateway install# 卸载系统服务openclaw gateway uninstall

最常用的命令是 openclaw gateway restart，每次修改配置后跑一遍就能生效。如果你在远程服务器上操作，也可以用 openclaw gateway status 确认网关的监听端口和进程状态。

三、全局诊断：openclaw doctor

openclaw doctor 是 OpenClaw 的”体检医生”。它扫描你的整个环境，找出配置错误、插件缺失、依赖不满足的地方，部分问题还可以一键修复。

# 基本体检openclaw doctor# 深度扫描（更全面）openclaw doctor --deep# 自动修复能修的问题openclaw doctor --fix# 非交互式修复（适合脚本和定时任务）openclaw doctor --fix --non-interactive

doctor 能检查的项目非常全面：

• 网关服务 — systemd / LaunchAgent 是否正常运行
• 配置完整性 — 是否有缺失或过期的配置项
• 插件状态 — 插件是否安装、是否启用了不可用的插件
• SecretRef 解析 — 凭证是否能在当前路径下解析
• Docker 可用性 — 沙箱模式需要 Docker
• 记忆系统 — 向量搜索所需的 embedding 凭据是否就绪
• 命令所有者 — 是否设置了允许执行管理命令的账号
• 会话存储 — 是否有孤立的 session 文件需要处理

建议每次更新 OpenClaw 后都跑一次 openclaw doctor --fix，确保一切正常。

四、日志追踪：openclaw logs

当 AI 回复异常或插件报错时，第一时间想看的就是日志。openclaw logs 通过 RPC 读取网关日志文件，支持远程和本地两种模式。

# 查看最近的 200 行日志openclaw logs# 查看 500 行openclaw logs --limit 500# 实时跟踪（类似 tail -f）openclaw logs --follow# 输出 JSON 格式openclaw logs --json# 显示本地时区时间openclaw logs --local-time

--follow 特别适合调试场景：打开一个终端窗口跑 openclaw logs --follow，另一个窗口操作 OpenClaw，所有实时日志都会输出。当 WebSocket 意外断开时，它还会自动重连（最多 8 次，间隔最长 30 秒）。

五、频道消息操作：openclaw message

OpenClaw 支持超过 20 个聊天平台，而 openclaw message 让你脱离聊天软件，直接在终端发送消息。

# 发送消息到默认频道openclaw message send --target "@username" --message "Hello"# 发送到指定频道openclaw message send --channel telegram --target "@username" --message "Hello"# 读取频道消息openclaw message read --channel discord --target channel:123456# 回复消息openclaw message send --channel telegram --target "@username" --message "回复内容" --reply-to "消息ID"

还支持更多高级操作：

• 投票 — openclaw message poll，WhatsApp、Telegram、Discord 都支持
• 表情回应 — openclaw message react，支持几乎所有主流平台
• 消息编辑与删除 — edit 和 delete 子命令
• 消息固定与取消固定 — pin 和 unpin
• Discord 专属 — 创建线程、获取角色信息、管理 emoji 和 sticker

如果你需要在脚本中推送告警通知，openclaw message send 比调用 Webhook 更直接。

六、会话管理：openclaw sessions

AI 的每段对话都是一个 Session，openclaw sessions 让你能在终端中管理所有会话记录。

# 列出最近的 100 个会话openclaw sessions# 列出最近两小时活跃的会话openclaw sessions --active 120# 按 Agent 筛选openclaw sessions --agent work# 查看所有 Agent 的会话openclaw sessions --all-agents# JSON 格式输出（方便脚本处理）openclaw sessions --json

会话会随着使用越来越多，OpenClaw 提供了清理机制：

# 预览将要清理的会话openclaw sessions cleanup --dry-run# 执行清理openclaw sessions cleanup --enforce# 清理所有 Agent 的会话openclaw sessions cleanup --all-agents --enforce

清理策略由配置中的 session.maintenance 控制，默认按会话数量和存储天数自动清理。--dry-run 让你先看结果再执行，避免误删。

七、全局状态总览：openclaw status

如果你只想看”当前 OpenClaw 跑得怎么样”，openclaw status 是最好的入口。它输出的是组织好的诊断面板，包含网关进程、频道状态、会话统计、模型用量等信息。

# 快速查看概览openclaw status# 完整诊断openclaw status --all# 深度探活（会对各频道发送探测消息）openclaw status --deep# 查看模型用量openclaw status --usage# JSON 格式输出openclaw status --all --json

--deep 会对 WhatsApp Web、Telegram、Discord、Slack、Signal 发送实时探测包，确认频道是否真的通。--usage 会显示每个模型供应商的剩余调用量，对管理 API Key 配额非常实用。

八、插件管理：openclaw plugins

插件是 OpenClaw 的扩展能力中心。频道、技能、存储后端都是以插件形式存在的。

# 列出已安装的插件openclaw plugins list# 安装插件openclaw plugins install @larksuite/openclaw-lark# 卸载插件openclaw plugins uninstall some-plugin# 更新插件openclaw plugins update

大多数情况下插件安装失败的原因是网络问题，可以切换 npm 镜像源后重试。

九、更新管理：openclaw update

OpenClaw 迭代很快，建议保持最新版本。

# 检查更新并升级openclaw update# 查看当前更新通道openclaw update status# 切换更新通道（stable / beta / dev）openclaw update --channel beta# 预览升级计划，不实际执行openclaw update --dry-run# 升级后不重启网关openclaw update --no-restart

三种更新通道：

升级后建议跑一次 openclaw doctor --fix 确保所有插件都与新版本兼容。

十、一些实用的组合用法

场景 1：服务器上排查问题

# 先看整体状态openclaw status# 然后体检openclaw doctor --fix# 再看日志openclaw logs --limit 100 --follow

场景 2：定时发送日报

通过 cron 任务调用 openclaw message：

# 每天早上 9 点推送天气信息到 Telegram0 9 * * * openclaw message send --channel telegram --target "@me" --message "$(curl -s wttr.in?format=3)"

场景 3：更新后快速维护

openclaw update && openclaw doctor --fix && openclaw gateway restart

场景 4：清理历史会话腾空间

openclaw sessions cleanup --all-agents --enforce --dry-run# 确认无误后openclaw sessions cleanup --all-agents --enforce

场景 5：通过飞书对话操作 OpenClaw

上面都是从终端手动敲命令。但更酷的用法是——直接在飞书里跟 AI 说一句话，让 AI 帮你执行 CLI 操作。

OpenClaw 的 SOUL.md 或 Agent 指令中配置好权限后，你就可以在飞书里这样聊天：

你：帮我看看现在网关运行状态AI：正在查询... 网关运行正常，进程 PID 12345，监听端口 8080。你：帮我清理一下历史会话AI：正在执行 cleanup --dry-run... 预计可释放 42 个会话。是否确认清理？你：确认清理AI：已执行 cleanup --enforce，释放了 42 个会话。你：升级到最新版AI：正在检查更新... 当前版本 v2026.4.21，有可用更新 v2026.5.1。是否升级？你：升级AI：正在执行 openclaw update... 升级完成，已自动重启网关。

这个能力来自 OpenClaw 的 Session 路由和 Agent 指令系统：

1. 你在飞书发出一条自然语言消息
2. OpenClaw 识别的目标 Agent 根据 SOUL.md 规则执行 message send 或 invoke 动作
3. CLI 命令通过 openclaw 在后台执行
4. 结果通过飞书返回给你

要实现这个效果，你只需要在对应的 Agent 配置里加上一句话：

# ~/.openclaw/openclaw.json 中 agent 配置片段agents:entries:my-admin:name:运维助手model:claude-sonnet-4instructions:|        你可以通过执行 openclaw CLI 命令来回答用户的问题。        高风险操作（重启、更新、删除）需要先询问用户确认。

然后你就可以在飞书上直接对这个 Agent 说话，所有操作都在对话中完成。

总结

今天跑了 openclaw 的 9 个核心命令族。你不需要记住所有参数，但建议记住这三类：

• 日常操作 — openclaw gateway restart、openclaw logs --follow、openclaw status
• 出问题时 — openclaw doctor --fix、openclaw logs --limit 200
• 系统维护 — openclaw update、openclaw sessions cleanup

如果你的 OpenClaw 已经跑起来一段时间了，现在就去跑一次 openclaw status --all，看看你从来没注意到的那几行输出。

下一篇：Day 4 —— Agent 配置：一个网关，多个 AI 角色