openclaw-常用命令合集

|-----------------|------------------------------|-----------|
| 指令/命令 | 功能说明 | 备注/使用要点 |
| /help /commands | 展示帮助信息及所有斜杠命令表 | 高频 |
| /status | 查看当前系统状态（模型配额、网络连通性） | 高频 |
| /whoami /id | 显示当前用户ID和权限状态 | |
| /context | 查看当前会话的上下文详情 | |
| /reset /new | 重置当前对话，清空上下文 | 高频，解决回答跑偏 |
| /file [路径] | 告诉openclaw文件位置并进行读取 | 高频 |
| /compact | 进行记忆压缩，即上下文压缩，减少上下文读取Token消耗 | |
| /img [路径] | 读取指定位置图片 | 高频 |

1.1.1展示帮助信息/help

1.1.2查看当前系统状态/status

1.1.3查看当前用户id和权限状态/whoami

/whoami

1.1.4查看当前会话的上下文详情/context

/context用中文显示

/context list

1.1.5重置当前对话/reset

/reset

1.1.6重新开启一个新的对话/new

/new

执行此命令和点击右下角"+"功能相同。

1.1.7读取指定文件/file

D:\soft\HEU_KMS_Activator_v50.0.0.zip

1.1.8读取指定图片内容/imag

C:\Users\Administrator\Downloads\变形金刚.jpeg

1.1.9上下文记忆压缩减少token

/compact

1.2模型切换与控制

调整AI模型、思考深度及推理展示

|------------|------------------|--------------------|
| 指令/命令 | 功能说明 | 备注/使用要点 |
| /model | 快速切换当前会话所使用的AI模型 | 参数：模型标识，如gpt-4o |
| /think | 动态调整模型的思考深度 | 参数：等级为off/low/high |
| /reasoning | 开启或关闭模型的深度推理过程展示 | 适用于调试与过程分析 |
| /queue | 调整消息排队与处理模式 | 如防抖策略或丢弃策略 |

1.2.1查看当前会话使用的模型及状态model

/model

1.2.2调整模型的思考等级/think

/think

/think

1.2.3开启或关闭模型的深度推理过程展示/reasoning

/reasoning

/reasoning

1.2.4调整消息排队与处理模式/queue

/queue

1.3系统配置与高级执行

直接读写配置、执行shell命令、管理权限--核心运维指令集

|--------------------------------|---------------------|--------------|
| 指令/命令 | 功能说明 | 备注/使用要点 |
| /config show|get|set|unse | 直接吐血底层配置文件，修改系统核心参数 | 【管理员专属】 |
| /debug show|set|unset|reset | 设置运行时配置覆盖，用于临时调试 | |
| /bash <命令>或！<命令> | 在服务器上直接运行shell终端命令 | 【管理员专属，高危操作】 |
| /exec | 配置或查看代码执行引擎的运行参数 | |
| /approve [allow-once/always] | 手动批准高权限任务的执行请求 | 【管理员专属】 |
| /elevated | 一键开启或关闭最好提权模式 | 【管理员专属，高危操作】 |

1.3.1修改系统核心参数/config

/config show

1.4扩展与平台路由

运行扩展技能、管理子智能体、将会话路由到指定平台

|-----------------------------|--------------------------|------------|
| 指令/命令 | 功能说明 | 备注/使用要点 |
| /skill<名称> | 按名称手动运行指定的扩展技能 | 需确保技能已正确加载 |
| /subagents list|stop|sent | 检查、停止或向子智能体发送消息 | 多智能体协作管理 |
| /openclaw channels list | 查看频道配置列表 | 快速了解配置频道 |
| /usage off|tokens|cost | 开启或关闭恢复末尾显示Token消耗量与成本预估 | 实时成本监控 |

1.4.1运行指定扩展技能/skill

/skill

/skill

1.4.2多智能体协作管理/subagents

/subagents list

1.4.3查看频道配置列表

/openclaw channels list

无聊天渠道。

1.4.4实时成本监控/usage

/usage tokens

/usage cost

查看当日使用tokens的成本。

2.后台运维指令（CLI Commands）

使用场景：再服务器终端或本地操作系统的命令行中执行的底层管理指令

2.1基础信息、安装与配置

查看版本、获取帮助、初始化系统及管理核心配置

|-----------------------------------|--------------------------|-------------------|
| 指令/command | 功能说明/Description | 备注/Notes |
| openclaw --version | 查看openclaw版本号 | 高频 |
| openclaw --help | 显示全局帮助信息 | 高频，遇到问题先查它 |
| opencla install | 安装全部依赖环境 | 首次部署必备 |
| openclaw onboard | 启动引导配置程序 | 可使用--force强制重新初始化 |
| openclaw config | 管理系统配置项（list/get/set...） | 核心配置命令 |
| openclaw onboard -install-daemon | 进入新手引导 | 核心配置命令、首次安装初始化 |
| openclaw status + openclaw health | 检查gateway网关健康状态 | 高频，遇到问题先查它 |

2.1.1查看openclaw版本号

2.1.2显示全局帮助信息

2.1.3启动引导配置程序

进入新手引导

2.1.4管理系统配置项

2.1.5检查gateway网关健康状态

2.2模型管理

列出、检查、测试、添加或移除AI模型配置

|-----------------------------------|--------------|---------|
| 指令/命令 | 功能说明 | 备注/使用要点 |
| openclaw models list | 列出所有已配置的可用模型 | |
| openclaw models status | 查看各个模型的连接状态 | |
| openclaw models set default | 设置系统默认调用的模型 | |
| openclaw models add --api_key ... | 添加新的模型配置 | |
| openclaw models remove | 移除指定的模型配置 | |

2.2.1查看当前已配置的可用模型

2.2.2查看各个模型的连接状态

2.2.3设置系统默认调用模型

2.3频道/ 机器人登录（channels）

管理Telegram、Discord等消息渠道的登录状态与连接配置

|--------------------------|-----------------|----------------------|
| 指令/命令 | 功能说明 | 备注/使用要点 |
| openclaw channels list | 列出所有已配置的消息渠道 | |
| openclaw channels status | 查看各个渠道的实时连接状态 | |
| openclaw channels login | 登录并授权连接指定平台的机器人 | 高频，如telegram，discord |
| openclaw channels logout | 断开并注销指定或所有渠道的连接 | |

2.3.1列出已配置的消息渠道

当前没有配置渠道

2.3.2查看各渠道的状态

2.4智能体/agent

创建、删除、切换和预智能体进行交互的核心指令集

|-------------------------------------------------------------------|-----------------------|----------|
| 指令/Command | 功能说明/Description | 备注/Notes |
| openclaw agents list | 显示系统内所有的智能体列表 | |
| openclaw agents add | 创建一个新的智能体实例 | |
| openclaw agents delete | 删除指定名称的智能体 | |
| openclaw agents add 智能体名称 --workspace ~/.openclaw/workspace-work | 在指定工作区创建一个新的智能体 | |
| openclaw agent --agent 智能体名称 --message "x" | 通过参数直接向智能体发送任务指令并获取回复 | |

2.4.1列出系统内所有智能体

2.4.2创建一个智能体

2.2.3删除指定名称智能体

2.2.4向指定智能体发消息

2.5网关/核心服务（gateway）

启动、停止、管理OpenClaw的核心网关服务，掌握系统命脉的关键指令集。

|-------------------------------------|------------------|-------------|
| 指令/Command | 功能说明/Description | 备注/Notes |
| openclaw gateway start | 在后台启动网关核心服务 | 核心，正式运行 |
| openclaw gateway stop|restart | 停止或重启网关服务 | |
| openclaw gateway status | 查看网关服务的运行状态 | 高频，检查服务是否正常 |
| openclaw gateway run [--verbose] | 在前台运行网关并输出日志 | 调试用，不推荐生产环境 |
| openclaw gateway install|uninstall | 将网关安装和卸载为系统级服务 | 推荐，实现开机自启 |

2.6日志 /调试

查看、过滤和实时监控系统运行日志，快速定位问题根源

|-------------------------|------------------|------------|
| 指令/Command | 功能说明/Description | 备注/Notes |
| openclaw logs | 查看系统过去的运行日志 | 核心，正式运行 |
| openclaw logs --follow | 实时滚动显示最新的系统日志 | 高频，调试和监控必备 |
| openclaw logs --error | 过滤并仅显示报错信息 | |
| openclaw logs --gateway | 过滤并仅显示网关或频道相关的日志 | |

2.7健康检查/修复

运行系统诊断、检查依赖项、验证配置文件

|---------------------------|----------------------|--------------|
| 指令/命令 | 功能说明 | 备注/使用要点 |
| openclaw doctor [--fix] | 运行全面的系统环境诊断，并可尝试自动修复 | 推荐，系统异常时优先使用 |
| openclaw check | 检查系统的基础依赖项是否存在冲突 | |
| openclaw status | 检查gateway网关整体状态 | |
| openclaw doctor | openclaw doctor | |
| openclaw health | 检查gateway网关健康状态 | |

2.8插件/扩展

安装、卸载、启用或禁用插件及扩展技能，定制openclaw功能

插件管理（Plugins）技能管理（Skills）

|------------------------------------------------------------|-------------------------------|---------|
| 指令/命令 | 功能说明 | 备注/使用要点 |
| openclaw plugins list|install|uninstall|enable|disable | 列出系统插件、安装新插件、卸载旧插件，或切换插件的启用状态 | |
| openclaw skills list|openclaw skills info | 列出系统扩展技能，查看某个技能的详细信息 | |

2.9浏览器/自动化与工作区

控制自动化浏览器、管理工作区文件

|-------------------------------------------------------------|-----------------------------|-------------------------|
| 指令/命令 | 功能说明 | 备注/使用要点 |
| openclaw browser start|stop|open|screenshot|type|click | 控制浏览器自动化环境，支持启动、停止、截图、输入等操作 | 实现网页操作自动化，需确保浏览器驱动已正确配置 |

3.常用一键组合与易混命令对比

3.1高频场景一键操作指南

|-----------------------------|----------------------------|---------|
| 指令/命令 | 功能说明 | 备注/使用要点 |
| openclaw config ... | 配置网关端口和模型API密钥，初始化系统参数 | |
| openclaw --version | 查看当前openclaw的版本号 | |
| openclaw channels login ... | 登录目标消息平台（如Telegram），建立通讯连接 | |
| openclaw gateway install | 将服务安装为系统后台服务，支持开机自启。 | |
| openclaw gateway start | 正式启动核心网关服务，系统进入运行状态。 | |
| openclaw gateway status | 检查网关服务运行状态，确认进程存活与端口监听 | |
| openclaw logs --follow | 实时监控日志确保正常运转，排查潜在异常。 | |

3.2易错命令辨析与避坑

区分功能相似或名称相近的命令，避免误用

|----------|--------------|---------|-------------|
| /context | 查看当前会话的上下文详情 | /status | 查看系统整体的运行状态 |

|----------------------|-----------------|------------------------|-------------------|
| openclaw gateway run | 在前台运行网关（用于开发测试） | openclaw gateway start | 在后台启动网关服务（用于生产环境） |

4.核心命令速查

4.1核心指令速查表与索引

前端交互（高频）

|---------|-------------|
| /help | 查看帮助文档与命令列表 |
| /status | 检查当前系统运行状态 |
| /reset | 重置当前交互会话上下文 |
| /model | 切换不同的AI模型 |

后台运维（核心）

|-----------------------------------|--------------|
| openclaw --help | 查看CLI帮助 |
| openclaw config | 设置配置参数 |
| openclaw dashboard | 打开控制台（仪表板） |
| openclaw channels login | 渠道登录认证 |
| openclaw gateway start | 启动网关服务 |
| openclaw logs --follow | 实时查看日志 |
| openclaw doctor | 执行快速检查 |
| openclaw status + openclaw health | 检查gate网关健康状态 |

4.2资源获取方式

https://docs.openclaw.ai/zh-CN/cli