首页 > 信息 >OpenClaw 完整命令手册与使用指南

OpenClaw 完整命令手册与使用指南

2026-02-24 12:40:53
4

一、OpenClaw 概览

OpenClaw（原名 Clawdbot / Moltbot）是一款开源的自托管智能代理系统。

它可以运行在本地电脑，也可以部署到云服务器，通过 CLI 与本地或远程服务交互，执行浏览器自动化、文件操作、脚本运行、模型调用、消息平台通信等任务。

无论是个人自动化场景，还是企业级 AI 运维中枢，OpenClaw 都可以胜任。

命令基本格式

所有终端命令统一结构为：

openclaw [子命令] [选项] [参数]

例如：

openclaw doctor
openclaw models list
openclaw restart

命令分为两大类

OpenClaw 的操作方式分为：

1️⃣ 终端 CLI 命令（在命令行执行）
2️⃣ 聊天斜杠命令（在对话窗口输入）

下面分别说明。

第一部分：终端 CLI 命令

所有 CLI 命令均在终端中执行：

openclaw <命令>

一、基础操作（最常用）

命令	说明	适用场景
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
openclaw logs
openclaw status
openclaw restart
openclaw doctor --fix

四、模型管理

OpenClaw 支持多模型接入。

命令	说明
openclaw models list	查看模型列表
openclaw models set <provider/model>	切换默认模型
openclaw models auth login --provider <provider>	OAuth 登录
openclaw models auth paste-token --provider <provider>	粘贴 API Token

示例：

openclaw models set bailian/qwen3-max-2026-01-23
openclaw models set minimax/MiniMax-M2.1
openclaw models list

五、网关（Gateway）管理

Gateway 是 OpenClaw 的核心通信模块。

命令	说明
openclaw gateway	启动网关
openclaw gateway --port 18789	指定端口
openclaw gateway --verbose	启动并显示详细日志
openclaw gateway restart	重启网关
openclaw gateway --token <token>	带 Token 启动

六、聊天通道（Channel）管理

支持接入多种平台：

命令	说明
openclaw channels status	查看通道状态
openclaw channels list	查看通道列表
openclaw channels add	添加通道
openclaw channels add --channel telegram --token <BOT_TOKEN>	添加 Telegram
openclaw channels add --channel feishu	添加飞书
openclaw channels remove --channel <名称>	删除通道
openclaw channels logs	查看通道日志
openclaw channels login	登录通道
openclaw channels logout	登出通道

七、插件（Plugin）管理

命令	说明
openclaw plugins list	查看插件
openclaw plugins enable <name>	启用插件
openclaw plugins disable <name>	禁用插件
openclaw plugins install <name>	安装插件
openclaw plugins doctor	检查插件问题

示例：

openclaw plugins enable feishu
openclaw plugins enable qwen-portal-auth
openclaw models auth login --provider qwen-portal --set-default

八、技能（Skill）管理

命令	说明
openclaw skills list	查看技能
openclaw skills install <name>	安装技能

ClawHub 商店：

命令	说明
clawhub search <关键词>	搜索技能
clawhub install <name>	安装技能
clawhub list	查看已安装
clawhub sync --all	更新全部技能
clawhub update <name>	更新指定技能

九、消息与配对

命令	说明
openclaw message send --to <号码> --message "内容"	发送消息
openclaw agent --message "任务"	发送任务
openclaw agent --message "任务" --thinking high	高思考模式
openclaw pairing approve <通道> <配对码>	批准配对

十、沙箱（Sandbox）管理

命令	说明
openclaw sandbox explain	查看沙箱状态
openclaw sandbox explain --json	JSON 输出
openclaw sandbox list	查看容器
openclaw sandbox list --browser	查看浏览器容器
openclaw sandbox recreate --all	重建容器
openclaw sandbox recreate --all --force	强制重建

十一、浏览器控制

命令	说明
openclaw browser open <URL>	打开网页
openclaw browser snapshot	页面快照
openclaw browser click <元素>	点击元素
openclaw browser type <元素> <文字>	输入内容
openclaw browser screenshot	截图
openclaw browser close	关闭
openclaw browser console	控制台日志

十二、配置文件操作

命令	说明
openclaw config	查看配置
openclaw config edit	编辑配置

手动编辑：

Windows：

notepad %USERPROFILE%\.openclaw\openclaw.json

Mac/Linux：

nano ~/.openclaw/openclaw.json

十三、更新与维护

命令	说明
openclaw update	更新稳定版
openclaw update --channel stable	切换稳定通道
openclaw update --channel beta	切换测试通道
npm install -g openclaw@latest	npm 更新

第二部分：聊天斜杠命令

在 WebChat、飞书、Telegram 等对话窗口中使用。

会话管理

命令	说明
/new	新建会话
/new 任务	带任务新会话
/compact	压缩上下文
/status	查看状态
/help	查看命令

模型切换

命令	说明
/model	查看当前模型
/model <名称>	切换模型

会话历史

命令	说明
/sessions list	查看会话
/sessions history	查看历史
/sessions send	指定会话发消息
/sessions spawn	创建子会话

操作控制

命令	说明
/approve	批准操作
/deny	拒绝操作
/cancel	取消任务
/undo	撤销

技能与记忆

命令	说明
/skills	查看技能
/memory	查看记忆
/forget	删除记忆

信息查询

命令	说明
/cost	Token 消耗
/version	查看版本
/ping	测试连接

第三部分：关键文件路径速查

路径	说明
~/.openclaw/openclaw.json	主配置文件
~/.openclaw/workspace/	工作区
~/.openclaw/skills/	技能目录
~/.openclaw/agents/	Agent 数据
~/.openclaw/agents/<ID>/memory/	记忆
~/.openclaw/agents/<ID>/sessions/	会话

Windows 中：

~ = %USERPROFILE%

第四部分：新手急救流程

出问题按顺序：

openclaw doctor
openclaw logs
openclaw status
openclaw restart
openclaw doctor --fix

修改配置后的固定流程

编辑：

~/.openclaw/openclaw.json

保存后执行：

openclaw restart

完全重新配置

openclaw configure

未经允许不得转载，或转载时需注明出处：茄番番 » OpenClaw 完整命令手册与使用指南

标签：

猜你还喜欢

新闻分类