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

Written by

in

文章目录
  • OpenClaw 的命令体系分为两大核心类别: 类型 使用场景 输入方式 🖥️ 终端 CLI 命令 系统配置、服务管理、故障排查 在 Terminal / CMD / PowerShell 中输入 💬 聊天斜杠命令 会话控制、模型切换、任务执行 在 OpenClaw 对话窗口中输入 / 开头
  • 所有 CLI 命令统一格式:openclaw <命令> [参数]
  • 在 OpenClaw 对话窗口中输入,以 / 开头。
  • 路径 说明 重要性 ~/.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 命令手册!现在你已经掌握了: ✅ 100+ 个常用命令的详细用法✅ 故障排查的标准流程✅ 多模型切换的实战技巧✅ 微信/飞书/钉钉接入的完整路径✅ Token 节省的高级玩法 但这只是开始!OpenClaw 生态(PicoClaw、ZeroClaw、losterAI、EasyClaw 等)还在快速迭代,建议: 收藏本文,遇到问题第一时间查阅 加入社区,关注 GitHub Releases 获取更新 实践出真知,把上面的命令都敲一遍,形成肌肉记忆
  • 目录
    • 命令分类总览
    • 第一部分:终端 CLI 命令详解
      • 一、基础操作(每日必用 ⭐⭐⭐)
      • 二、安装与初始化(首次使用必看)
      • 三、诊断与排错(出问题先跑这个 ⭐⭐⭐)
      • 四、模型管理(多模型切换核心)
      • 五、网关 Gateway 管理(核心引擎)
      • 六、聊天通道  Channel 管理(对接微信/飞书/钉钉)
      • 七、插件  Plugin 管理(功能扩展)
      • 八、技能 Skill 管理(AI 能力扩展)
      • 本地技能管理:
      • ClawHub 技能商店(社区生态):
      • 九、消息与配对(高级操作)
      • 十、沙箱 Sandbox 管理(安全隔离)
      • 十一、浏览器控制(自动化操作)
      • 十二、配置文件操作
      • 十三、更新与维护
    • 第二部分:聊天斜杠命令详解
      • 一、会话管理(最常用 ⭐⭐⭐)
      • 二、模型切换(多模型对比测试)
      • 三、会话历史管理
      • 四、工具与执行控制
      • 五、技能与记忆管理
      • 六、信息查询
    • 第三部分:关键文件路径速查表
      • 第四部分:新手急救流程(遇到问题按这个来)
        • 第五部分:必备命令大全速记法(建议收藏)
          • 🔥 高频命令速记(每天使用)
          • 🛠️ 故障排查速记
          • 📱 通道管理速记
          • 🤖 模型管理速记
          • 🔌 插件技能速记
          • 💬 聊天命令速记
        • 结语:成为 OpenClaw 高手的下一步

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

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

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

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

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

          所有 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 是 OpenClaw 的心脏,负责所有通信调度。

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

          通道 = 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
          # 完成!

          命令 功能说明
          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

          命令 功能说明
          openclaw skills list 列出已安装的所有技能
          openclaw skills install <技能名> 安装新技能

          命令 功能说明
          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 <通道> <配对码> 批准设备配对 新设备接入授权

          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%.openclawopenclaw.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 命令手册!现在你已经掌握了:

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

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

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

          站内搜索