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

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 updateOpenClaw 保持着相当快的迭代节奏。保持最新版本非常重要。最简单的更新方式是openclaw update它会自动检测你的安装类型npm 或 git、拉取最新版本、执行openclaw doctor并重新启动 Gateway。OpenClaw 提供了三个更新通道stable稳定版推荐大多数用户使用beta测试版特定版本号如果你想预览更新计划而不实际执行可以使用openclaw update --dry-run获取机器可读的更新状态openclaw update status--json五、配置管理openclaw configureOpenClaw 的配置可以通过交互式命令来完成。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 之旅吧