OpenClaw 命令行完全指南：从入门到日常运维

近年来，一款名为 OpenClaw 的开源 AI 智能体框架在开发者圈子里迅速走红。它的 Logo 是一只红色的龙虾，网友们把安装配置、逐步打磨它的过程戏称为“养龙虾”。OpenClaw 本质上是一个自托管的智能体网关与执行框架，更像是一个主动型的“数字员工”——不仅能够理解和推理，更能规划与落地执行任务。

今天，我就带大家从零开始，掌握 OpenClaw 最核心的命令行操作。

一、初次见面：用 openclaw chat 打个招呼

安装完成 OpenClaw 后，第一件事当然是和它聊两句。

打开一个新的终端窗口，直接运行：

openclaw chat

然后输入你的第一条消息，看看这个“AI 龙虾”如何回应你。

如果你希望通过 Web 界面与 OpenClaw 交互，可以访问本地控制台，需要运行以下命令：

openclaw dashboard

执行后，浏览器会自动打开并跳转到 Web 控制台。如果浏览器没有自动打开，你也可以手动访问 http://127.0.0.1:18789/。

此外，OpenClaw 还提供了其他几种界面交互方式：

• 终端界面 (TUI)：直接在终端里和 AI 对话，适合习惯命令行的用户。

  openclaw tui
  # 或者
  openclaw chat
  

• 直接发送消息：无需打开界面，直接在命令行中发送一条消息。

  openclaw agent --message "你好"
  

openclaw dashboard 这个命令我已经补充到原文里了，你可以再看看现在是不是更完整了。

💡 小提示：OpenClaw 的 CLI 是它的核心操作界面。虽然它顶着“自动化”的名头，但目前依然是一款强命令行工具，很多操作都离不开终端，所以需要一点点耐心去适应。

二、服务管理：openclaw gateway 系列命令

OpenClaw 的 Gateway（网关）是核心服务，必须保持运行才能使用各项功能。如果服务没有自动启动，或者你需要日常管理，以下命令必不可少：

启动服务

openclaw gateway start

这条命令会在后台启动 Gateway 服务。

停止服务

openclaw gateway stop

重启服务

openclaw gateway restart

⚠️ 重要提醒：请直接使用 openclaw gateway restart 来重启服务，不要将 openclaw gateway stop 和 openclaw gateway start 串联起来作为重启的替代方案。

如果你希望在重启前让 Gateway 先“排空”当前正在执行的任务（比如正在处理的消息、运行中的任务等），可以使用安全重启模式：

openclaw gateway restart --safe

这个命令会要求正在运行的 Gateway 预检当前活动的工作，并在活动工作处理完成后，再安排一次合并的重新启动。

查看服务状态

openclaw gateway status

该命令会显示服务的安装状态，并探测 Gateway 的健康状况。

补充：服务安装与卸载

如果需要将 Gateway 安装为系统服务（launchd/systemd/schtasks），可以使用：

openclaw gateway install

卸载则用：

openclaw gateway uninstall

三、健康诊断：openclaw doctor

遇到问题别慌——OpenClaw 自带了一套强大的诊断工具。

openclaw doctor

openclaw doctor 是 OpenClaw 的修复与迁移工具。它会检查 Gateway、渠道、插件、技能、模型路由、本地状态和配置迁移等各方面的健康状况，并提供可操作的修复步骤。

doctor 有三种运行模式：

模式	命令	行为
检查	openclaw doctor	面向人工的检查和引导式提示
修复	openclaw doctor --fix	自动应用支持的修复
检查（只读）	openclaw doctor --lint	只读的结构化诊断，适合 CI 环境

比如，当你修改了 gateway.port 配置后，可以运行以下命令让系统服务在新端口上启动进程：

openclaw doctor --fix

在 CI 或自动化脚本中，推荐使用 --lint 模式获取机器可读的诊断结果：

openclaw doctor --lint --json

四、版本更新：openclaw update

OpenClaw 保持着相当快的迭代节奏。保持最新版本非常重要。

最简单的更新方式是：

openclaw update

它会自动检测你的安装类型（npm 或 git）、拉取最新版本、执行 openclaw doctor，并重新启动 Gateway。

OpenClaw 提供了三个更新通道：

• stable：稳定版，推荐大多数用户使用
• beta：测试版
• 特定版本号

如果你想预览更新计划而不实际执行，可以使用：

openclaw update --dry-run

获取机器可读的更新状态：

openclaw update status --json

五、配置管理：openclaw configure

OpenClaw 的配置可以通过交互式命令来完成。

openclaw configure

它会以交互式提示的方式，引导你对现有设置进行定向更改——包括凭证、设备、智能体默认值、Gateway、渠道、插件、技能和健康检查等。

如果你只想配置某个特定部分，可以使用 --section 参数。例如配置 Web 搜索相关的设置：

openclaw configure --section web

另外，openclaw config 系列命令提供了更细粒度的配置读写能力：

openclaw config get          # 查看当前配置
openclaw config set          # 设置配置项
openclaw config list         # 列出所有配置

六、更多实用命令（速查）

命令	作用
openclaw --version	查看版本信息
openclaw --help	查看完整帮助文档
openclaw status	快速查看服务状态
openclaw logs	查看日志
openclaw tui	启动终端界面
openclaw dashboard	打开可视化控制面板

写在最后

OpenClaw 的命令行工具设计理念是“简单的事情简单做，复杂的事情也能做”。日常操作通常一条命令就能搞定，而高级需求则可以通过丰富的参数选项来满足。

从 openclaw chat 的初次对话，到 openclaw gateway 的服务管理，再到 openclaw doctor 的问题诊断——掌握这套命令体系，你就能真正驾驭这只“AI 龙虾”，让它成为你专属的“数字员工”。

赶快打开终端，开始你的 OpenClaw 之旅吧！🦞