文章目录
目录
- OpenClaw 常用命令速查表
- 新手建议与小技巧
- OpenClaw 常用命令如下
OpenClaw 的命令行工具非常强大，覆盖了从安装配置到日常使用的方方面面,为了让你能快速上手，我将最常用的命令整理为以下分类速查表，你可以将它看作一份随时查阅的急救手册。
| 分类 | 命令 | 核心作用 |
|---|---|---|
| 🚀 安装与入门 | curl -fsSL https://openclaw.ai/install.sh | bash (macOS/Linux) |
一键安装 OpenClaw。 |
iwr -useb https://openclaw.ai/install.ps1 | iex (Windows PowerShell) |
一键安装 OpenClaw。 | |
openclaw onboard --install-daemon |
启动配置向导，并安装后台服务。 | |
openclaw --help |
查看所有命令的帮助信息。 | |
openclaw --version |
查看当前 OpenClaw 版本。 | |
| ⚙️ 配置管理 | openclaw configure |
启动交互式配置向导，修改设置。 |
openclaw config get |
查看当前完整配置。 | |
openclaw config set <key> <value> |
设置特定配置项 (例如: openclaw config set models.default bailian/qwen3-max)。 |
|
openclaw doctor |
运行诊断检查，发现问题。 | |
openclaw doctor --fix |
自动修复 detected issues. | |
| 🎛️ 服务控制 (Gateway) | openclaw gateway install |
将 Gateway 安装为系统服务。 |
openclaw gateway start |
启动 Gateway 服务。 | |
openclaw gateway stop |
停止 Gateway 服务。 | |
openclaw gateway restart |
重启 Gateway 服务 (修改配置后常用)。 | |
openclaw gateway status |
查看 Gateway 运行状态。 | |
openclaw logs follow 或 journalctl --user -u openclaw-gateway.service -f |
实时查看日志，方便排查错误。 | |
| 🤖 模型与渠道 | openclaw models list |
列出所有可用的 AI 模型。 |
openclaw models set <模型名称> |
设置默认 AI 模型。 | |
openclaw models status --probe |
探测模型连接状态（可能会产生费用）。 | |
openclaw channels list |
列出所有已配置的消息渠道 (如 Telegram, 飞书)。 | |
openclaw devices list |
列出待配对的设备。 | |
openclaw devices approve <requestId> |
批准设备配对请求。 | |
| 💬 日常使用 | openclaw dashboard |
在浏览器中打开 Web 控制台 (通常是 http://127.0.0.1:18789)。 |
openclaw tui |
启动终端界面进行对话。 | |
openclaw agent --message "你的指令" |
直接在命令行中让 agent 执行任务。 | |
openclaw update |
升级 OpenClaw 到最新版本。 |
- 从
doctor开始：无论何时遇到问题，第一反应可以是执行 openclaw doctor。它会像一位经验丰富的医生一样，帮你诊断大部分常见的配置和环境问题 。
- 用好
dashboard：对于不熟悉命令行的朋友，openclaw dashboard 命令是你最好的朋友。它会打开一个图形化界面，让你可以更直观地管理模型、技能和查看日志 。
- 安全第一：OpenClaw 功能强大，拥有较高权限。在安装和配置新技能时，请留意相关安全提示，并考虑在沙盒环境中运行 。
doctor开始：无论何时遇到问题，第一反应可以是执行 openclaw doctor。它会像一位经验丰富的医生一样，帮你诊断大部分常见的配置和环境问题 。dashboard：对于不熟悉命令行的朋友，openclaw dashboard 命令是你最好的朋友。它会打开一个图形化界面，让你可以更直观地管理模型、技能和查看日志 。
| 命令 | 作用 | 备注 / 参数 |
|---|---|---|
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 status |
Gateway 系统服务状态 | 不同于 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 |
模拟卸载 | 仅展示结果 |
到此这篇关于OpenClaw 常用命令小结的文章就介绍到这了,更多相关OpenClaw 常用命令内容请搜索风君子博客以前的文章或继续浏览下面的相关文章，希望大家以后多多支持风君子博客！