想象一下这样的场景：凌晨两点，你刚部署好 OpenClaw 准备对接飞书机器人，却发现网关怎么都连不上；或者你想快速切换到大模型处理复杂任务，却忘了具体的命令格式……
作为 OpenClaw 生态（包括 PicoClaw、ZeroClaw、losterAI、EasyClaw 等系列开源应用）的核心用户，我根据开源资料和个人使用体验整理了这份全网最全的命令速查手册。无论你是刚接触的新手，还是已经玩转过各种 AI Agent 的资深开发者，这份指南都能让你：
✅ 5 分钟快速定位任何操作指令
✅ 告别百度/Google反复搜索的低效循环
✅ 掌握高级技巧，让 OpenClaw 成为你的超级生产力工具
建议立即收藏本文，下次遇到问题时直接 Ctrl+F 搜索，效率提升肉眼可见！
文章目录
- OpenClaw常用操作命令完整速查手册：从入门到精通的终端 CLI & 聊天指令全解析
OpenClaw 的命令体系分为两大核心类别：
| 类型 | 使用场景 | 输入方式 |
|---|---|---|
| 🖥️ 终端 CLI 命令 | 系统配置、服务管理、故障排查 | 在 Terminal / CMD / PowerShell 中输入 |
| 💬 聊天斜杠命令 | 会话控制、模型切换、任务执行 | 在 OpenClaw 对话窗口中输入 / 开头 |
所有 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、模型偏好等设置 |
🔧 配置流程示例：
openclaw onboard
三、诊断与排错（出问题先跑这个 ⭐⭐⭐）
| 命令 | 功能说明 | 使用时机 |
|---|---|---|
openclaw doctor | 全面健康检查 | 遇到任何问题，先跑这个！ |
openclaw doctor --fix | 健康检查 + 自动修复 | 让系统尝试自动解决常见问题 |
openclaw status | 查看运行状态（网关在线状态、端口占用） | 检查服务是否正常启动 |
openclaw status --deep | 深度状态检测（含网关健康探测） | 网络连接异常时深度排查 |
openclaw logs | 查看最近运行日志 | 查看错误堆栈信息 |
🚨 故障排查标准流程：
openclaw doctor
openclaw logs
openclaw status
openclaw doctor
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
openclaw models set minimax/MiniMax-M2.1
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 （需插件）
🎯 快速接入飞书示例：
openclaw plugins enable feishu
openclaw channels add --channel feishu
七、插件 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
九、消息与配对（高级操作）
| 命令 | 功能说明 | 使用场景 |
|---|---|---|
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 | 编辑配置文件（自动打开编辑器） |
📝 手动编辑配置文件路径：
notepad %USERPROFILE%\.openclaw\openclaw.json
nano ~/.openclaw/openclaw.json
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 ↓ 第4步：openclaw doctor ↓ 第5步：openclaw restart ← 重启服务
⚡ 改配置后的标准操作流程：
nano ~/.openclaw/openclaw.json
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 命令手册！现在你已经掌握了：
✅ 100+ 个常用命令的详细用法
✅ 故障排查的标准流程
✅ 多模型切换的实战技巧
✅ 微信/飞书/钉钉接入的完整路径
✅ Token 节省的高级玩法
但这只是开始！OpenClaw 生态（PicoClaw、ZeroClaw、losterAI、EasyClaw 等）还在快速迭代，建议：
- 收藏本文，遇到问题第一时间查阅
- 加入社区，关注 GitHub Releases 获取更新
- 实践出真知，把上面的命令都敲一遍，形成肌肉记忆
💬 互动时间
你在使用 OpenClaw 时遇到过哪些坑？最想了解哪个高级功能？
欢迎在评论区留言交流，点赞 + 在看 + 收藏三连支持一下！👇
