命令分类概览
OpenClaw命令分为五大类别，满足不同场景需求
安装、初始化与升级
快速安装OpenClaw、初始化配置、升级到最新版本
核心服务管理
启动、停止、重启OpenClaw网关服务，管理后台运行
日常运维与诊断
查看运行状态、监控日志、诊断问题、健康检查
核心功能配置
配置模型、管理API Key、设置代理、自定义配置
聊天斜杠命令
在聊天界面快速切换模型、清除历史、调整参数
安装、初始化与升级
从零开始，快速部署OpenClaw到你的系统
一键安装命令
OpenClaw最便捷的安装方式是通过npm一键安装，无需复杂配置。 只需一条命令，即可在你的系统中启动完整的AI Agent服务。
- 跨平台支持：Windows、macOS、Linux全平台兼容
- 自动依赖管理：自动安装所需依赖，无需手动处理
- 版本灵活：可选择最新版或指定版本
- 无需配置：默认配置即可满足大部分使用场景
这是最常用的OpenClaw启动命令，适用于：
- 首次体验OpenClaw的用户
- 快速测试和验证功能
- 临时使用场景
- 无需全局安装的场景
将OpenClaw安装为全局命令，适用于：
- 频繁使用OpenClaw的开发者
- 需要在任意位置启动OpenClaw
- 希望避免每次使用npx
在当前目录初始化OpenClaw配置文件，适用于：
- 项目特定的OpenClaw配置
- 团队协作场景
- 需要自定义配置的情况
npx openclaw@latest时，系统会自动下载最新版本的OpenClaw，请确保网络连接稳定。
核心服务管理
控制OpenClaw网关服务的生命周期
网关服务控制中心
OpenClaw的网关服务是整个系统的核心，负责协调所有AI Agent的通信。 掌握网关管理命令，就像掌握了数字龙虾的心脏起搏器。
- 智能启动：自动检测端口占用，智能分配可用端口
- 优雅停止：安全关闭服务，保护正在进行的工作
- 后台运行：支持守护进程模式，脱离终端独立运行
- 状态监控：实时查看服务运行状态和资源使用
| 命令 | 类型 | 功能说明 |
|---|---|---|
| openclaw gateway start | 启动 | 启动OpenClaw网关服务，默认端口18789。支持后台运行，自动检测配置文件。 |
| openclaw gateway stop | 停止 | 优雅停止网关服务，确保当前请求处理完成后再关闭，保护工作进度。 |
| openclaw gateway restart | 重启 | 重启网关服务，应用新配置。等于先stop再start，但更便捷安全。 |
| openclaw gateway status | 状态 | 查看网关服务运行状态，包括端口、PID、运行时间等详细信息。 |
| openclaw gateway logs | 日志 | 查看网关服务日志，支持实时追踪。用于诊断问题和监控服务运行。 |
启动选项：
--port <number>- 指定端口号（默认：18789）--background- 后台运行模式--config <path>- 指定配置文件路径--verbose- 详细输出模式
--background参数启动后台服务时，请确保使用openclaw gateway stop来停止服务，避免直接kill进程导致配置损坏。
日常运维与诊断
监控系统健康，快速定位问题
系统健康监控
日常运维是保证OpenClaw稳定运行的关键。通过诊断命令， 你可以实时了解系统状态，快速定位和解决潜在问题。
- 状态概览：一键查看服务运行状态、版本信息、配置概要
- 日志追踪：实时查看系统日志，支持过滤和搜索
- 性能监控：CPU、内存、网络使用情况一目了然
- 问题诊断：自动检测常见问题并提供解决建议
| 命令 | 类型 | 功能说明 |
|---|---|---|
| openclaw status | 状态 | 显示OpenClaw整体状态，包括网关状态、配置信息、版本号等。 |
| openclaw logs | 日志 | 查看OpenClaw系统日志，支持-f参数实时追踪，--grep参数过滤。 |
| openclaw doctor | 诊断 | 系统健康检查，自动诊断配置问题、依赖问题、网络问题等。 |
| openclaw info | 信息 | 显示系统详细信息，包括安装路径、配置文件位置、缓存目录等。 |
| openclaw --version | 版本 | 显示当前OpenClaw版本号，用于版本确认和兼容性检查。 |
日志选项：
-f, --follow- 实时追踪日志（类似tail -f）--grep <pattern>- 过滤包含指定模式的日志--tail <lines>- 显示最后N行日志（默认：50）--level <level>- 按日志级别过滤（debug/info/warn/error）
openclaw logs -f --grep error可以实时监控错误日志，
配合openclaw doctor诊断命令，可以快速定位90%的常见问题。
核心功能配置与管理
自定义配置，打造专属的AI Agent体验
灵活的配置系统
OpenClaw提供强大的配置管理能力，让你能够根据需求定制AI Agent行为。 从模型选择到API密钥管理，从代理设置到自定义参数，全方位可控。
- 模型管理：轻松切换不同AI模型，支持多模型并行
- 密钥安全：加密存储API密钥，支持多提供商配置
- 代理设置：灵活配置HTTP/HTTPS代理，适配复杂网络环境
- 参数调优：温度、最大token等参数精细控制
| 命令 | 类型 | 功能说明 |
|---|---|---|
| openclaw config | 配置 | 查看和管理OpenClaw配置，支持get/set/list操作，管理全局配置项。 |
| openclaw config set <key> <value> | 设置 | 设置配置项值，如设置默认模型、API密钥、代理地址等。 |
| openclaw config get <key> | 获取 | 获取指定配置项的当前值，用于查看配置状态。 |
| openclaw models | 模型 | 列出所有可用AI模型，显示模型名称、提供商、状态等信息。 |
| openclaw api-key | 密钥 | 管理API密钥，支持添加、删除、列表操作，密钥加密存储。 |
常用配置项：
defaultModel- 设置默认AI模型（如：zai/glm-4.7）temperature- 设置生成温度（0.0-2.0）maxTokens- 设置最大生成token数proxy- 设置HTTP代理地址timeout- 设置请求超时时间（毫秒）
添加API密钥：
- 密钥将被加密存储，安全可靠
- 支持多个提供商的密钥管理
- 可通过list命令查看已添加的密钥
- 支持delete命令删除不再使用的密钥
openclaw api-key命令管理密钥比手动编辑配置文件更安全。
聊天中的斜杠命令
在聊天界面快速操作，提升交互效率
即时命令系统
在与OpenClaw对话时，使用斜杠命令可以快速执行各种操作， 无需离开聊天界面，让工作流更加顺畅高效。
- 快速切换：无需退出聊天即可切换模型或调整参数
- 会话管理：清除历史、重置会话，一键操作
- 参数调整：实时修改温度、token限制等生成参数
- 智能提示：输入/自动显示可用命令列表
| 命令 | 类型 | 功能说明 |
|---|---|---|
| /model | 模型 | 切换AI模型，可输入模型名称或从列表中选择。支持模糊搜索。 |
| /clear | 清除 | 清除当前会话历史，重新开始对话。不会影响已保存的配置。 |
| /reset | 重置 | 重置会话到初始状态，包括清除历史、恢复默认参数。 |
| /temperature | 参数 | 调整生成温度，值越高输出越随机，值越低输出越确定。 |
| /maxtokens | 参数 | 设置最大生成token数，控制响应长度。0表示不限制。 |
| /help | 帮助 | 显示所有可用斜杠命令及其用法，快速查阅帮助信息。 |
| /save | 保存 | 保存当前会话历史到文件，支持markdown格式导出。 |
| /system | 系统 | 设置系统提示词，自定义AI Agent的行为和角色定位。 |
模型切换说明：
- 支持完整模型名称（如：zai/glm-4.7）
- 支持模糊搜索（输入glm即可匹配glm-4.7）
- 不输入参数时显示可用模型列表
- 切换后立即生效，影响后续所有对话
/后会自动显示命令列表，
可以使用上下键选择历史命令，Tab键补全命令名称，大大提升操作效率。
快捷键参考
常用快捷键，提升操作效率
常见问题
命令使用过程中的常见问题与解决方法
使用以下命令查看运行状态：
该命令会显示网关服务状态、进程ID、端口号等详细信息。
使用以下命令指定其他端口：
或者先停止占用端口的进程，再启动OpenClaw。
两种方式切换模型：
使用日志命令并过滤错误信息：
-f参数实时追踪，--grep参数过滤包含"error"的日志行。
openclaw doctor命令进行系统诊断，
或访问OpenClaw社区寻求帮助。提供详细的日志和错误信息可以获得更有效的支持。