OpenClaw 常用命令

命令行完全指南 - 掌握命令行，掌控你的数字龙虾

---

命令分类概览

OpenClaw命令分为五大类别，满足不同场景需求

🚀 安装、初始化与升级

• 快速安装OpenClaw、初始化配置、升级到最新版本
• npx openclaw@latest
• openclaw init

🏗️ 核心服务管理

• 启动、停止、重启OpenClaw网关服务，管理后台运行
• openclaw gateway start
• openclaw gateway stop

🩺 日常运维与诊断

• 查看运行状态、监控日志、诊断问题、健康检查
• openclaw status
• openclaw logs

⚙️ 核心功能配置

• 配置模型、管理API Key、设置代理、自定义配置
• openclaw config
• openclaw models

💬 聊天斜杠命令

• 在聊天界面快速切换模型、清除历史、调整参数
• /model
• /clear

---

1. 安装、初始化与升级

🚀 一键安装命令

OpenClaw最便捷的安装方式是通过npm一键安装，无需复杂配置。只需一条命令，即可在你的系统中启动完整的AI Agent服务。

• 跨平台支持：Windows、macOS、Linux全平台兼容
• 自动依赖管理：自动安装所需依赖，无需手动处理
• 版本灵活：可选择最新版或指定版本
• 无需配置：默认配置即可满足大部分使用场景

核心命令

npx openclaw@latest

类型：核心命令

这是最常用的OpenClaw启动命令，适用于：

• 首次体验OpenClaw的用户
• 快速测试和验证功能
• 临时使用场景
• 无需全局安装的场景

可选参数：--version | --help | --port

npm install -g openclaw

类型：全局安装

将OpenClaw安装为全局命令，适用于：

• 频繁使用OpenClaw的开发者
• 需要在任意位置启动OpenClaw
• 希望避免每次使用npx

openclaw init [options]

类型：初始化配置

在当前目录初始化OpenClaw配置文件，适用于：

• 项目特定的OpenClaw配置
• 团队协作场景
• 需要自定义配置的情况

参数选项：--force | --config <path> | --default

💡 提示：首次运行npx openclaw@latest时，系统会自动下载最新版本的OpenClaw，请确保网络连接稳定。

---

2. 核心服务管理

🏗️ 网关服务控制中心

OpenClaw的网关服务是整个系统的核心，负责协调所有AI Agent的通信。掌握网关管理命令，就像掌握了数字龙虾的心脏起搏器。

• 智能启动：自动检测端口占用，智能分配可用端口
• 优雅停止：安全关闭服务，保护正在进行的工作
• 后台运行：支持守护进程模式，脱离终端独立运行
• 状态监控：实时查看服务运行状态和资源使用

命令列表

命令	类型	功能说明
openclaw gateway start	启动	启动OpenClaw网关服务，默认端口18789。支持后台运行，自动检测配置文件。
openclaw gateway stop	停止	优雅停止网关服务，确保当前请求处理完成后再关闭，保护工作进度。
openclaw gateway restart	重启	重启网关服务，应用新配置。等于先stop再start，但更便捷安全。
openclaw gateway status	状态	查看网关服务运行状态，包括端口、PID、运行时间等详细信息。
openclaw gateway logs	日志	查看网关服务日志，支持实时追踪。用于诊断问题和监控服务运行。

openclaw gateway start [options]

启动选项：

• --port <number> - 指定端口号（默认：18789）
• --background - 后台运行模式
• --config <path> - 指定配置文件路径
• --verbose - 详细输出模式

⚠️ 注意：使用--background参数启动后台服务时，请确保使用openclaw gateway stop来停止服务，避免直接kill进程导致配置损坏。

---

3. 日常运维与诊断

🩺 系统健康监控

日常运维是保证OpenClaw稳定运行的关键。通过诊断命令，你可以实时了解系统状态，快速定位和解决潜在问题。

• 状态概览：一键查看服务运行状态、版本信息、配置概要
• 日志追踪：实时查看系统日志，支持过滤和搜索
• 性能监控：CPU、内存、网络使用情况一目了然
• 问题诊断：自动检测常见问题并提供解决建议

命令列表

命令	类型	功能说明
openclaw status	状态	显示OpenClaw整体状态，包括网关状态、配置信息、版本号等。
openclaw logs	日志	查看OpenClaw系统日志，支持-f参数实时追踪，–grep参数过滤。
openclaw doctor	诊断	系统健康检查，自动诊断配置问题、依赖问题、网络问题等。
openclaw info	信息	显示系统详细信息，包括安装路径、配置文件位置、缓存目录等。
openclaw --version	版本	显示当前OpenClaw版本号，用于版本确认和兼容性检查。

openclaw logs [-f] [–grep ] [–tail ]

日志选项：

• -f, --follow - 实时追踪日志（类似tail -f）
• --grep <pattern> - 过滤包含指定模式的日志
• --tail <lines> - 显示最后N行日志（默认：50）
• --level <level> - 按日志级别过滤（debug/info/warn/error）

💡 运维技巧：使用openclaw logs -f --grep error可以实时监控错误日志，配合openclaw doctor诊断命令，可以快速定位90%的常见问题。

---

4. 核心功能配置与管理

⚙️ 灵活的配置系统

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密钥，支持添加、删除、列表操作，密钥加密存储。

openclaw config set

常用配置项：

• defaultModel - 设置默认AI模型（如：zai/glm-4.7）
• temperature - 设置生成温度（0.0-2.0）
• maxTokens - 设置最大生成token数
• proxy - 设置HTTP代理地址
• timeout - 设置请求超时时间（毫秒）

openclaw api-key add

添加API密钥：

• 密钥将被加密存储，安全可靠
• 支持多个提供商的密钥管理
• 可通过list命令查看已添加的密钥
• 支持delete命令删除不再使用的密钥

⚠️ 安全提示：API密钥是访问AI服务的关键凭证，请妥善保管。不要在公共场合或版本控制中暴露密钥。使用openclaw api-key命令管理密钥比手动编辑配置文件更安全。

---

5. 聊天中的斜杠命令

💬 即时命令系统

在与OpenClaw对话时，使用斜杠命令可以快速执行各种操作，无需离开聊天界面，让工作流更加顺畅高效。

• 快速切换：无需退出聊天即可切换模型或调整参数
• 会话管理：清除历史、重置会话，一键操作
• 参数调整：实时修改温度、token限制等生成参数
• 智能提示：输入/自动显示可用命令列表

命令列表

命令	类型	功能说明
/model	模型	切换AI模型，可输入模型名称或从列表中选择。支持模糊搜索。
/clear	清除	清除当前会话历史，重新开始对话。不会影响已保存的配置。
/reset	重置	重置会话到初始状态，包括清除历史、恢复默认参数。
/temperature	参数	调整生成温度，值越高输出越随机，值越低输出越确定。
/maxtokens	参数	设置最大生成token数，控制响应长度。0表示不限制。
/help	帮助	显示所有可用斜杠命令及其用法，快速查阅帮助信息。
/save	保存	保存当前会话历史到文件，支持markdown格式导出。
/system	系统	设置系统提示词，自定义AI Agent的行为和角色定位。

/model 使用示例

模型切换说明：

• 支持完整模型名称（如：zai/glm-4.7）
• 支持模糊搜索（输入glm即可匹配glm-4.7）
• 不输入参数时显示可用模型列表
• 切换后立即生效，影响后续所有对话

💡 使用技巧：在聊天界面输入/后会自动显示命令列表，可以使用上下键选择历史命令，Tab键补全命令名称，大大提升操作效率。

---

快捷键参考

快捷键	功能
Ctrl + C	中断当前请求/复制选中内容
Ctrl + L	清屏/清除会话历史
↑ / ↓	浏览历史命令
Tab	自动补全命令/参数
Ctrl + D	退出OpenClaw会话
Ctrl + Z	挂起当前进程

---

常见问题

Q: 如何查看OpenClaw是否正在运行？

使用以下命令查看运行状态：

openclaw status

该命令会显示网关服务状态、进程ID、端口号等详细信息。

Q: 端口被占用怎么办？

使用以下命令指定其他端口：

openclaw gateway start --port 18888

或者先停止占用端口的进程，再启动OpenClaw。

Q: 如何切换到不同的AI模型？

两种方式切换模型：

# 方式1：配置命令
openclaw config set defaultModel zai/glm-4.7

# 方式2：聊天斜杠命令
/model zai/glm-4.7

Q: 如何查看详细的错误日志？

使用日志命令并过滤错误信息：

openclaw logs -f --grep error

-f参数实时追踪，–grep参数过滤包含"error"的日志行。

🚫 重要提醒：如果遇到无法解决的问题，可以使用openclaw doctor命令进行系统诊断，或访问OpenClaw社区寻求帮助。提供详细的日志和错误信息可以获得更有效的支持。

---

© 2026 OpenClaw 教程 - 掌握AI Agent的未来

🦞 让AI Agent成为你的得力助手

---

📚 教程导航

第一篇：OpenClaw 完整介绍——开源 AI 智能体平台

• 了解整个教程的规划和学习顺序，从入门到精通的完整路径

第二篇：OpenClaw 是什么？ 开源AI智能体平台

• 了解 OpenClaw 是什么，它的核心特性和技术架构

第三篇：OpenClaw能做什么？ AI能力全解与实战案例

• 深入了解 OpenClaw 的强大功能，包含丰富的实战示例

第四篇：OpenClaw安装配置指南 - 开始养你的数字“龙虾“

• 手把手教您安装和配置 OpenClaw，包含故障排除

第五篇：OpenClaw安全指南 - 了解风险，安全使用 AI Agent

• 了解安全风险和防护措施，安全使用 OpenClaw

第六篇：OpenClaw 常用命令 - 掌握命令行，掌控你的数字龙虾

• 掌握命令行，掌控你的数字龙虾

第七篇：OpenClaw 实战示例 -掌握 AI Agent 的强大能力

• 从入门到精通的实践指南 - 30+ 实战示例，掌握 AI Agent 的强大能力

第八篇：开箱即用版（更新中…）

• 附加内容 | 便携版
• 下载便携版 EXE，无需安装即可使用

---

光影8号，与您一起分享，一起成长！

https://www.guangying8hao.vip