OpenClaw 命令速查手册

OpenClaw 命令速查手册（A4 单页可打印版）

兼容版本：OpenClaw / PicoClaw / ZeroClaw / losterAI / EasyClaw | 核心指令汇总 | 极简设计无冗余

本手册旨在帮助用户快速掌握 OpenClaw 核心操作指令，避免在众多命令中耗费时间查找。所有高频命令尽在于此，助您即刻上手。

一、终端（CLI）核心命令

终端命令行是控制 OpenClaw 的基础，请优先掌握以下几个最常用的操作。

1. 基础操作（最高频）

无论是刚入门的新用户，还是资深开发者，下面这些命令都将是日常工作中接触最频繁的。

openclaw --version   # 查看当前安装的 OpenClaw 版本
openclaw --help      # 显示完整的命令帮助文档
openclaw tui         # 启动终端交互界面（新手推荐从此开始）
openclaw restart     # 重启 OpenClaw 核心服务进程
openclaw stop        # 停止当前正在运行的服务
openclaw update      # 一键更新 OpenClaw 至最新稳定版
openclaw status      # 检查核心服务的实时运行状态
openclaw logs        # 查看详细运行日志（用于故障诊断）

2. 配置与故障排除

当遇到系统配置或运行异常时，无需慌张。按顺序执行以下命令，可解决绝大多数常见问题。

openclaw onboard     # 首次使用时的引导式初始化配置
openclaw configure   # 重新运行配置向导以修改设置
openclaw doctor      # 执行全面的系统健康状态检查（排查问题第一步）
openclaw doctor --fix # 系统检查并自动修复可识别的问题

3. 模型管理（核心功能）

大语言模型的切换与管理是 OpenClaw 的核心，直接决定了智能体的“大脑”能力和性能表现。

openclaw models list                     # 展示所有已配置的 AI 模型
openclaw models list -p <厂商>          # 按供应商筛选模型（例如：-p ollama）
openclaw models set <模型名>            # 切换系统默认使用的模型（如 bailian/qwen3-max）
openclaw models unconfigure <模型>      # 移除某个不需要的模型配置
openclaw models auth paste-token --provider <厂商> # 为指定供应商粘贴配置API密钥

4. 网关与通道管理

网关是核心处理引擎，通道是连接外部平台（如办公软件）的桥梁，二者协同工作至关重要。

# 网关管理（核心引擎控制）
openclaw gateway                # 启动网关服务
openclaw gateway restart        # 重启网关服务

# 通道管理（对接飞书、钉钉等平台）
openclaw channels status        # 查看所有已配置通道的运行状态
openclaw channels list          # 列出所有可用的通道配置
openclaw channels add           # 以交互方式添加一个新的通道
openclaw channels remove --channel <名称> # 移除指定的通道配置

5. 插件与技能扩展

想让您的 OpenClaw 机器人功能更强大？通过安装插件和社区技能来扩展其能力。

openclaw plugins list          # 查看所有已安装及可用的插件
openclaw plugins enable <插件名> # 启用指定插件（例如：feishu）
openclaw plugins disable <插件名> # 暂时禁用指定插件
clawhub search <关键词>       # 在社区技能市场搜索相关技能
clawhub install <技能名>       # 安装来自社区的技能包

二、聊天斜杠命令（在对话窗口中直接使用）

此部分功能强大，允许您在不离开聊天界面的情况下，直接控制智能体，极大提升操作效率。

/model               # 显示当前对话正在使用的大模型
/model <模型名>     # 在当前会话中实时切换模型（例如：/model gpt-4o）
/models              # 列出当前会话可用的所有已配置模型
/new                 # 开启一个全新的会话（清空当前上下文历史）
/new <任务>         # 新建会话并直接发送初始任务指令
/compact             # 压缩当前会话上下文，以节省 Token 消耗
/status              # 查看当前会话状态，包括 Token 使用量等信息
/cost                # 估算本次对话产生的 Token 消耗及对应费用
/skills              # 显示当前已加载并激活的所有技能
/approve             # 批准智能体（Agent）提出的待确认操作请求
/deny                # 拒绝智能体（Agent）提出的待确认操作请求
/cancel              # 取消当前正在执行中的任务
/undo                # 撤销上一次执行的操作

三、常用组合命令（实战工作流）

掌握基础后，通过以下组合命令可以形成高效的工作流程，大幅提升日常运维和问题处理的效率。

# 标准故障排查流程（建议按顺序执行）
openclaw doctor → openclaw logs → openclaw status --deep → openclaw restart

# 快速切换模型实战
openclaw models list -p openai → openclaw models set openai/gpt-4o

# 快速部署飞书通道
openclaw plugins enable feishu → openclaw channels add --channel feishu

以上即为 OpenClaw 最常用、最核心的命令大全。建议将此页打印出来或置于手边，在需要时快速查阅，可显著提升您的工作与开发效率。