OpenClaw CLI 命令文档

完整、直观的 OpenClaw 命令行参考指南。从基础配置到高级功能，一站式掌握。

开始探索

Gateway 管理命令

gateway status

查看 Gateway 服务状态、进程信息、健康检查结果和资源使用情况。

openclaw gateway status

参数

--verbose 显示详细信息，包括所有进程和端口
--json 以 JSON 格式输出结果

示例

# 基本状态检查 openclaw gateway status # 详细信息 openclaw gateway status --verbose # JSON 格式 openclaw gateway status --json | jq .

gateway start

启动 OpenClaw Gateway 服务。支持后台运行和配置文件指定。

openclaw gateway start

参数

--daemon 以守护进程方式运行
--config 指定配置文件路径

gateway stop

优雅停止 Gateway 服务。发送停止信号并等待服务关闭。

openclaw gateway stop

示例

# 正常停止 openclaw gateway stop # 强制停止 (如果正常停止失败) openclaw gateway stop --force

gateway restart

重启 Gateway 服务。先停止再启动，适用于配置更新后。

openclaw gateway restart

模型管理命令

models list

列出所有可用的 AI 模型，包括提供商、上下文长度和状态信息。

openclaw models list

参数

--provider 按提供商过滤
--available 只显示可用模型

示例

# 列出所有模型 openclaw models list # 按提供商过滤 openclaw models list --provider modelverse # 只显示可用模型 openclaw models list --available # 详细输出 openclaw models list --verbose

models switch

切换当前会话使用的 AI 模型。支持模型名或别名。

openclaw models switch modelverse/MiniMax-M2.5

示例

# 切换到指定模型 openclaw models switch modelverse/deepseek-ai/DeepSeek-V3.2 # 使用别名 (如果配置了) openclaw models switch deepseek-chat # 列出可用模型后切换 openclaw models list | grep modelverse openclaw models switch modelverse/moonshotai/kimi-k2.5

models set-default

设置默认模型。新会话将自动使用此模型。

openclaw models set-default modelverse/MiniMax-M2.5

models info

显示指定模型的详细信息，包括能力、价格和提供商信息。

openclaw models info model-name

代理管理命令

status

显示当前会话状态，包括模型、令牌使用、成本和会话信息。

/status

输出示例

🦞 OpenClaw 2026.3.2 (85377a2) 🕒 Time: Monday, March 9th, 2026 — 12:26 AM 🧠 Model: modelverse/deepseek-ai/DeepSeek-V3.2 🧮 Tokens: 352k in / 1.1k out 💵 Cost: $0.0000 🧵 Session: agent:main:telegram:direct:6911327734 ⚙️ Runtime: direct · Think: off

configure

配置向导，用于设置 API 密钥、提供商和插件配置。

openclaw configure

skills

管理技能系统。安装、更新、搜索和移除技能。

npx skills command

示例

# 搜索技能 npx skills find weather # 安装技能 npx skills add ythx-101/x-tweet-fetcher # 列出已安装技能 npx skills list # 移除技能 npx skills remove skill-name

快速参考

常用快捷命令

  • /status - 会话状态
  • /model model-name - 切换模型
  • /reasoning - 切换推理模式
  • /thinking - 切换思考模式
  • /verbose - 详细输出模式

配置文件位置

  • ~/.openclaw/openclaw.json - 主配置
  • ~/.openclaw/agents/ - 代理配置
  • ~/.openclaw/workspace/ - 工作区
  • ~/.openclaw/extensions/ - 扩展插件

常用模型别名

  • deepseek-chat - DeepSeek Chat
  • kimi - Moonshot Kimi
  • claude-haiku - Claude 4.5 Haiku
  • glm-5 - GLM-5
  • m2.5 - MiniMax M2.5

故障排除

  • openclaw gateway status - 检查服务
  • openclaw gateway restart - 重启服务
  • openclaw configure --section web - 配置 Web
  • npx skills list - 检查技能