夜雨聆风🎯 开篇语：为什么你需要这份手册？
如果你正在使用或准备使用 OpenClaw，一定遇到过这样的困扰：
●装完后不知道第一个命令该敲什么
●修改配置后服务不生效，反复排查
●想切换模型却忘了具体语法
●遇到报错时，面对日志一头雾水
这份手册将 OpenClaw 的所有命令系统分类、实战示例、避坑技巧一次性给到你。无论你是刚入门的新手，还是需要深度运维的老手，收藏这一篇，效率提升300%！
📋 命令体系总览：两大核心入口
OpenClaw 的命令分为两大体系，用途截然不同：
类型 | 使用场景 | 输入方式 |
🖥️ 终端 CLI 命令 | 系统配置、服务管理、故障排查 | 在 Terminal/CMD/PowerShell 中输入 |
💬 聊天斜杠命令 | 会话控制、模型切换、任务执行 | 在 OpenClaw 对话窗口中输入 / 开头 |
黄金法则：CLI 管系统，聊天命令管会话。改配置用 CLI，对话中用斜杠命令。
第一部分：🖥️ 终端 CLI 命令大全
一、基础操作（每日必用 ⭐⭐⭐）
命令 | 功能说明 | 使用场景 |
openclaw --version | 查看当前版本 | 确认安装成功，检查更新 |
openclaw --help | 查看所有可用命令 | 忘记命令时快速查阅 |
openclaw tui | 启动终端交互界面 | 新手最推荐，图形化操作 |
openclaw dashboard | 打开网页控制台 | 习惯浏览器操作的用户首选 |
openclaw restart | 重启服务 | 改配置后必须执行 |
openclaw stop | 停止服务 | 临时暂停或关机前 |
openclaw update | 更新到最新版本 | 获取新功能和安全补丁 |
二、安装与初始化（首次使用必看）
# 交互式配置向导（首次安装后必跑）openclaw onboard# 配置向导 + 安装为系统服务（开机自启）openclaw onboard --install-daemon# 重新进入配置向导（随时修改设置）openclaw configure三、诊断与排错（出问题先跑这个 ⭐⭐⭐）
命令 | 功能说明 | 使用时机 |
openclaw doctor | 全面健康检查 | 遇到任何问题先跑这个 |
openclaw doctor --fix | 健康检查 + 自动修复 | 让系统尝试自动解决 |
openclaw status | 查看运行状态 | 检查服务是否正常启动 |
openclaw status --deep | 深度状态检测 | 网络连接异常时深度排查 |
openclaw logs | 查看最近运行日志 | 查看错误堆栈信息 |
🚨 标准故障排查流程：
openclaw doctor # 1. 全面体检openclaw logs # 2. 查看错误日志openclaw status --deep # 3. 检查详细状态openclaw doctor --fix # 4. 尝试自动修复openclaw restart # 5. 重启服务四、模型管理（多模型切换核心）
# 列出所有已配置模型openclaw models list# 切换默认模型（实战示例）openclaw models set bailian/qwen3-max-2026-01-23 # 切换到百炼千问openclaw models set minimax/MiniMax-M2.1 # 切换到 MiniMaxopenclaw models set anthropic/claude-3-5-sonnet # 切换到 Claude# OAuth 方式登录openclaw models auth login --provider <提供商># 粘贴 API Token 认证openclaw models auth paste-token --provider <提供商>五、网关 Gateway 管理（核心引擎）
Gateway 是 OpenClaw 的心脏，负责所有通信调度。
openclaw gateway # 启动网关服务openclaw gateway --port 18789# 指定端口启动（默认端口被占用时）openclaw gateway --verbose # 启动并显示详细日志（调试模式）openclaw gateway restart # 重启网关（配置变更后生效）openclaw gateway --token <token># 带认证 Token 启动（安全加固）六、通道管理（连接聊天平台）
# 列出所有通道openclaw channels list# 添加新通道（以飞书为例）openclaw channels add --channel feishu# 登录通道账号openclaw channels login telegramopenclaw channels login whatsapp --qr # WhatsApp 扫码登录# 查看通道状态openclaw channels status# 实时查看通道日志openclaw channels logs --follow七、插件 Plugin 管理（功能扩展）
openclaw plugins list # 查看所有可用插件openclaw plugins enable<插件名># 启用指定插件openclaw plugins disable <插件名># 禁用指定插件openclaw plugins install<插件名># 从仓库安装新插件openclaw plugins doctor # 检查插件加载错误八、技能 Skill 管理（能力扩展）
本地技能管理：
openclaw skills list # 列出已安装技能openclaw skills install<技能名># 安装新技能openclaw skills uninstall <技能名># 卸载技能openclaw skills enable<技能名># 启用技能openclaw skills disable <技能名># 禁用技能openclaw skills info <技能名># 查看技能详情ClawHub 技能商店（社区生态）：
clawhub search <关键词># 搜索社区技能clawhub install<技能名># 安装社区技能clawhub list # 列出已安装技能clawhub sync --all # 批量更新所有已安装技能clawhub update <技能名># 更新指定技能九、消息与配对（高级操作）
# 主动发送消息openclaw message send --target +1234567890 --message "你好"openclaw message send --channel telegram --target @username --message "Hello"# 直接向 Agent 派发任务openclaw agent --message "帮我总结今天的日程"openclaw agent --message "任务" --thinking high # 高思考深度模式# 批准设备配对openclaw pairing approve <通道><配对码>十、浏览器控制（自动化操作）
openclaw browser open<URL># 打开网页openclaw browser screenshot # 截图openclaw browser click <元素># 点击页面元素openclaw browser type<元素><文字># 在输入框输入文字openclaw browser snapshot # 获取页面 DOM 快照openclaw browser close # 关闭浏览器openclaw browser console # 查看控制台日志十一、配置文件操作
openclaw config # 查看当前配置（只读）openclaw config edit # 编辑配置文件（自动打开编辑器）十二、Agent 与定时任务管理
Agent 管理：
openclaw agents list # 查看所有 Agentopenclaw agents add<名称># 添加新 Agentopenclaw agents delete <名称># 删除 Agentopenclaw agents bind<名称> --channel feishu # 绑定通道定时任务管理：
openclaw cron list # 查看所有定时任务openclaw cronadd --name "日报" --cron "0 9 * * *" --message "发送日报"openclaw cron run <任务ID># 立即执行任务openclaw cronrm<任务ID># 删除任务第二部分：💬 聊天斜杠命令大全
在 OpenClaw 对话窗口中输入，以 / 开头。
一、会话管理（最常用 ⭐⭐⭐）
命令 | 功能说明 | 使用频率 |
/new | 开始全新会话（清除上下文） | ⭐⭐⭐ |
/new 任务描述 | 新建会话并直接带上任务 | ⭐⭐⭐ |
/compact | 压缩上下文（大幅减少 Token 消耗） | ⭐⭐⭐ |
/status | 查看当前会话状态 | ⭐⭐ |
/help 或 /commands | 显示所有可用斜杠命令 | ⭐⭐ |
二、模型切换与调参
/model # 查看当前模型/model gpt-4o # 切换到 GPT-4o/model claude-3-5-sonnet # 切换到 Claude三、技能与记忆管理
/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/ | 长期记忆存储目录 | ⭐⭐ |
📝 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.json2. 保存退出3. 重启服务：openclaw restart💡 最佳实践与技巧
常用命令组合
# 快速启动新项目openclaw setupopenclaw configureopenclaw channels login telegram# 日常使用openclaw gateway --detachopenclaw statusopenclaw dashboard# 问题排查openclaw doctor --show-tokenopenclaw logs --follow性能优化
# 降低日志级别减少 IOopenclaw --log-level error gateway# 限制内存使用openclaw config set gateway.maxMemory 2048# 定期清理记忆openclaw memory --cleanup安全建议
1. 默认监听 127.0.0.1，不要暴露公网
2. 定期轮换 API Key：openclaw configure
3. 审计配置：openclaw security
4. 监控设备：openclaw devices list
🎯 最后划重点：记住这5句就够了
1. 改完配置必重启：openclaw gateway restart
2. 机器人不回消息先看状态：openclaw gateway status
3. 出问题就看日志：openclaw logs --follow
4. 配置报错自动修：openclaw doctor --fix
5. 要联网就加密钥：openclaw agents add
📢 结束语
OpenClaw 的命令体系看似复杂，但掌握核心的 20+ 个命令 就能应对 90% 的使用场景。建议：
✅ 收藏本文，遇到问题直接 Ctrl+F 搜索
✅ 每天练习 3 个命令，一周内掌握全部
✅ 加入社区，关注 GitHub 获取最新更新
让 OpenClaw 真正成为你的 24 小时 AI 员工，从聊天建议升级为直接完成任务的生产力工具！
