书接上文:OpenClaw(2026.3.7)+Termux+智谱-安卓手机部署与配置指南
OpenClaw 提供了丰富的命令行工具,分为终端CLI命令 和聊天斜杠命令两大类。以下是基于2026年3月最新资料的完整分类介绍。
📋 一、基础与安装命令
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 常用配置路径
bash
# 设置网关模式
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 网关选项
bash
# 指定端口启动
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 渠道添加示例
bash
# 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社区技能
bash
# 搜索技能
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 标准排查步骤
bash
# 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 多环境管理
bash
# 工作环境
openclaw --profile work gateway start
# 个人环境
openclaw --profile personal gateway start
# 开发环境
openclaw --dev gateway start
13.2 脚本自动化
bash
# 批量执行命令
openclaw run --batch commands.txt
# 管道输入
echo "分析这段代码" | openclaw run
# JSON输出处理
openclaw models list --json | jq '.models[] | select(.provider=="openai")'
13.3 快捷键与别名
bash
# 创建别名(在~/.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年3月的最新资料整理,涵盖了OpenClaw的所有核心功能。建议收藏本文,使用时通过Ctrl+F快速查找所需命令。