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 doctoropenclaw 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 | 打开可视化控制面板 |
写在最后
OpenClaw 的命令行工具设计理念是“简单的事情简单做，复杂的事情也能做”。日常操作通常一条命令就能搞定，而高级需求则可以通过丰富的参数选项来满足。
从openclaw chat的初次对话，到openclaw gateway的服务管理，再到openclaw doctor的问题诊断——掌握这套命令体系，你就能真正驾驭这只“AI 龙虾”，让它成为你专属的“数字员工”。
赶快打开终端，开始你的 OpenClaw 之旅吧！🦞
