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

作为 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 Tip：openclaw 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 等）还在快速迭代，建议：

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