🦞 雪安的小龙虾 - OpenClaw 研究站

Appearance

常用命令大全 ​

本页汇总了 OpenClaw 日常使用中最常用的命令，按功能分类，每条命令附带详细说明和实际用例。

Gateway 管理 ​

Gateway 是 OpenClaw 的核心守护进程，负责管理会话、调度模型请求和运行后台任务。

openclaw gateway start ​

启动 Gateway 守护进程。首次使用或服务器重启后需要执行。

bash
# 启动 Gateway
openclaw gateway start

# 启动后验证是否正常运行
openclaw gateway status

提示： 如果启动失败，先运行 openclaw doctor 检查环境配置。

openclaw gateway stop ​

停止 Gateway 守护进程。所有活跃会话将被暂停。

bash
# 停止 Gateway
openclaw gateway stop

注意： 停止 Gateway 不会丢失记忆文件或配置，但正在执行的子代理任务会被中断。

openclaw gateway restart ​

重启 Gateway。修改配置文件后需要重启才能生效。

bash
# 修改配置后重启
openclaw gateway restart

常见需要重启的场景：

  • 修改了 openclaw.json 中的 providers 配置
  • 更新了 API Key
  • 调整了模型参数
  • 升级了 OpenClaw 版本

openclaw gateway status ​

查看 Gateway 当前运行状态，包括进程信息、端口、运行时长等。

bash
openclaw gateway status

输出示例：

Gateway: running (PID 12345)
Uptime: 3d 5h 12m
Port: 3578
Sessions: 2 active

会话命令（斜杠命令） ​

在与 OpenClaw 对话时，可以使用以 / 开头的斜杠命令来控制会话行为。

/new ​

新建会话，清空当前上下文。适合开始一个全新话题时使用。

/new

使用场景：

  • 当前话题结束，要开始新任务
  • 上下文已经很长，影响响应质量
  • 切换到完全不相关的工作

注意： /new 不会清除记忆文件（MEMORY.md），只清除当前会话的对话上下文。

/status ​

查看当前会话状态，包括使用的模型、Token 用量、上下文大小等。

/status

输出信息包括：

  • 当前模型名称和别名
  • Token 消耗量（输入/输出）
  • 上下文窗口使用率
  • 推理模式状态
  • 活跃的子代理数量

建议： 当感觉响应变慢或质量下降时，用 /status 检查上下文是否接近上限。

/model <name> ​

切换当前会话使用的模型。模型名称需要与 openclaw.json 中配置的一致。

# 切换到 Claude Sonnet
/model claude-sonnet-4-20250514

# 切换到 GPT-4o
/model gpt-4o

# 切换到配置中的别名
/model xueancc/claude-opus-4-6

使用场景：

  • 简单任务切换到便宜模型省钱
  • 复杂推理任务切换到更强模型
  • 测试不同模型的输出效果

/reasoning [on|off|low|medium|high] ​

切换推理模式（思维链）。开启后模型会先进行内部推理再输出结果。

# 开启推理
/reasoning on

# 关闭推理
/reasoning off

# 设置推理深度
/reasoning high

推理级别说明：

  • off — 关闭推理，响应最快
  • low — 轻度推理，适合一般任务
  • medium — 中度推理，适合需要分析的任务
  • high — 深度推理，适合复杂逻辑和数学问题

注意： 推理模式会消耗更多 Token，建议仅在需要时开启。

/compact ​

手动压缩当前上下文。当上下文接近窗口上限时使用。

/compact

工作原理：

  • 将对话历史总结为精简摘要
  • 保留关键信息和决策点
  • 释放上下文空间供后续对话使用

何时使用：

  • /status 显示上下文使用率 > 80%
  • 响应速度明显变慢
  • 模型开始「遗忘」之前的内容

/subagents list ​

查看所有当前活跃的子代理及其状态。

/subagents list

输出示例：

ID          | Task                    | Status  | Runtime
a1b2c3d4    | 代码审查                 | running | 2m 15s
e5f6g7h8    | 文档生成                 | done    | 5m 03s

/subagents stop <id> ​

停止指定的子代理。适用于任务卡住或不再需要的情况。

# 停止指定子代理
/subagents stop a1b2c3d4

/subagents log <id> ​

查看指定子代理的执行日志，便于调试和了解执行过程。

# 查看子代理日志
/subagents log a1b2c3d4

配置命令 ​

openclaw config ​

查看当前生效的配置，包括模型设置、providers 配置、工具策略等。

bash
openclaw config

用途：

  • 确认配置是否正确加载
  • 排查模型选择问题
  • 检查 API 端点设置

openclaw doctor ​

运行环境诊断，检测常见问题并给出修复建议。

bash
openclaw doctor

检测项目包括：

  • Node.js 版本是否满足要求（v22+）
  • 配置文件语法是否正确
  • API Key 是否有效
  • 网络连接是否正常
  • 依赖包是否完整

建议： 遇到任何问题时，第一步先跑 openclaw doctor。

openclaw onboard ​

运行初始化向导，适合首次安装或需要重新配置时使用。

bash
openclaw onboard

向导步骤：

  1. 选择默认模型供应商
  2. 配置 API Key
  3. 设置工作区路径
  4. 选择通信渠道（Telegram / Discord 等）
  5. 生成初始配置文件

Cron 定时任务 ​

OpenClaw 内置了 Cron 系统，可以设置定时任务让 AI 自动执行周期性工作。

openclaw cron list ​

列出所有已配置的定时任务。

bash
openclaw cron list

输出示例：

Name            | Cron          | Session    | Next Run
每日摘要         | 0 9 * * *     | isolated   | 2026-02-13 09:00
周报生成         | 0 18 * * 5    | isolated   | 2026-02-14 18:00

openclaw cron add ​

添加定时任务。

bash
# 每天早上 9 点发送日报
openclaw cron add \
  --name "每日晨报" \
  --cron "0 9 * * *" \
  --session isolated \
  --message "检查今天的日历事件和未读邮件，生成今日待办清单"

# 每周五下午 6 点生成周报
openclaw cron add \
  --name "周五周报" \
  --cron "0 18 * * 5" \
  --session isolated \
  --message "回顾本周的 memory 日志，生成本周工作总结"

# 每小时检查一次服务状态
openclaw cron add \
  --name "服务巡检" \
  --cron "0 * * * *" \
  --session isolated \
  --message "检查所有服务的运行状态，有异常立即通知"

参数说明：

  • --name — 任务名称（便于识别）
  • --cron — 标准 Cron 表达式（分 时 日 月 周）
  • --session — 会话模式，isolated 表示独立会话（推荐），不影响主会话
  • --message — 触发时发给 AI 的提示内容

常用 Cron 表达式：

表达式含义
0 9 * * *每天 9:00
0 9 * * 1-5工作日 9:00
*/30 * * * *每 30 分钟
0 18 * * 5每周五 18:00
0 0 1 * *每月 1 日 0:00

更多帮助 ​

bash
# 查看所有可用命令
openclaw help

# 查看特定命令的帮助
openclaw gateway --help
openclaw cron --help

遇到问题？查看 常见问题 或运行 openclaw doctor 进行诊断。

🦞 雪安的小龙虾 · 每日自动抓取 · 内容有误概不负责