OpenClaw最全命令合集|新手收藏版,所有常用命令一次搞定

整理OpenClaw最全命令合集，按12大场景分类，命令+核心说明，新手可直接复制使用✅

前置小提醒

命令适配云端/本地，复制到终端（Mac/Linux）或PowerShell（Windows）执行；
Mac/Linux加sudo，Windows以管理员身份打开PowerShell；
[]内内容需替换，按自身环境调整；
报错可执行openclaw logs --error排查，或用openclaw doctor --fix修复；
建议直接复制使用。

一、基础信息/帮助命令（新手入门必看）

核心用途：查看版本、获取帮助，快速熟悉工具。

1. 查看OpenClaw版本

命令：openclaw --version

说明：查看版本，排查兼容/功能异常。

2. 查看所有命令帮助

命令：openclaw --help

说明：列出所有命令及简要说明，忘记命令时使用。

3. 简化版帮助查看

命令：openclaw help

说明：仅显示核心命令，快速查询使用。

4. 查看指定命令的详细帮助

命令：openclaw help [命令]

说明：替换[命令]，查看详细用法及参数，不熟悉参数时使用。

二、首次安装/初始化命令（新环境部署必备）

核心用途：完成安装、依赖配置及初始化，替代手动操作。

1. 安装所需依赖

命令：openclaw install

说明：一键安装全系统运行依赖，首次本地部署使用。

2. 全流程引导配置

命令：openclaw onboard

说明：引导完成模型关联、频道绑定，首次部署后启用。

3. 强制重新初始化

命令：openclaw onboard --force

说明：强制重置配置，重新引导，配置出错时使用。

三、配置系统(config)命令（核心配置必用）

核心用途：查看、设置、重置各项配置，按需调整。

（一）查看配置

1. 查看所有配置列表

命令：openclaw config list

说明：查看所有配置简要列表，排查配置正确性。

2. 查看全部配置详情

命令：openclaw config get all

说明：查看所有配置详细参数，排查配置异常。

3. 查看网关配置

命令：openclaw config get gateway

说明：查看网关端口、主机地址，网关异常时使用。

4. 查看模型配置

命令：openclaw config get models

说明：查看模型API密钥、基础地址，模型调用失败时使用。

5. 查看频道配置

命令：openclaw config get channels

说明：查看已绑定频道类型、状态，频道绑定失败时使用。

6. 查看智能体配置

命令：openclaw config get agents

说明：查看智能体默认设置、关联模型，智能体异常时使用。

（二）设置配置

1. 设置网关端口

命令：openclaw config set gateway.port 18789

说明：设置网关端口（可替换），需重启网关，默认端口被占用时使用。

2. 设置网关主机（允许外部访问）

命令：openclaw config set gateway.host 0.0.0.0

说明：允许外部设备远程访问，需远程操作时使用。

3. 设置主智能体模型

命令：openclaw config set agents.main.model "claude-3-5-sonnet"

说明：设置默认主智能体模型（可替换），更换默认模型时使用。

4. 设置OpenAI API密钥

命令：openclaw config set models.openai.api_key "sk-xxxx"

说明：替换密钥，确保OpenAI模型正常调用，首次关联或更换密钥时使用。

5. 设置OpenAI基础地址

命令：openclaw config set models.openai.base_url "https://api.openai.com/v1"

说明：设置访问地址，官方不可用时可替换为代理。

（三）取消/重置配置

1. 取消网关端口配置

命令：openclaw config unset gateway.port

说明：取消手动设置，恢复默认端口，需重启网关，手动端口异常时使用。

2. 重置所有配置为默认值

命令：openclaw config reset

说明：重置所有配置，需重新配置，配置混乱时使用。

四、模型管理(models)命令（管理关联模型）

核心用途：查看、添加、删除、设置默认模型，确保可用。

1. 查看所有已关联模型

命令：openclaw models list

说明：列出已关联模型名称、类型，忘记已关联模型时使用。

2. 查看模型运行状态

命令：openclaw models status

说明：显示模型可用/不可用状态，模型调用失败时排查。

3. 扫描可关联的模型

命令：openclaw models scan

说明：自动扫描可关联的本地、在线模型，关联新模型时使用。

4. 探测模型可用性

命令：openclaw models probe

说明：探测已关联模型可用性，输出结果，排查调用失败原因。

5. 设置默认模型

命令：openclaw models set default "gpt-4o"

说明：设置默认模型（可替换），常用某一模型时使用。

6. 添加OpenAI模型

命令：openclaw models add openai --api_key sk-xxxx --base_url https://...

说明：替换密钥和地址，添加后即可调用，首次关联时使用。

7. 删除已关联的OpenAI模型

命令：openclaw models remove openai

说明：删除后无法调用，需重新添加，不再使用时使用。

五、频道/机器人登录(channels)命令（管理登录状态）

核心用途：管理频道登录、登出及状态，确保可通过频道操作。

1. 查看所有已配置频道

命令：openclaw channels list

说明：列出已配置频道及绑定状态，排查绑定问题时使用。

2. 查看频道运行状态

命令：openclaw channels status

说明：显示频道在线/离线状态，无法通过频道操作时使用。

3. 探测频道连接状态

命令：openclaw channels probe

说明：探测频道连接状态，排查异常，频道在线但无法操作时使用。

4. 频道登录命令

命令：openclaw channels login [telegram/discord/whatsapp/gq/slack]

说明：按需选择频道，按提示登录，首次登录或重新登录时使用。

5. 频道登出命令

单个登出：openclaw channels logout 目标频道

全部登出：openclaw channels logout all

说明：登出后无法通过该频道操作，更换账号、安全退出时使用。

六、智能体/Agent命令（创建、管理智能体）

核心用途：创建、删除、切换智能体，提升操作效率。

1. 查看所有智能体

命令：openclaw agent list

说明：列出已创建智能体及默认状态，忘记名称或切换时使用。

2. 创建智能体

命令：openclaw agent create myagent

说明：创建自定义名称智能体，可后续配置模型，需不同功能时使用。

3. 删除智能体

命令：openclaw agent delete myagent

说明：删除智能体及关联配置，无法恢复，不再使用时使用。

4. 切换默认智能体

命令：openclaw agent use main

说明：切换默认智能体（可替换），生效后用于交互，需切换功能时使用。

5. 与默认智能体交互

聊天测试：openclaw agent chat "内容"

发送指令：openclaw agent --message "指令"

说明：测试可用性或让智能体完成任务，提升操作效率。

七、网关/核心服务(gateway)命令（管理核心服务）

核心用途：管理网关启停、调试及开机自启，保障工具运行。

1. 网关启停/重启

命令：启动openclaw gateway start

停止openclaw gateway stop

重启openclaw gateway restart

说明：启动启用所有功能，停止终止操作，重启解决异常，电脑重启或网关异常时使用。

2. 查看网关状态

命令：openclaw gateway status

说明：显示网关运行/停止状态，指令无反应时优先排查。

3. 前台调试运行

命令：详细日志openclaw gateway run --verbose

指定端口openclaw gateway run --port 18789

说明：前台运行显日志或指定端口，网关无法启动、异常时排查。

4. 系统服务配置（开机自启）

命令：安装openclaw gateway install

卸载openclaw gateway uninstall

说明：安装后开机自启，卸载后需手动启动，希望自动启动时使用。

八、日志/调试命令（排查运行异常）

核心用途：查看日志、筛选错误，快速排查异常。

1. 日志查看命令

命令：所有日志openclaw logs

实时日志openclaw logs -f

错误日志openclaw logs --error

说明：分别用于排查复杂异常、实时异常、快速定位错误。

2. 分类日志查看

命令：网关日志openclaw logs --gateway

频道日志openclaw logs --channels

说明：筛选对应模块日志，排查网关、频道异常。

九、健康检查/修复命令（自动排查+修复）

核心用途：自动检查并修复常见异常，新手必备。

1. 健康检查

命令：检测不修复openclaw doctor

简易检测openclaw check

说明：前者输出异常信息，后者快速检测核心组件，了解异常时使用。

2. 自动修复/验证

命令：自动修复openclaw doctor --fix

验证配置openclaw validate

说明：前者修复常见异常（需重启），后者验证配置及服务可用性，修改配置后使用。

十、插件/扩展命令（扩展工具功能）

核心用途：管理插件和技能，扩展功能，适配更多场景。

（一）插件管理

命令：查看openclaw plugins list

安装openclaw plugins install [插件名/路径]

卸载openclaw plugins uninstall [插件名]

启用/禁用openclaw plugins enable/disable [插件名]

说明：按需管理插件，扩展功能或解决插件异常。

（二）技能管理

命令：查看openclaw skills list

启用/禁用openclaw skills enable/disable [技能]

说明：管理技能状态，适配需求，避免占用资源。

十一、浏览器/自动化能力命令（控制浏览器自动化）

核心用途：控制浏览器自动化操作，扩展工具功能。

1. 浏览器启停

命令：启动openclaw browser start

停止openclaw browser stop

说明：启动后可执行自动化操作，停止后终止，自动化操作前使用。

2. 浏览器自动化操作

命令：打开网页openclaw browser open 网址

截图openclaw browser screenshot

输入内容openclaw browser type "内容"

点击按钮openclaw browser click "按钮文字"

说明：按需执行自动化操作，适配表单填写、网页截取等场景。

十二、工作区/文件命令（管理工作区）

核心用途：管理工作区，清理缓存，确保整洁。

1. 工作区管理命令

命令：查看列表openclaw workspace list

清理缓存openclaw workspace clean

查看路径openclaw workspace path

说明：分别用于查看工作区分布、释放内存、查找工作区文件，工具卡顿或找文件时使用。

记得星标「小马AI学习笔记」，不用错过每一篇实用的AI学习笔记。