OpenClaw 命令大全以及使用指南

OpenClaw 命令大全以及使用指南基于 OpenClaw 2026.2.25 版本整理涵盖 40 顶级命令、聊天斜杠命令及常见问题排查。一、OpenClaw 简介OpenClaw 是一款开源的个人 AI 助手框架2026 年初开源后迅速成为最受关注的 AI Agent 框架之一。与依赖 Web 界面或桌面应用的同类工具不同OpenClaw 从设计之初就以 CLI命令行为主要入口天然适合与 DevOps 工具链、Shell 脚本和自动化调度集成。核心特性40 顶级命令覆盖 Gateway、模型、频道、Skills、Hooks、Plugins 等20 通信频道Telegram、Discord、Slack、WhatsApp、Signal、飞书等100 子命令完整的终端操作能力内置浏览器自动化、定时任务、语义记忆搜索二、安装与初始化2.1 安装# macOS / Linuxcurl-fsSLhttps://openclaw.ai/install.sh|bash# Windows PowerShelliwr-usebhttps://openclaw.ai/install.ps1|iex# Windows CMDcurl-fsSLhttps://openclaw.ai/install.cmd-oinstall.cmdinstall.cmddel install.cmd2.2 验证安装# 查看版本注意没有 openclaw version 命令必须用 --versionopenclaw--version# 输出: 2026.2.25# 查看所有命令帮助openclaw--help2.3 首次初始化# 交互式配置向导推荐新手使用openclaw configure# 健康检查确认环境就绪openclaw doctor2.4 更新与卸载# 更新到最新稳定版openclaw update# 切换更新频道stable/beta/devopenclaw update--channelbeta# 预览更新内容不实际执行openclaw update --dry-run# 更新后不自动重启 Gatewayopenclaw update --no-restart# 卸载 Gateway 服务和本地数据CLI 保留openclaw uninstall# 完全卸载含配置、状态、工作空间openclaw uninstall--all--yes# 重置本地配置保留 CLIopenclaw reset三、全局标志Global Flags任何命令都可以附加以下全局标志标志说明--help/-h显示帮助信息--version/-V显示版本号--log-level level全局日志级别silent/fatal/error/warn/info/debug/trace--no-color禁用 ANSI 颜色适合 CI 管道--dev使用开发环境隔离状态到~/.openclaw-dev--profile name使用命名配置文件隔离状态四、Gateway 管理核心服务Gateway 是 OpenClaw 的心脏是一个 WebSocket 服务负责接收消息、调度 Agent、管理会话。默认监听ws://127.0.0.1:18789。4.1 启动与运行# 前台运行CtrlC 停止适合调试openclaw gateway# 指定端口openclaw gateway--port18790# 绑定模式openclaw gateway--bindloopback# 仅本机默认最安全openclaw gateway--bindlan# 局域网可访问openclaw gateway--bindtailnet# Tailscale 网络# 强制启动杀掉占用端口的进程openclaw gateway--force# 设置认证模式openclaw gateway--authtoken--tokenyour-secret-tokenopenclaw gateway--authpassword--passwordyour-password# Tailscale 暴露openclaw gateway--tailscaleserve# 内网暴露openclaw gateway--tailscalefunnel# 公网暴露# 详细日志模式openclaw gateway--verbose4.2 服务管理持久化# 安装为系统服务launchd/systemd/schtasksopenclaw gatewayinstall# 启动 / 停止 / 重启openclaw gateway start openclaw gateway stop openclaw gateway restart# 卸载系统服务openclaw gateway uninstall# 查看服务状态openclaw gateway statusWindows 注意openclaw gateway install需要管理员权限底层使用 schtasks非管理员环境请用前台模式。4.3 状态查询与日志# 查看完整状态openclaw gateway status# 健康检查openclaw gateway health# 探测 Gateway 可达性openclaw gateway probe# 发现局域网/广域网上的 Gatewayopenclaw gateway discover# 调用 Gateway RPC 方法openclaw gateway call health# 查看用量成本openclaw gateway usage-cost# 查看日志openclaw logs openclaw logs--follow# 实时跟踪openclaw logs--limit100# 限制行数openclaw logs--json# JSON 格式五、配置管理配置文件位于~/.openclaw/openclaw.json使用 JSON5 格式支持注释和尾逗号。# 获取配置值点路径语法openclaw config get gateway.port# 输出: 18789# 设置配置值openclaw configsetgateway.port18790openclaw configsetgateway.bind loopback# 删除配置项openclaw configunsetgateway.tailscale# 交互式配置向导openclaw configure openclaw configure--sectionmodel# 仅配置模型部分openclaw configure--sectionweb# 仅配置 Web 部分六、模型管理6.1 查看与设置模型# 列出已配置的模型openclaw models list# 查看当前模型状态openclaw models status openclaw models status--json# JSON 格式# 设置默认模型openclaw modelssetqwen-portal/coder-model openclaw modelssetqwen# 使用别名# 设置图像模型openclaw models set-image qwen-portal/vision-model6.2 模型认证# 交互式认证向导引导完成 OAuth 或 Token 设置openclaw models authadd# 手动粘贴 Tokenopenclaw models auth paste-token# 通过 CLI 设置 Tokenopenclaw models auth setup-token# 管理认证顺序openclaw models auth order6.3 别名与回退# 管理模型别名openclaw models aliases# 管理回退链主模型不可用时自动切换openclaw models fallbacks# 管理图像模型回退openclaw models image-fallbacks# 扫描 OpenRouter 免费模型openclaw models scan支持的模型提供商OpenAI、AnthropicClaude、GoogleGemini、OpenRouter、DeepSeek、Mistral、Groq 等。七、频道管理ChannelsOpenClaw 支持 20 通信频道Telegram、WhatsApp、Discord、Slack、Signal、iMessage、IRC、飞书、LINE 等。7.1 添加频道# 添加 Telegram Botopenclaw channelsadd--channeltelegram--token123456:ABC...# 添加 Discord Botopenclaw channelsadd--channeldiscord--tokenMTIz...# 添加 Slack Appopenclaw channelsadd--channelslack --bot-tokenxoxb-...--app-tokenxapp-...# 添加 WhatsApp需要扫码登录openclaw channels login--channelwhatsapp# 添加 Matrixopenclaw channelsadd--channelmatrix--homeserverhttps://matrix.org--user-iduser:matrix.org--access-token...# 添加 Signalopenclaw channelsadd--channelsignal --signal-number886...# 添加多账号指定 account IDopenclaw channelsadd--channeltelegram--accountwork--token...7.2 管理频道# 列出所有频道openclaw channels list# 查看频道连接状态含 Gateway 探测openclaw channels status openclaw channels status--probe# 查看频道日志openclaw channels logs# 查看频道支持的功能openclaw channels capabilities# 移除频道openclaw channels remove--channeltelegram# 登出频道openclaw channelslogout--channelwhatsapp7.3 DM 配对# 查看待配对请求openclaw pairing# 批准配对openclaw pairing approve telegram WR8XRQQA八、Skills技能插件Skills 是 OpenClaw 的功能扩展机制每个 Skill 定义 AI Agent 可以执行的特定能力。# 列出所有 Skillsopenclaw skills list# 检查 Skills 就绪状态openclaw skills check# 查看某个 Skill 详情openclaw skills info coding-agent常用内置 SkillsSkill说明依赖weather天气查询curlgithubGitHub 仓库操作gh CLIcoding-agent代码辅助无himalaya邮件收发himalaya CLI IMAPopenai-whisper-api语音转文字OPENAI_API_KEYsession-logs搜索历史对话jq rgsummarize网页/视频摘要summarize CLI九、Hooks事件钩子Hooks 是 OpenClaw 的事件驱动自动化机制特定事件触发时自动执行预定义操作。# 列出所有 Hooksopenclaw hooks list# 查看某个 Hook 详情openclaw hooks info session-memory# 检查 Hooks 就绪状态openclaw hooks check# 启用 / 禁用 Hookopenclaw hooksenablesession-memory openclaw hooks disable command-logger# 安装 Hook 包openclaw hooksinstall./my-hook-pack openclaw hooksinstallsome-npm-hook-package# 更新已安装的 Hooksopenclaw hooks update内置 Hooksboot-md启动时运行 BOOT.md、session-memory/new 或 /reset 时保存上下文、command-logger记录所有命令事件。十、Plugins插件管理# 列出所有插件openclaw plugins list# 查看插件详情openclaw plugins info some-plugin# 安装插件openclaw pluginsinstall./my-plugin openclaw pluginsinstallsome-npm-plugin# 启用 / 禁用插件openclaw pluginsenablesome-plugin openclaw plugins disable some-plugin# 诊断插件加载问题openclaw plugins doctor十一、Agents代理管理Agents 是 OpenClaw 的隔离执行单元每个 Agent 有独立的工作空间、认证配置和路由规则。# 列出所有 Agentopenclaw agents list# 添加隔离 Agentopenclaw agentsaddwork# 设置 Agent 身份openclaw agents set-identity work--nameWork Bot# 删除 Agentopenclaw agents delete work终端直接对话# 基础对话openclaw agent--agentmain--message今天天气怎么样# 指定会话 ID 继续对话openclaw agent --session-id1234--message继续上次的话题# 指定思考级别openclaw agent--message分析代码性能--thinkingmedium# 对话结果发送到 Telegramopenclaw agent--message生成周报--deliver--channeltelegram --reply-tomychat十二、会话管理Sessions# 列出所有会话openclaw sessions# 只看最近 2 小时活跃的会话openclaw sessions--active120# 聚合所有 Agent 的会话openclaw sessions --all-agents# JSON 格式输出openclaw sessions--json十三、记忆系统MemoryOpenClaw 内置语义记忆搜索可以从历史对话和笔记中检索信息。# 查看记忆索引状态openclaw memory status# 重建索引openclaw memory index openclaw memory index--force# 语义搜索openclaw memory search--query服务器配置记忆文件结构MEMORY.md— 长期记忆手动维护memory/YYYY-MM-DD.md— 每日笔记自动/手动十四、定时任务Cron让 AI 助手定时执行任务。# 查看调度器状态openclawcronstatus# 列出所有定时任务openclawcronlist# 添加定时任务交互式openclawcronadd# 手动触发任务openclawcronrunjob-id# 启用 / 禁用任务openclawcronenablejob-idopenclawcrondisablejob-id# 编辑任务openclawcroneditjob-id# 查看运行历史openclawcronrunsjob-id常见用例每天 9 点播报天气、每小时检查新邮件、每周一生成周报。十五、浏览器自动化BrowserOpenClaw 可以控制无头浏览器实现网页自动化操作。# 查看状态 / 启动openclaw browser status openclaw browser start# 打开网页openclaw browseropenhttps://example.com# 列出标签页openclaw browser tabs# 截图openclaw browser screenshot openclaw browser screenshot --full-page# 获取页面快照AI 可读的结构化格式openclaw browser snapshot# 点击元素通过 ref 编号openclaw browser click12# 输入文字openclaw browsertype23hello--submit# 按键openclaw browser press Enter# 导航openclaw browser navigate https://google.com十六、多设备联动Nodes# 查看已配对设备openclaw nodes status# 查看节点能力openclaw nodes describenode-id# 发送通知openclaw nodes notify--nodemac--body任务完成# 远程拍照openclaw nodes camera--nodeiphone--facingback# 获取设备位置openclaw nodes location--nodeiphone# 远程执行命令openclaw nodes run--nodemac --ls -la ~/Desktop十七、诊断与排查17.1 openclaw doctor最重要的诊断命令# 运行环境诊断openclaw doctor# 自动修复openclaw doctor--fix# 深度扫描含系统服务openclaw doctor--deep# 生成 Gateway Tokenopenclaw doctor --generate-gateway-token# 非交互模式openclaw doctor --non-interactive17.2 安全审计# 本地安全审计openclaw security audit# 深度审计含 Gateway 探测openclaw security audit--deep# 自动修复安全问题openclaw security audit--fix17.3 其他实用命令# 查看整体状态openclaw status openclaw status--allopenclaw status--deep# 打开 Web 控制台openclaw dashboard openclaw dashboard --no-open# 打开终端 TUIopenclaw tui十八、聊天斜杠命令在聊天窗口Telegram、Discord、Slack、WhatsApp 等中使用的命令。18.1 基础命令命令说明示例/new重置会话清空历史/new/new model重置并切换模型/new claude-sonnet-4-20250514/status查看会话状态、Token、成本/status/help查看所有斜杠命令/help/commands查看可用命令列表/commands18.2 模型与上下文管理# 切换模型/model deepseek/deepseek-chat# 列出可用模型/models# 查看当前模型状态/model-status# 压缩上下文减少 Token 消耗/compact /compact 保留代码相关的讨论其他可以简化# 查看用量/usage off# 关闭显示/usage tokens# 仅显示 Token 数/usage full# 显示完整用量/usage cost# 显示成本统计# 查看上下文详情/context /context list# 列出上下文组件/context detail# 详细 Token 分布/context json# JSON 格式18.3 执行控制与安全# 查看当前执行设置/exec# 设置安全策略/exechostsandboxsecurityallowlistaskalways# 批准待执行操作/approve操作IDallow-once# 仅允许本次/approve操作IDallow-always# 永久允许/approve操作IDdeny# 拒绝# 权限模式总开关/elevated on# 开启提升权限/elevated off# 关闭提升权限/exec参数说明参数选项说明hostsandboxDocker 沙箱执行推荐gateway网关主机执行node配对节点执行securitydeny拒绝所有命令allowlist仅允许白名单命令full允许所有命令谨慎askoff不询问按策略执行on-miss不在白名单时询问always每次都询问18.4 语音控制TTS/tts off# 关闭语音/tts always# 所有回复语音播报/tts inbound# 仅语音输入时回复语音/tts tagged# 仅标记内容的语音播报/tts status# 查看当前状态/tts provider# 查看或切换 TTS 提供商支持的 TTS 提供商Edge TTS免费默认、OpenAI TTS、ElevenLabs。18.5 子代理管理/subagents list# 列出所有子代理/subagents stopid# 停止子代理/subagents logid# 查看日志/subagents infoid# 查看详情/subagents sendidmessage# 发送消息十九、常见问题排查19.1 命令名称错误OpenClaw 的命名规范顶级名词用复数形式models、channels、skills、hooks、agents少数核心命令用单数gateway、doctor、config。# 错误写法openclaw version# ✗ 不存在openclaw model list# ✗ 不存在提示 Did you mean models?openclaw channel list# ✗ 不存在openclaw skill list# ✗ 不存在# 正确写法openclaw--version# ✓ 使用标志openclaw models list# ✓ 复数形式openclaw channels list# ✓ 复数形式openclaw skills list# ✓ 复数形式19.2 Gateway 端口被占用# 方式一强制启动openclaw gateway--force# 方式二更换端口openclaw gateway--port18790openclaw configsetgateway.port18790# 方式三查看占用进程lsof-i:18789# macOS/Linuxnetstat-ano|findstr :18789# Windows19.3 配置文件位置速查文件路径主配置文件~/.openclaw/openclaw.jsonAgent 工作空间~/.openclaw/agents/main/认证配置~/.openclaw/agents/main/agent/auth-profiles.jsonGateway 日志/tmp/openclaw/openclaw-YYYY-MM-DD.log19.4 遇到问题时# 完整诊断openclaw doctor--deep# 查看版本openclaw--version# 查看 Gateway 状态openclaw gateway status# 查看健康状态openclaw gateway health二十、每日核心命令速查表日常使用掌握以下命令即可满足大部分需求# 1. 启动 Gatewayopenclaw gateway start# 2. 查看整体状态openclaw status# 3. 管理 Channelopenclaw channels status# 4. 管理模型openclaw models status openclaw modelssetmodel-name# 5. 查看 Skillsopenclaw skills check# 6. 定期健康检查openclaw doctor# 7. 查看日志openclaw logs--follow# 8. 更新 OpenClawopenclaw update参考资料OpenClaw 官方文档OpenClaw CLI Commands: Complete Reference Cheatsheet | Meta IntelligenceOpenClaw CLI 命令及聊天斜杠命令详解 | 51CTOOpenClaw 十大常用指令完全指南OpenClaw CLI and Config File Reference | LumaDockOpenClaw CLI Guide | OpenClaw Wiki