OpenClaw 常用命令整理与教程

本教程整理自 菜鸟教程，旨在为 OpenClaw 用户提供一个快速查阅常用命令的指南。

OpenClaw 简介

OpenClaw（原名 Clawdbot，过渡名 Moltbot）是 2026 年 1 月突然爆火的开源个人 AI 助手项目，由 Peter Steinberger（PSPSP SDK 创始人）开发。它是一个可执行任务的智能体，不仅能回答问题，还能主动操作系统、访问网页、处理邮件、整理文件、发起提醒甚至自动编写代码。OpenClaw 的目标是让 AI 不只是给建议，而是直接完成完整工程任务。

名字演进： Clawdbot → Moltbot → OpenClaw

安装方法

OpenClaw 的安装设计得非常友好，支持 Mac, Windows, Linux 系统，需要 Node.js (pnpm) 或使用 Docker。

推荐安装方式（一键脚本）：

  • macOS/Linux: 
    curl -fsSL https://openclaw.ai/install.sh | bash
  • Windows (PowerShell): 
    iwr -useb https://openclaw.ai/install.ps1 | iex

配置说明： 安装完成后，会进行交互式设置，包括选择 AI 供应商（支持国内外），配置聊天工具、端口等。

OpenClaw 常用命令

命令作用备注 / 参数
openclaw status查看 Gateway 当前运行状态包含健康度与上下文信息
openclaw health健康检查检测 core、依赖与运行环境
openclaw doctor综合诊断与修复建议支持 --deep 深度检查
openclaw onboard交互式初始化向导首次使用推荐
openclaw onboard --install-daemon安装系统守护进程后台常驻运行 Gateway
openclaw onboard --uninstall-daemon卸载守护进程不删除数据
openclaw configure交互式配置向导模型、通道、凭据等
openclaw config get <path>获取配置值JSON Path
openclaw config set <path> <value>设置配置项支持 JSON5 / raw 文本
openclaw config unset <path>清除配置项移除单个键值
openclaw channels list列出已登录通道WhatsApp / Telegram / Discord 等
openclaw channels login登录新的通道账号扫码或授权流程
openclaw channels add添加通道Telegram / Discord / Slack
openclaw channels status --probe通道健康检查检测连接可达性
openclaw skills list列出技能已安装 / 可用技能
openclaw skills info <skill>技能详情参数、版本信息
clawhub install <slug>从 ClawHub 安装技能官方技能市场
openclaw hooks list列出 Hook 列表事件钩子机制
openclaw plugins list列出插件查看已安装插件
openclaw plugins install <id>安装插件例如 @openclaw/voice-call
openclaw plugins enable <id>启用插件通常需要重启 Gateway
openclaw models list列出可用模型包含鉴权状态
openclaw models status模型状态当前可用性
openclaw models auth setup-token模型鉴权配置Cheatsheet 推荐方式
openclaw memory search "X"搜索长期记忆向量搜索
openclaw memory index重建记忆索引修复 memory 异常
openclaw logs查看日志默认聚合输出
openclaw logs --follow实时日志--json / --plain / --limit
openclaw gateway install安装 Gateway 系统服务注册为系统守护进程
openclaw gateway start启动 Gateway 服务system service 模式
openclaw gateway stop停止 Gateway 服务
openclaw gateway restart重启 Gateway 服务配置变更后使用
openclaw gateway statusGateway 系统服务状态不同于 openclaw status
openclaw browser start启动浏览器代理Automation 能力
openclaw browser screenshot网页截图
openclaw subagents list列出子代理
openclaw cron list列出定时任务
openclaw cron run <id>执行定时任务
openclaw uninstall卸载 Gateway 服务及数据官方推荐
openclaw uninstall --all --yes --non-interactive全自动卸载状态 / workspace / 插件
openclaw uninstall --state删除状态文件不删除 workspace
openclaw uninstall --workspace删除工作区agent / workspace 数据
openclaw uninstall --service仅卸载系统服务不删除数据
openclaw uninstall --dry-run模拟卸载仅展示结果

聊天内斜杠命令

  • /status：健康 + 上下文
  • /context list：上下文贡献者
  • /model <model_name>：切换模型
  • /compact：释放窗口空间
  • /new：全新会话
  • /stop：中止当前运行
  • /tts on|off：切换语音
  • /think：切换推理模式

工作区结构 (Workspace Anatomy)

  • AGENTS.md：指令说明
  • USER.md：偏好设置
  • MEMORY.md：长期记忆
  • HEARTBEAT.md：检查清单
  • SOUL.md：人格/语气
  • IDENTITY.md：名称/主题
  • BOOT.md：启动配置
  • 根目录： ~/.openclaw/workspace

为什么要用 OpenClaw？

  • 真正做到了"像 JARVIS 一样"：能读写文件、跑终端命令、操作浏览器、收发邮件、日历、写代码、订机票、清空收件箱等。
  • 本地优先 + 长期记忆：所有对话跨平台共享上下文，USER.md 和 memory/ 目录会越用越聪明。
  • 支持几乎所有大模型：Claude、Gemini、OpenAI、Ollama 本地模型、Pi 等。
  • 社区技能生态爆炸：ClawdHub 上已有 500+ 社区技能。
  • 安装简单像 npm install，实际能力却很 spicy。

OpenClaw 相比 Claude Code/OpenCode，更接近一个具备执行权限的工程型智能体，它强在自动完成整个工程流程。