OpenClaw 提供了丰富的命令行工具，分为终端CLI命令和聊天斜杠命令两大类。以下是基于2026年5月最新资料的完整分类介绍。
一、基础与安装命令
1.1 版本与环境
| 命令 |
功能 |
示例 |
| openclaw --version / -V |
查看当前版本 |
openclaw --version |
| openclaw --help / -h |
显示所有命令帮助 |
openclaw --help |
| openclaw tui |
启动终端交互界面 |
openclaw tui |
| openclaw dashboard |
打开网页管理控制台 |
openclaw dashboard |
1.2 安装与初始化
| 命令 |
功能 |
说明 |
| openclaw setup |
初始化配置和工作区 |
首次安装后必须执行 |
| openclaw onboard |
交互式引导流程 |
依次配置Gateway、工作区、Skills |
| openclaw configure |
交互式配置向导 |
修改模型、频道、技能等核心配置 |
| openclaw update |
更新CLI到最新版本 |
openclaw update --channel stable |
| openclaw uninstall |
卸载Gateway服务和相关数据 |
openclaw uninstall --all --yes |
1.3 全局选项
| 选项 |
功能 |
说明 |
| --dev |
开发模式 |
独立配置+端口18790 |
| --profile <name> |
多配置文件隔离 |
工作/个人环境分开 |
| --log-level <level> |
设置日志级别 |
silent/fatal/error/warn/info/debug/trace |
| --no-color |
禁用彩色输出 |
脚本中使用 |
| --json |
JSON格式输出 |
机器可读格式 |
二、配置管理命令
2.1 配置读写
| 命令 |
功能 |
示例 |
| openclaw config get <path> |
读取指定配置值 |
openclaw config get gateway.port |
| openclaw config set <path> <value> |
设置配置值 |
openclaw config set gateway.port 18789 |
| openclaw config unset <path> |
删除配置项 |
openclaw config unset channels.telegram |
| openclaw config file |
显示配置文件路径 |
openclaw config file |
| openclaw config validate |
校验配置文件有效性 |
openclaw config validate |
2.2 常用配置路径
|
1
2
3
4
5
6
7
8
|
# 设置网关模式
openclaw config set gateway.mode local
# 设置绑定模式
openclaw config set gateway.bind loopback
# 设置API密钥
openclaw config set providers.anthropic.apiKey "sk-ant-xxxxx"
# 禁用记忆搜索
openclaw config set agents.defaults.memorySearch.enabled false
|
三、网关服务命令
3.1 生命周期管理
| 命令 |
功能 |
说明 |
| openclaw gateway / openclaw gateway run |
前台运行Gateway |
常搭配screen或tmux使用 |
| openclaw gateway start |
后台启动Gateway服务 |
系统服务方式运行 |
| openclaw gateway stop |
停止Gateway服务 |
临时暂停或维护 |
| openclaw gateway restart |
重启Gateway服务 |
修改配置后最常用 |
| openclaw gateway status |
探测Gateway RPC状态 |
检查服务是否存活 |
3.2 服务安装
| 命令 |
功能 |
说明 |
| openclaw gateway install |
安装为系统服务 |
systemd/launchd等 |
| openclaw gateway uninstall |
卸载系统服务 |
彻底移除服务 |
3.3 调试与发现
| 命令 |
功能 |
示例 |
| openclaw gateway call <method> |
调用指定RPC方法 |
openclaw gateway call health |
| openclaw gateway probe |
探测Gateway |
调试连接问题时使用 |
| openclaw gateway discover |
发现局域网中的Gateway实例 |
多实例环境使用 |
3.4 网关选项
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
|
# 指定端口启动
openclaw gateway --port 18789
# 强制杀掉占用端口并启动
openclaw gateway --force
# 详细日志输出
openclaw gateway --verbose
# 设置命令超时时间
openclaw gateway --timeout 30000
# 绑定模式设置
openclaw gateway --bind loopback # 仅本地
openclaw gateway --bind lan # 局域网
openclaw gateway --bind tailnet # Tailscale网络
|
四、模型管理命令
4.1 基本操作
| 命令 |
功能 |
示例 |
| openclaw models list |
列出所有可用模型 |
openclaw models list |
| openclaw models status |
模型状态概览 |
openclaw models status |
| openclaw models status --probe |
带探测的模型状态检查 |
深度检查模型可用性 |
| openclaw models set <name> |
设置默认模型 |
openclaw models set glm-4.7-flash |
| openclaw models set-image <name> |
设置图片生成模型 |
openclaw models set-image dalle-3 |
4.2 别名管理
| 命令 |
功能 |
示例 |
| openclaw models aliases list |
列出模型别名 |
openclaw models aliases list |
| openclaw models aliases add <alias> <model> |
添加模型别名 |
openclaw models aliases add gpt gpt-4 |
| openclaw models aliases remove <alias> |
移除模型别名 |
openclaw models aliases remove gpt |
4.3 回退模型
| 命令 |
功能 |
说明 |
| openclaw models fallbacks list |
列出回退模型列表 |
主模型不可用时使用 |
| openclaw models fallbacks add <model> |
添加回退模型 |
openclaw models fallbacks add glm-4.7 |
| openclaw models fallbacks remove <model> |
移除回退模型 |
清理不需要的回退模型 |
| openclaw models fallbacks clear |
清空回退模型列表 |
重置回退配置 |
4.4 认证管理
| 命令 |
功能 |
说明 |
| openclaw models auth add |
添加模型认证 |
配置API密钥 |
| openclaw models auth setup-token |
交互式设置API token |
推荐使用OAuth流程 |
| openclaw models auth paste-token |
直接粘贴API token |
快速配置 |
| openclaw models auth order get |
查看认证提供商顺序 |
优先级排序 |
| openclaw models auth order set |
设置认证提供商顺序 |
调整认证优先级 |
五、渠道管理命令
5.1 渠道操作
| 命令 |
功能 |
示例 |
| openclaw channels list |
显示所有已配置频道 |
openclaw channels list |
| openclaw channels status |
检查频道健康状态 |
openclaw channels status |
| openclaw channels status --probe |
带深度探测的频道状态检查 |
详细诊断 |
| openclaw channels add |
向导式添加新频道 |
openclaw channels add |
| openclaw channels login |
交互式登录 |
WhatsApp扫码登录 |
| openclaw channels login --channel <name> |
登录指定频道 |
openclaw channels login --channel whatsapp |
| openclaw channels logout |
登出频道 |
断开连接 |
| openclaw channels remove |
禁用并移除频道 |
openclaw channels remove --channel telegram |
5.2 渠道添加示例
|
1
2
3
4
5
6
7
8
9
10
11
|
# Telegram
openclaw channels add --channel telegram --token "BOT_TOKEN"
# Discord
openclaw channels add --channel discord --token "BOT_TOKEN"
# WhatsApp（扫码登录）
openclaw channels login --channel whatsapp
# 飞书
openclaw channels add --channel feishu --app-id "APP_ID" --app-secret "APP_SECRET"
|
六、技能与插件命令
6.1 技能管理
| 命令 |
功能 |
示例 |
| openclaw skills list |
列出所有已加载技能 |
openclaw skills list |
| openclaw skills info <name> |
查看指定技能详细信息 |
openclaw skills info browser |
| openclaw skills check |
就绪/缺失状态摘要 |
检查技能依赖 |
| openclaw skills install <name> |
安装新技能 |
openclaw skills install browser |
| openclaw skills enable <name> |
启用技能 |
openclaw skills enable browser |
| openclaw skills disable <name> |
禁用技能 |
openclaw skills disable browser |
6.2 插件管理
| 命令 |
功能 |
示例 |
| openclaw plugins list |
发现并列出所有插件 |
openclaw plugins list |
| openclaw plugins info <name> |
查看插件详细信息 |
openclaw plugins info feishu |
| openclaw plugins install <name> |
安装插件 |
支持本地路径、tgz或npm包名 |
| openclaw plugins enable <name> |
启用插件 |
openclaw plugins enable feishu |
| openclaw plugins disable <name> |
禁用插件 |
openclaw plugins disable feishu |
| openclaw plugins doctor |
插件加载错误诊断报告 |
排查插件问题 |
6.3 ClawHub社区技能
|
1
2
3
4
5
6
7
8
9
10
11
|
# 搜索技能
clawhub search "weather"
# 安装技能
clawhub install weather
# 同步所有技能
clawhub sync --all
# 列出已安装技能
clawhub list
|
七、消息与会话命令
7.1 消息操作
| 命令 |
功能 |
示例 |
| openclaw message send |
发送消息 |
openclaw message send --target +15555550123 --message "Hi" |
| openclaw message edit |
编辑已发送的消息 |
openclaw message edit --message-id 123 --message "Updated" |
| openclaw message delete |
删除消息 |
openclaw message delete --message-id 123 |
| openclaw message poll |
创建投票 |
openclaw message poll --question "Snack?" --option Pizza --option Sushi |
| openclaw message react |
添加/移除反应 |
openclaw message react --emoji "?" |
| openclaw message broadcast |
广播消息到多个目标 |
群发消息 |
7.2 会话管理
| 命令 |
功能 |
示例 |
| openclaw sessions list |
列出所有会话 |
openclaw sessions list |
| openclaw sessions history |
查看会话历史 |
openclaw sessions history <session-key> |
| openclaw memory |
管理记忆 |
openclaw memory search "会议记录" |
| openclaw memory index |
重建向量索引 |
修复记忆索引错误 |
7.3 Agent管理
| 命令 |
功能 |
示例 |
| openclaw agents list |
列出所有已配置的agents |
openclaw agents list |
| openclaw agents add [name] |
通过向导添加新agent |
openclaw agents add assistant |
| openclaw agents delete <name> |
删除指定agent |
openclaw agents delete old-assistant |
| openclaw agents bindings |
列出所有路由绑定 |
查看agent与渠道的绑定关系 |
| openclaw agents bind |
添加路由绑定 |
将agent绑定到频道/群组 |
| openclaw agents unbind |
移除路由绑定 |
解除绑定关系 |
八、诊断与维护命令
8.1 健康检查
| 命令 |
功能 |
说明 |
| openclaw doctor |
最有用的单条命令 |
全面健康检查并提供快速修复建议 |
| openclaw doctor --fix |
自动修复常见问题 |
自动修正配置文件权限等 |
| openclaw doctor --deep |
深度诊断 |
复杂故障排查 |
| openclaw health |
获取运行中Gateway的健康状态 |
快速确认核心组件状态 |
| openclaw status |
显示会话健康状态和最近接收者 |
整体运行状态概览 |
8.2 日志管理
| 命令 |
功能 |
示例 |
| openclaw logs |
查看Gateway日志 |
openclaw logs |
| openclaw logs --follow |
实时查看运行日志 |
类似 tail -f |
| openclaw logs --filter error |
仅查看错误日志 |
快速定位故障 |
| openclaw logs --start "2026-03-13" |
指定开始时间 |
时间范围查询 |
| openclaw logs --search "error" |
关键词过滤 |
搜索特定内容 |
8.3 系统管理
| 命令 |
功能 |
示例 |
| openclaw system event --text <msg> |
向系统事件队列入队一条事件 |
测试事件系统 |
| openclaw system heartbeat last |
查看上次心跳时间 |
检查定时任务 |
| openclaw system heartbeat enable |
启用心跳 |
开启定时任务 |
| openclaw system heartbeat disable |
禁用心跳 |
关闭定时任务 |
| openclaw system presence |
列出系统在线状态 |
查看连接状态 |
8.4 安全与备份
| 命令 |
功能 |
说明 |
| openclaw security audit |
安全审计 |
检查安全配置 |
| openclaw security audit --deep |
深度安全审计 |
全面安全检查 |
| openclaw secrets reload |
刷新敏感密钥 |
重新加载密钥 |
| openclaw backup create |
创建系统备份 |
备份配置和数据 |
| openclaw reset |
重置系统状态 |
谨慎使用，保留CLI |
| openclaw uninstall --all --yes |
彻底卸载 |
清理所有数据 |
九、聊天斜杠命令（Slash Commands）
9.1 会话管理
| 命令 |
功能 |
说明 |
| /new |
开启新会话线程 |
清空上下文，节省token |
| /new <描述> |
带目标启动新会话 |
指定会话目标 |
| /reset |
重置当前会话 |
同 /new |
| /status |
查看当前会话状态 |
包括模型、上下文、队列等信息 |
| /compact |
压缩上下文 |
释放上下文窗口空间 |
| /history |
查看会话历史记录 |
浏览对话历史 |
| /pause |
暂停当前任务 |
临时停止AI执行 |
9.2 模型控制
| 命令 |
功能 |
示例 |
| /model <名称> |
切换模型 |
/model glm-4.7-flash |
| /reasoning |
开启/关闭深度推理模式 |
/reasoning on |
| /reasoning <级别> |
调整推理级别 |
/reasoning high |
| /think <级别> |
设置思考级别 |
/think medium |
| /verbose on/off |
开启/关闭详细输出 |
/verbose on |
9.3 技能与工具
| 命令 |
功能 |
示例 |
| /skills |
查看已安装技能 |
列出所有可用技能 |
| /skill <name> [input] |
直接运行技能 |
/skill weather 北京 |
| /agents |
查看可用Agent |
列出所有Agent |
| /memory |
查看或管理AI的记忆 |
查询AI记住的信息 |
| /forget |
忘记特定信息 |
清除记忆 |
9.4 操作控制
| 命令 |
功能 |
说明 |
| /stop |
中止当前正在运行的任务 |
紧急停止 |
| /approve |
批准配对请求 |
允许新联系人 |
| /deny |
拒绝配对请求 |
拒绝新联系人 |
| /cancel |
取消当前操作 |
取消正在执行的任务 |
| /undo |
撤销上一步操作 |
回退操作 |
9.5 信息查询
| 命令 |
功能 |
说明 |
| /help |
显示帮助信息 |
列出可用命令列表 |
| /commands |
查看所有命令 |
同 /help |
| /cost |
查看使用费用 |
查询API调用成本 |
| /version |
查看版本信息 |
显示OpenClaw版本 |
| /ping |
测试连接状态 |
检查服务是否正常 |
| /deliver |
交付当前任务结果 |
完成并输出结果 |
十、高级与扩展命令
10.1 定时任务
| 命令 |
功能 |
示例 |
| openclaw cron list |
查看定时任务 |
openclaw cron list |
| openclaw cron add |
添加定时任务 |
openclaw cron add "0 9 * * *" "check_disk" |
| openclaw cron edit <id> |
编辑定时任务 |
修改任务配置 |
| openclaw cron rm <id> |
删除定时任务 |
移除指定任务 |
| openclaw cron run <id> |
立即执行定时任务 |
手动触发任务 |
10.2 浏览器控制
| 命令 |
功能 |
示例 |
| openclaw browser start |
启动浏览器 |
开启浏览器实例 |
| openclaw browser open <url> |
打开网页 |
openclaw browser open https://example.com |
| openclaw browser click <selector> |
点击元素 |
openclaw browser click "#login" |
| openclaw browser type <selector> <text> |
输入文本 |
openclaw browser type "#username" "admin" |
| openclaw browser screenshot |
截图 |
保存当前页面截图 |
10.3 节点管理
| 命令 |
功能 |
说明 |
| openclaw node run |
前台运行headless node host |
调试模式 |
| openclaw node start |
启动node host服务 |
后台运行 |
| openclaw node stop |
停止node host服务 |
关闭节点 |
| openclaw node restart |
重启node host服务 |
重新启动 |
| openclaw node status |
显示node host状态 |
检查节点状态 |
| openclaw nodes |
管理移动节点 |
查看所有节点 |
10.4 配对管理
| 命令 |
功能 |
说明 |
| openclaw pairing list |
查看待处理的配对请求 |
审批新联系人 |
| openclaw pairing approve |
批准配对请求 |
允许新联系人 |
| openclaw pairing deny |
拒绝配对请求 |
拒绝新联系人 |
十一、故障排查流程
11.1 标准排查步骤
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
|
# 1. 检查状态
openclaw gateway status
# 2. 查看日志
openclaw logs --follow
# 3. 健康检查
openclaw doctor
# 4. 自动修复
openclaw doctor --fix
# 5. 重启服务
openclaw gateway restart
|
11.2 常见问题解决
| 问题 |
解决方案 |
| 配置修改不生效 |
openclaw gateway restart |
| JSON语法错误 |
openclaw doctor --fix |
| 网关宕机 |
openclaw doctor --deep |
| 记忆索引错误 |
openclaw memory index |
| 授权过期 |
openclaw models auth setup-token |
| 不回复私聊 |
进入Pairing List手动批准 |
| 群聊静默 |
检查MentionPatterns配置 |
十二、命令使用频率统计
高频命令（每日使用）
- openclaw gateway restart - 修改配置后必用
- openclaw doctor - 出问题先跑这个
- openclaw status - 快速检查状态
- openclaw logs --follow - 实时查看日志
- /new - 开启新会话
中频命令（每周使用）
- openclaw models set - 切换模型
- openclaw skills install - 安装新技能
- openclaw channels status - 检查渠道连接
- openclaw config set - 修改配置
- clawhub search - 搜索技能
低频命令（每月使用）
- openclaw update - 更新版本
- openclaw backup create - 创建备份
- openclaw security audit - 安全审计
- openclaw reset - 重置配置
- openclaw uninstall - 卸载系统
十三、实用技巧与最佳实践
13.1 多环境管理
|
1
2
3
4
5
6
7
8
|
# 工作环境
openclaw --profile work gateway start
# 个人环境
openclaw --profile personal gateway start
# 开发环境
openclaw --dev gateway start
|
13.2 脚本自动化
|
1
2
3
4
5
6
7
8
|
# 批量执行命令
openclaw run --batch commands.txt
# 管道输入
echo "分析这段代码" | openclaw run
# JSON输出处理
openclaw models list --json | jq '.models[] | select(.provider=="openai")'
|
13.3 快捷键与别名
|
1
2
3
4
5
6
|
# 创建别名（在~/.bashrc或~/.zshrc中）
alias claw='openclaw'
alias claw-status='openclaw gateway status'
alias claw-restart='openclaw gateway restart'
alias claw-logs='openclaw logs --follow'
alias claw-doctor='openclaw doctor --fix'
|
13.4 配置文件位置
- 主配置：~/.openclaw/openclaw.json
- 工作区：~/.openclaw/workspace/
- 技能目录：~/.openclaw/skills/
- Agent数据：~/.openclaw/agents/
- 日志文件：~/.openclaw/logs/
十四、总结
OpenClaw的命令体系设计清晰，分为CLI命令和斜杠命令两大类别，覆盖了从系统管理到日常使用的所有场景。掌握这些命令，您就能充分发挥OpenClaw作为个人AI助手的强大能力。
核心要点：
- 配置修改后必须重启网关：openclaw gateway restart
- 出问题先跑诊断：openclaw doctor
- 实时查看日志：openclaw logs --follow
- 多环境隔离：使用--profile参数
- 技能扩展：通过ClawHub社区安装
这份命令大全基于2026年5月的最新资料整理，涵盖了OpenClaw的所有核心功能。建议收藏本文，使用时通过Ctrl+F快速查找所需命令。
|
