OpenClaw常用操作命令完整速查手册:从入门到精通的终端 CLI & 聊天指令全解析

PicoClaw / ZeroClaw / losterAI / EasyClaw 系列开源 AI 应用必备指令指南|开发者效率提升 300% 的秘籍


🔥 导语:为什么你需要这份命令手册?

想象一下这样的场景:凌晨两点,你刚部署好 OpenClaw 准备对接飞书机器人,却发现网关怎么都连不上;或者你想快速切换到大模型处理复杂任务,却忘了具体的命令格式……

作为 OpenClaw 生态(包括 PicoClaw、ZeroClaw、losterAI、EasyClaw 等系列开源应用)的核心用户,我根据开源资料和个人使用体验整理了这份全网最全的命令速查手册。无论你是刚接触的新手,还是已经玩转过各种 AI Agent 的资深开发者,这份指南都能让你:

5 分钟快速定位任何操作指令
告别百度/Google反复搜索的低效循环
掌握高级技巧,让 OpenClaw 成为你的超级生产力工具

建议立即收藏本文,下次遇到问题时直接 Ctrl+F 搜索,效率提升肉眼可见!

在这里插入图片描述

文章目录


📋 命令分类总览

OpenClaw 的命令体系分为两大核心类别

类型 使用场景 输入方式
🖥️ 终端 CLI 命令 系统配置、服务管理、故障排查 在 Terminal / CMD / PowerShell 中输入
💬 聊天斜杠命令 会话控制、模型切换、任务执行 在 OpenClaw 对话窗口中输入 / 开头

第一部分:🖥️ 终端 CLI 命令详解

所有 CLI 命令统一格式:openclaw <命令> [参数]

一、基础操作(每日必用 ⭐⭐⭐)

命令 功能说明 典型使用场景
openclaw --version 查看当前安装版本 确认安装成功或检查是否需要更新
openclaw --help 显示所有可用命令列表 忘记具体命令时快速查阅
openclaw tui 启动终端交互界面 **新手最推荐!**无需记忆复杂命令,图形化操作
openclaw dashboard 打开网页管理控制台 习惯浏览器操作的用户首选
openclaw restart 重启 OpenClaw 服务 修改配置后必须执行!
openclaw stop 停止运行中的服务 临时暂停或关机前操作
openclaw update 一键更新到最新版本 获取新功能和安全补丁

💡 Pro Tipopenclaw tui 是隐藏宝藏命令,提供可视化界面,比纯命令行友好 10 倍!


二、安装与初始化(首次使用必看)

命令 功能说明 进阶用法
openclaw onboard 启动交互式配置向导 首次安装后引导你完成所有设置
openclaw onboard --install-daemon 配置向导 + 安装为系统服务 实现开机自启,服务器部署必备
openclaw configure 重新进入配置向导 随时修改 API Key、模型偏好等设置

🔧 配置流程示例

# 第1步:启动向导
openclaw onboard

# 第2步:按提示输入模型提供商(如 OpenAI/Claude/通义千问)
# 第3步:输入 API Key
# 第4步:选择默认模型
# 第5步:完成!

三、诊断与排错(出问题先跑这个 ⭐⭐⭐)

命令 功能说明 使用时机
openclaw doctor 全面健康检查 遇到任何问题,先跑这个!
openclaw doctor --fix 健康检查 + 自动修复 让系统尝试自动解决常见问题
openclaw status 查看运行状态(网关在线状态、端口占用) 检查服务是否正常启动
openclaw status --deep 深度状态检测(含网关健康探测) 网络连接异常时深度排查
openclaw logs 查看最近运行日志 查看错误堆栈信息

🚨 故障排查标准流程

# 第1步:全面体检
openclaw doctor

# 第2步:查看错误日志
openclaw logs

# 第3步:检查详细状态
openclaw status --deep

# 第4步:尝试自动修复
openclaw doctor --fix

# 第5步:重启服务
openclaw restart

四、模型管理(多模型切换核心)

命令 功能说明 示例
openclaw models list 列出所有已配置的模型 查看可用模型清单
openclaw models set <提供商/模型名> 切换默认模型 快速切换不同 AI 引擎
openclaw models auth login --provider <提供商> OAuth 方式登录模型商 支持 Claude、GPT、千问等
openclaw models auth paste-token --provider <提供商> 粘贴 API Token 认证 直接输入 Key 认证

🔄 模型切换实战示例

# 切换到阿里百炼千问模型
openclaw models set bailian/qwen3-max-2026-01-23

# 切换到 MiniMax 模型
openclaw models set minimax/MiniMax-M2.1

# 切换到 Claude 3.5 Sonnet
openclaw models set anthropic/claude-3-5-sonnet-20241022

# 查看当前在用哪个模型
openclaw models list

五、网关 Gateway 管理(核心引擎)

Gateway 是 OpenClaw 的心脏,负责所有通信调度。

命令 功能说明 适用场景
openclaw gateway 启动网关服务 手动启动网关
openclaw gateway --port 18789 指定端口启动 默认端口被占用时
openclaw gateway --verbose 启动并显示详细日志 调试模式,排查连接问题
openclaw gateway restart 重启网关 配置变更后生效
openclaw gateway --token <你的token> 带认证 Token 启动 安全加固场景

六、聊天通道 Channel 管理(对接微信/飞书/钉钉)

通道 = OpenClaw 与外部聊天平台的桥梁

命令 功能说明 备注
openclaw channels status 查看所有通道实时状态 绿色=正常,红色=异常
openclaw channels list 列出已配置的所有通道 查看已接入的平台
openclaw channels add 交互式添加新通道 向导式配置,新手友好
openclaw channels add --channel telegram --token <BOT_TOKEN> 非交互式添加 Telegram 自动化部署脚本使用
openclaw channels add --channel feishu 添加飞书通道 需提前安装 feishu 插件
openclaw channels remove --channel <名称> 移除指定通道 清理不再使用的连接
openclaw channels logs 查看通道日志 排查消息收发问题
openclaw channels login 登录通道(如 WhatsApp Web 扫码) 需要交互认证的平台
openclaw channels logout 登出通道 切换账号或安全退出

📱 支持的平台列表

whatsapp | telegram | discord | slack | googlechat 
| signal | imessage | msteams | mattermost | feishu	(需插件)

🎯 快速接入飞书示例

# 第1步:确保已启用飞书插件
openclaw plugins enable feishu

# 第2步:添加飞书通道(交互式)
openclaw channels add --channel feishu

# 第3步:按提示输入 App ID 和 App Secret
# 完成!

七、插件 Plugin 管理(功能扩展)

命令 功能说明
openclaw plugins list 查看所有可用插件
openclaw plugins enable <插件名> 启用指定插件
openclaw plugins disable <插件名> 禁用指定插件
openclaw plugins install <插件名> 从仓库安装新插件
openclaw plugins doctor 检查插件加载错误

🔌 常用插件操作示例

# 启用飞书接入插件
openclaw plugins enable feishu

# 启用千问认证插件(阿里系模型必备)
openclaw plugins enable qwen-portal-auth

# 登录千问平台并设为默认
openclaw models auth login --provider qwen-portal --set-default

八、技能 Skill 管理(AI 能力扩展)

本地技能管理:
命令 功能说明
openclaw skills list 列出已安装的所有技能
openclaw skills install <技能名> 安装新技能
ClawHub 技能商店(社区生态):
命令 功能说明
clawhub search <关键词> 搜索社区技能(如"爬虫"、“数据分析”)
clawhub install <技能名> 安装社区技能
clawhub list 列出已安装的技能
clawhub sync --all 批量更新所有已安装技能
clawhub update <技能名> 更新指定技能到最新版

🛠️ 技能管理实战

# 搜索数据分析相关技能
clawhub search data-analysis

# 安装找到的技能
clawhub install excel-analyzer

# 更新所有技能
clawhub sync --all

九、消息与配对(高级操作)

命令 功能说明 使用场景
openclaw message send --to <号码> --message "内容" 主动发送消息 系统通知、定时提醒
openclaw agent --message "任务内容" 直接向 Agent 派发任务 后台自动化任务
openclaw agent --message "任务" --thinking high 高思考深度模式 复杂推理任务
openclaw pairing approve <通道> <配对码> 批准设备配对 新设备接入授权

十、沙箱 Sandbox 管理(安全隔离)

Docker 沙箱提供代码执行的安全隔离环境

命令 功能说明
openclaw sandbox explain 查看当前沙箱配置状态
openclaw sandbox explain --json JSON 格式输出(供脚本解析)
openclaw sandbox list 列出所有沙箱容器
openclaw sandbox list --browser 仅查看浏览器相关容器
openclaw sandbox recreate --all 重建所有容器(解决环境问题)
openclaw sandbox recreate --all --force 强制重建(跳过确认提示)

十一、浏览器控制(自动化操作)

命令 功能说明 示例
openclaw browser open <URL> 打开指定网页 openclaw browser open https://github.com
openclaw browser snapshot 获取当前页面 DOM 快照 用于分析页面结构
openclaw browser click <元素> 点击页面元素 自动化测试/爬虫
openclaw browser type <元素> <文字> 在输入框输入文字 自动填写表单
openclaw browser screenshot 截取页面截图 保存可视化证据
openclaw browser close 关闭浏览器实例 清理资源
openclaw browser console 查看浏览器控制台日志 调试 JS 错误

十二、配置文件操作

命令 功能说明
openclaw config 查看当前配置(只读)
openclaw config edit 编辑配置文件(自动打开编辑器)

📝 手动编辑配置文件路径

# Windows 系统
notepad %USERPROFILE%\.openclaw\openclaw.json

# macOS 系统
nano ~/.openclaw/openclaw.json

# Linux 系统
vim ~/.openclaw/openclaw.json

# 快速查看配置内容
cat ~/.openclaw/openclaw.json

十三、更新与维护

命令 功能说明
openclaw update 更新到最新稳定版
openclaw update --channel stable 明确指定稳定版通道
openclaw update --channel beta 切换到测试版(体验新功能)
npm install -g openclaw@latest 通过 npm 强制更新到最新版

第二部分:💬 聊天斜杠命令详解

在 OpenClaw 对话窗口中输入,以 / 开头。

一、会话管理(最常用 ⭐⭐⭐)

命令 功能说明 使用频率
/new 开始全新会话(清除上下文,节省 Token) ⭐⭐⭐
/new 任务描述 新建会话并直接带上任务 ⭐⭐⭐
/compact 压缩上下文(保留要点,大幅减少 Token 消耗) ⭐⭐⭐
/status 查看当前会话状态(Token 用量、模型信息) ⭐⭐
/help/commands 显示所有可用斜杠命令 ⭐⭐

💡 使用技巧

  • 长对话后 Token 消耗剧增?输入 /compact 立即瘦身!
  • 想换个话题?/new 一键清空,比手动删除快 10 倍!

二、模型切换(多模型对比测试)

命令 功能说明
/model 查看当前正在使用的模型
/model <模型名> 实时切换到指定模型

示例

/model claude-3-5-sonnet
/model gpt-4o
/model qwen-max

三、会话历史管理

命令 功能说明
/sessions list 列出所有历史会话
/sessions history 查看当前会话的详细历史
/sessions send <会话ID> <消息> 向指定会话发送消息(跨会话通信)
/sessions spawn <任务> 创建子会话执行独立任务

四、工具与执行控制

命令 功能说明 使用场景
/approve 批准待确认的操作 Agent 请求权限时确认
/deny 拒绝待确认的操作 阻止危险操作
/cancel 取消当前执行中的任务 任务卡死或想中断时
/undo 撤销上一步操作 误操作回滚

五、技能与记忆管理

命令 功能说明
/skills 查看当前已加载的所有技能
/memory 查看 AI 的记忆内容(长期记忆)
/forget <内容> 删除指定的记忆条目

六、信息查询

命令 功能说明
/cost 查看本次会话的 Token 消耗和费用估算
/version 查看当前 OpenClaw 版本
/ping 测试与网关的连接是否正常

第三部分:📁 关键文件路径速查表

路径 说明 重要性
~/.openclaw/openclaw.json 主配置文件(API Key、模型设置) ⭐⭐⭐
~/.openclaw/workspace/ 默认工作目录 ⭐⭐
~/.openclaw/skills/ 全局技能存放目录 ⭐⭐
~/.openclaw/agents/ Agent 数据根目录 ⭐⭐
~/.openclaw/agents/<ID>/USER.md 用户偏好文件(个性化设置) ⭐⭐⭐
~/.openclaw/agents/<ID>/memory/ 长期记忆存储目录 ⭐⭐
~/.openclaw/agents/<ID>/cron/jobs.json 定时任务配置文件
~/.openclaw/agents/<ID>/sessions/ 会话记录存档
~/.openclaw/workspace/AGENTS.md 核心提示词定义文件 ⭐⭐⭐

📝 Windows 用户注意~ 等于 %USERPROFILE%,即 C:\Users\你的用户名


第四部分:🆘 新手急救流程(遇到问题按这个来)

1步:openclaw doctor          ← 全面体检,看哪里出问题
    ↓
第2步:openclaw logs             ← 查看具体错误日志
    ↓
第3步:openclaw status --deep    ← 深度检查服务状态
    ↓
第4步:openclaw doctor --fix     ← 尝试自动修复
    ↓
第5步:openclaw restart          ← 重启服务

⚡ 改配置后的标准操作流程

# 1. 编辑配置文件
nano ~/.openclaw/openclaw.json

# 2. 保存退出 (Ctrl+O, Enter, Ctrl+X)

# 3. 重启服务使配置生效
openclaw restart

🔄 完全重新配置

openclaw configure    # 重新走一遍配置向导

🎯 第五部分:必备命令大全速记法(建议收藏)

🔥 高频命令速记(每天使用)

场景 命令 记忆口诀
开始聊天 openclaw tui Terminal User Interface
查看状态 openclaw status "状态"拼音首字母
检查健康 openclaw doctor 医生检查身体
重启服务 openclaw restart 重新启动
新建会话 /new 新的开始
压缩上下文 /compact 压缩包 compact

🛠️ 故障排查速记

顺序 命令 作用
1 openclaw doctor 看病
2 openclaw logs 查病历
3 openclaw status 量体温
4 openclaw restart 吃药重启
5 openclaw doctor --fix 自动治疗

📱 通道管理速记

操作 命令模式 示例
查看 channels status/list 看状态/看列表
添加 channels add --channel <平台> 加通道
移除 channels remove --channel <名> 删通道

🤖 模型管理速记

操作 命令 记忆点
查看列表 models list 列模型
切换模型 models set <模型> 设模型
登录认证 models auth login 认证登录

🔌 插件技能速记

类型 启用 禁用 安装
插件 plugins enable plugins disable plugins install
技能 - - skills install / clawhub install

💬 聊天命令速记

功能 命令 使用时机
新开对话 /new 话题切换
瘦身省 Token /compact 对话太长
查看状态 /status 想看用量
确认操作 /approve Agent 询问
拒绝操作 /deny 阻止执行

🎁 结语:成为 OpenClaw 高手的下一步

恭喜你读完了这份全网最全的 OpenClaw 命令手册!现在你已经掌握了:

100+ 个常用命令的详细用法
故障排查的标准流程
多模型切换的实战技巧
微信/飞书/钉钉接入的完整路径
Token 节省的高级玩法

但这只是开始!OpenClaw 生态(PicoClaw、ZeroClaw、losterAI、EasyClaw 等)还在快速迭代,建议

  1. 收藏本文,遇到问题第一时间查阅
  2. 加入社区,关注 GitHub Releases 获取更新
  3. 实践出真知,把上面的命令都敲一遍,形成肌肉记忆

💬 互动时间

你在使用 OpenClaw 时遇到过哪些坑?最想了解哪个高级功能?

欢迎在评论区留言交流,点赞 + 在看 + 收藏三连支持一下!👇


📮 加入粉丝朋友圈

🔥 点击下方名片,加入 500+ 人 AI 开源应用开发者社群,获取:

  • 第一手更新资讯
  • 独家部署教程
  • 问题答疑支持

点击名片,回复「OpenClaw中文版」获取中文版!


本文持续更新,最后更新时间:2026年2月
如有遗漏或错误,欢迎在评论区指正

Logo

DAMO开发者矩阵,由阿里巴巴达摩院和中国互联网协会联合发起,致力于探讨最前沿的技术趋势与应用成果,搭建高质量的交流与分享平台,推动技术创新与产业应用链接,围绕“人工智能与新型计算”构建开放共享的开发者生态。

更多推荐