OpenClaw 新手入门核心命令指南
OpenClaw 作为一款功能强大的工具,其命令行接口(CLI)提供了高效的操作方式。对于新手而言,掌握核心的安装配置、服务管理及日常会话命令是快速上手的关键。本文将按照安装准备、核心服务管理、日常会话操作及故障排查的逻辑,系统梳理最常用的高频命令,帮助用户规避常见操作误区,顺畅使用 OpenClaw。
01安装准备与环境初始化
- 使用 onboarding 交互式向导
在首次安装或部署新环境时,使用openclaw onboard命令启动交互式全向导,可引导完成基础配置。 - 安装依赖与诊断系统
执行openclaw install安装所需依赖。若遇到系统异常或报错,运行openclaw doctor可一键诊断并尝试修复问题。 - 版本确认与帮助查询
通过openclaw -v快速查看当前版本,使用openclaw help在忘记命令时查阅所有可用命令及基础用法。
02核心服务管理
Gateway 是 OpenClaw 的核心服务,掌握其基础启停操作是使用工具的前提。在首次使用或系统重启后,必须手动启动服务。
- 启动服务
执行openclaw gateway start启动核心服务。 - 状态检查
使用openclaw gateway status确认服务是否处于正常运行状态。 - 服务重启
当服务出现异常时,运行openclaw gateway restart进行重启。
03日常会话与模型操作
在日常使用中,会话管理和模型切换是最高频的操作。除了 CLI 命令外,聊天界面也提供了便捷的斜杠命令。
| 操作类型 | 命令/指令 | 功能说明 |
|---|---|---|
| CLI 会话管理 | openclaw sessions list | 查看所有活跃会话 |
| 聊天界面帮助 | /help | 查看聊天界面可用斜杠命令 |
| 创建新会话 | /new | 创建新会话,开始新任务 |
| 中止任务 | /stop | 中止当前正在执行的任务 |
| 切换模型 | /model <模型名> | 切换当前会话使用的 AI 模型 |
| 查看配置 | openclaw config list | 查看所有配置(简洁版) |
| 查看可用模型 | openclaw models list | 查看所有可用 AI 模型 |
| 配置 API 密钥 | openclaw models auth setup-token | 配置 AI 模型 API 密钥 |
日常操作命令对照表
04故障排查与注意事项
- 错误日志定位
当命令执行失败时,使用openclaw logs --error仅查看错误日志,快速定位问题根源。 - 新手避坑要点
1. 确保所有命令在终端或命令行中执行,且 OpenClaw 已正确安装。
2. 修改配置后,必须重启 Gateway 才能使配置生效。
3. 遇到执行失败的情况,优先使用openclaw help查询对应命令的正确用法。
当前文章无评论,是时候发表评论了