OpenClaw的命令行工具覆盖了从安装配置到日常运维的全流程。我为你整理了最常用和最高频的命令,按功能分类,方便快速查阅。

  1. 安装与配置

这是你第一次使用 OpenClaw 时需要执行的命令。

命令

说明

openclaw onboard --install-daemon

全能初始化向导。会引导你设置 API Key、选择模型、配置消息通道,并自动安装后台守护进程(推荐首选)。

openclaw configure

交互式配置向导。用于单独修改某项配置,比直接改文件更稳妥。

openclaw config get / set

直接查看或修改配置。例如 openclaw config set models.default gpt-4。

openclaw doctor --fix

自动诊断修复。当 OpenClaw 行为异常时,运行它自动检测并修复配置文件问题。

  1. 网关管理 (Gateway)

OpenClaw 的核心是一个后台服务(Gateway),通过以下命令控制它的“生死”。

命令

说明

openclaw gateway start

后台启动网关(守护进程模式),关闭终端也不会停止。

openclaw gateway stop

停止网关服务。

openclaw gateway restart

重启网关(修改配置后常用)。

openclaw gateway status

查看网关当前运行状态。

openclaw gateway

前台运行网关。终端会实时打印日志,通常用于调试。

  1. 日常运维与调试

命令

说明

openclaw dashboard

打开 Web 控制台(默认地址:http://127.0.0.1:18789)。

openclaw status

查看 OpenClaw 整体健康状态。

openclaw update

检查并更新 OpenClaw 到最新版本。

journalctl --user -u openclaw-gateway.service -f

查看实时日志(Linux)。用于排查服务为什么不响应。

  1. 高级功能与调试

命令

说明

openclaw tui

启动终端交互界面。在 Bot 连接不上聊天软件时,直接在命令行里和 AI 对话。

openclaw agent --message "你好"

命令行直接调用 AI 智能体。可用于脚本或测试,支持 --to 指定投递渠道。

openclaw models set <模型名>

切换 AI 模型。也可以直接让 AI 帮你切。

openclaw devices list / approve

设备配对管理。当新设备尝试连接时,需要运行此命令批准。

  1. 配置文件速览

如果你想让 AI 的行为更符合你的习惯,可以修改 ~/.openclaw/workspace/ 目录下的这几个文件,它们决定了 AI 的“性格”和“智商”:

  1. SOUL.md:AI 的灵魂。定义说话风格、价值观和红线。
  2. USER.md:AI 的用户说明书。记录你的称呼、偏好、雷区。
  3. AGENTS.md:AI 的工作指南。规定接到任务后的处理流程。
  4. HEARTBEAT.md:AI 的自主意识。让 AI 定时主动执行任务(如每日早报)。
  1. 聊天中的快捷指令

在 WhatsApp、Telegram 等聊天窗口中,可以直接发送以下指令控制 AI:

  1. /reset 或 /new:清空当前会话的上下文记忆(相当于开启新对话)。
  2. /status:查看当前会话状态(使用的模型、消耗 token 等)。
  3. /think high:设置模型的思考深度(越高推理越深但速度越慢)。
Logo

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地,聚焦技能开发、插件实践与部署教程,为开发者提供可直接落地的方案、工具与交流平台,助力高效构建与落地 AI 应用

更多推荐