当前位置：首页 > news >正文

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

news 2026/6/29 17:42:06

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 gatewayinstall

卸载则用：

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--sectionweb

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

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

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

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