OpenClaw 命令
OpenClaw的命令行工具覆盖了从安装配置到日常运维的全流程。我为你整理了最常用和最高频的命令,按功能分类,方便快速查阅。
- 安装与配置
这是你第一次使用 OpenClaw 时需要执行的命令。
|
命令 |
说明 |
|
openclaw onboard --install-daemon |
全能初始化向导。会引导你设置 API Key、选择模型、配置消息通道,并自动安装后台守护进程(推荐首选)。 |
|
openclaw configure |
交互式配置向导。用于单独修改某项配置,比直接改文件更稳妥。 |
|
openclaw config get / set |
直接查看或修改配置。例如 openclaw config set models.default gpt-4。 |
|
openclaw doctor --fix |
自动诊断修复。当 OpenClaw 行为异常时,运行它自动检测并修复配置文件问题。 |
- 网关管理 (Gateway)
OpenClaw 的核心是一个后台服务(Gateway),通过以下命令控制它的“生死”。
|
命令 |
说明 |
|
openclaw gateway start |
后台启动网关(守护进程模式),关闭终端也不会停止。 |
|
openclaw gateway stop |
停止网关服务。 |
|
openclaw gateway restart |
重启网关(修改配置后常用)。 |
|
openclaw gateway status |
查看网关当前运行状态。 |
|
openclaw gateway |
前台运行网关。终端会实时打印日志,通常用于调试。 |
- 日常运维与调试
|
命令 |
说明 |
|
openclaw dashboard |
打开 Web 控制台(默认地址:http://127.0.0.1:18789)。 |
|
openclaw status |
查看 OpenClaw 整体健康状态。 |
|
openclaw update |
检查并更新 OpenClaw 到最新版本。 |
|
journalctl --user -u openclaw-gateway.service -f |
查看实时日志(Linux)。用于排查服务为什么不响应。 |
- 高级功能与调试
|
命令 |
说明 |
|
openclaw tui |
启动终端交互界面。在 Bot 连接不上聊天软件时,直接在命令行里和 AI 对话。 |
|
openclaw agent --message "你好" |
命令行直接调用 AI 智能体。可用于脚本或测试,支持 --to 指定投递渠道。 |
|
openclaw models set <模型名> |
切换 AI 模型。也可以直接让 AI 帮你切。 |
|
openclaw devices list / approve |
设备配对管理。当新设备尝试连接时,需要运行此命令批准。 |
- 配置文件速览
如果你想让 AI 的行为更符合你的习惯,可以修改 ~/.openclaw/workspace/ 目录下的这几个文件,它们决定了 AI 的“性格”和“智商”:
- SOUL.md:AI 的灵魂。定义说话风格、价值观和红线。
- USER.md:AI 的用户说明书。记录你的称呼、偏好、雷区。
- AGENTS.md:AI 的工作指南。规定接到任务后的处理流程。
- HEARTBEAT.md:AI 的自主意识。让 AI 定时主动执行任务(如每日早报)。
- 聊天中的快捷指令
在 WhatsApp、Telegram 等聊天窗口中,可以直接发送以下指令控制 AI:
- /reset 或 /new:清空当前会话的上下文记忆(相当于开启新对话)。
- /status:查看当前会话状态(使用的模型、消耗 token 等)。
- /think high:设置模型的思考深度(越高推理越深但速度越慢)。
更多推荐


所有评论(0)