附录A 命令速查表

💡 本附录目标：提供OpenClaw常用命令的快速参考，方便日常使用时查阅。

📋 目录

A.1 基础命令
A.2 文件操作命令
A.3 系统操作命令
A.4 Skills管理命令
A.5 高级命令

A.1 基础命令

A.1.1 启动与停止

bash

# 启动OpenClaw
openclaw start

# 停止OpenClaw
openclaw stop

# 重启OpenClaw
openclaw restart

# 查看运行状态
openclaw status

# 启动TUI界面
openclaw tui

# 启动Gateway
openclaw gateway start

# 停止Gateway
openclaw gateway stop

# 重启Gateway
openclaw gateway restart

A.1.2 版本与帮助

bash

# 查看版本
openclaw --version
openclaw -v

# 查看帮助
openclaw --help
openclaw -h

# 查看子命令帮助
openclaw config --help
openclaw models --help
openclaw skills --help

# 健康检查
openclaw health

# 综合诊断与修复建议
openclaw doctor
openclaw doctor --yes  # 自动执行修复
openclaw doctor --non-interactive  # 非交互模式

A.1.3 配置管理

bash

# 交互式配置向导
openclaw configure

# 查看所有配置
openclaw config list

# 查看特定配置
openclaw config get <path>
openclaw config get model.apiKey
openclaw config get model.name

# 设置配置（支持JSON5/raw文本）
openclaw config set <path> <value>
openclaw config set model.apiKey "sk-xxx"
openclaw config set model.name "claude-sonnet-4"

# 删除配置
openclaw config unset <path>
openclaw config delete model.apiKey

# 重置配置
openclaw config reset

# 导出配置
openclaw config export > config-backup.json

# 导入配置
openclaw config import config-backup.json

A.1.4 Gateway管理

bash

# 安装系统服务（根据平台注册守护进程）
openclaw gateway install

# 启动Gateway服务
openclaw gateway start

# 停止Gateway服务
openclaw gateway stop

# 重启Gateway服务（配置变更后应用）
openclaw gateway restart

# 查看Gateway系统服务状态
openclaw gateway status

# 查看Gateway是否可达
openclaw status

A.1.5 对话管理

bash

# 发送消息
openclaw agent --message "你好"
openclaw message send "你好"

# 查看对话历史
openclaw conversation list

# 清空对话历史
openclaw conversation clear

A.1.6 通道管理

bash

# 列出已登录通道（WhatsApp/Telegram等）
openclaw channels list

# 登录新的通道账号（扫描/授权链接）
openclaw channels login

# 查看通道状态
openclaw channels status

A.1.7 日志管理

bash

# 显示日志
openclaw logs

# 实时跟踪日志
openclaw logs --follow

# JSON格式日志
openclaw logs --json

# 纯文本日志
openclaw logs --plain

# 限制日志行数
openclaw logs --limit 100

清理旧对话（保留最近N条）

openclaw conversation clean --keep 20

导出对话历史

openclaw conversation export > conversation.json

导入对话历史

openclaw conversation import conversation.json


---

## A.2 文件操作命令

### A.2.1 文件搜索

搜索文件（按名称）

"帮我找一下名为'报告.pdf'的文件"

搜索文件（按内容）

"帮我找一下包含'OpenClaw'的文件"

搜索文件（按类型）

"帮我找一下所有的PDF文件"

搜索文件（按时间）

"帮我找一下最近7天修改的文件"

搜索文件（按大小）

"帮我找一下大于100MB的文件"

组合搜索

"帮我找一下最近7天修改的、包含'OpenClaw'的PDF文件"


### A.2.2 文件处理

读取文件

"帮我读一下这个文件：~/Documents/report.pdf"

总结文件

"帮我总结一下这个文件：~/Documents/report.pdf"

提取信息

"帮我从这个文件中提取所有的日期和金额：~/Documents/invoice.pdf"

转换格式

"帮我把这个Word文档转成PDF：~/Documents/report.docx"

合并文件

"帮我把这个文件夹里的所有PDF合并成一个：~/Documents/reports/"

压缩文件

"帮我把这个文件夹压缩成zip：~/Documents/project/"


### A.2.3 文件整理

批量重命名

"帮我把这个文件夹里的所有文件，按照'日期-文件名'的格式重命名"

按类型分类

"帮我把桌面上的文件按类型分类到不同的文件夹"

按日期分类

"帮我把这个文件夹里的文件按月份分类"

删除重复文件

"帮我找出并删除这个文件夹里的重复文件"

清理临时文件

"帮我清理系统临时文件"

整理下载文件夹

"帮我整理下载文件夹，按类型分类"


---

## A.3 系统操作命令

### A.3.1 应用程序控制

打开应用

"帮我打开Chrome" "帮我打开微信"

关闭应用

"帮我关闭Chrome"

切换应用

"帮我切换到Chrome"

查看运行的应用

"帮我看一下现在运行了哪些应用"

强制退出应用

"帮我强制退出Chrome"


### A.3.2 系统信息

查看系统信息

"帮我看一下系统信息"

查看CPU使用率

"帮我看一下CPU使用率"

查看内存使用

"帮我看一下内存使用情况"

查看硬盘空间

"帮我看一下硬盘空间"

查看网络状态

"帮我看一下网络连接状态"

查看电池状态（笔记本）

"帮我看一下电池状态"


### A.3.3 截图与录屏

截取全屏

"帮我截个全屏"

截取窗口

"帮我截取Chrome窗口"

截取区域

"帮我截取屏幕左上角的区域"

延迟截图

"帮我5秒后截个图"

录制屏幕

"帮我录制屏幕"

停止录制

"帮我停止录制"


---

## A.4 Skills管理命令

### A.4.1 Skills安装

列出可用Skills

openclaw skills list

查看技能详情

openclaw skills info <skill>

搜索Skills

openclaw skills search "文件管理"

安装Skills

clawhub install peekaboo clawhub install @openclaw/feishu

安装指定版本

clawhub install peekaboo@1.0.0

从URL安装

clawhub install https://github.com/user/skill.git

从本地安装

clawhub install ./my-skill/


### A.4.2 Skills管理

查看已安装Skills

openclaw skills list --installed

查看Skills详情

openclaw skills info peekaboo

更新Skills

openclaw skills update peekaboo

更新所有Skills

openclaw skills update --all

卸载Skills

openclaw skills uninstall peekaboo

启用Skills

openclaw skills enable peekaboo

禁用Skills

openclaw skills disable peekaboo


### A.4.3 Skills配置

查看Skills配置

openclaw skills config peekaboo

设置Skills配置

openclaw skills config peekaboo --set key=value

重置Skills配置

openclaw skills config peekaboo --reset

导出Skills配置

openclaw skills config peekaboo --export > peekaboo-config.json

导入Skills配置

openclaw skills config peekaboo --import peekaboo-config.json


---

## A.5 高级命令

### A.5.1 模型管理

列出可用模型

openclaw models list

列出已配置模型

openclaw models list --configured

添加模型

openclaw models add
--provider anthropic
--name claude-sonnet-4
--apiKey sk-xxx

删除模型

openclaw models remove claude-sonnet-4

设置默认模型

openclaw models set-default claude-sonnet-4

测试模型连接

openclaw models test claude-sonnet-4

查看模型使用统计

openclaw models stats


### A.5.2 插件管理

列出插件

openclaw plugins list

安装插件

openclaw plugins install <id> openclaw plugins install @openclaw/voice-call

启用插件（需要重启网关）

openclaw plugins enable <id>

禁用插件

openclaw plugins disable <id>

卸载插件

openclaw plugins uninstall <id>

查看插件详情

openclaw plugins info <id>


### A.5.3 卸载命令

官方推荐卸载方式

openclaw uninstall

全自动卸载（包含状态、workspace、插件等）

openclaw uninstall --all --yes --non-interactive

仅删除状态文件（不删除workspace/CLI）

openclaw uninstall --state

仅删除工作区（移除agent/workspace文件）

openclaw uninstall --workspace

仅卸载服务（不删除数据）

openclaw uninstall --service

模拟卸载（显示结果但不实际执行）

openclaw uninstall --dry-run


### A.5.4 日志管理

查看日志

openclaw logs

查看最近N行日志

openclaw logs --tail 100

实时查看日志

openclaw logs --follow

查看错误日志

openclaw logs --level error

清空日志

openclaw logs clear

导出日志

openclaw logs export > logs.txt


### A.5.5 性能优化

清理缓存

openclaw cache clear

查看缓存大小

openclaw cache size

优化数据库

openclaw db optimize

重建索引

openclaw db reindex

检查健康状态

openclaw health check

性能诊断

openclaw diagnose


### A.5.4 备份与恢复

备份配置

openclaw backup create

校验备份（2026.3.8+）

openclaw backup verify <backup-id或文件路径>

仅备份配置（2026.3.8+）

openclaw backup create --only-config

备份但不包含workspace（2026.3.8+）

openclaw backup create --no-include-workspace

列出备份

openclaw backup list

恢复备份

openclaw backup restore backup-20260210.tar.gz

删除备份

openclaw backup delete backup-20260210.tar.gz

自动备份设置

openclaw backup auto --enable openclaw backup auto --disable


---

## 📝 常用命令组合

### 场景1：初次安装后的配置

1. 配置API Key

openclaw config set model.apiKey "sk-xxx"

2. 设置默认模型

openclaw config set model.name "claude-sonnet-4"

3. 启用自动清理

openclaw config set conversation.autoClean true

4. 重启Gateway

openclaw gateway restart

5. 测试连接

openclaw agent --message "你好"


### 场景2：切换模型

1. 查看可用模型

openclaw models list

2. 切换模型

openclaw config set model.name "deepseek-chat"

3. 重启Gateway

openclaw gateway restart

4. 测试新模型

openclaw agent --message "测试"


### 场景3：安装新Skills

1. 搜索Skills

openclaw skills search "截图"

2. 安装Skills

clawhub install peekaboo

3. 查看Skills配置

openclaw skills config peekaboo

4. 重启Gateway

openclaw gateway restart

5. 测试Skills

"帮我截个图"


### 场景4：性能优化

1. 清理对话历史

openclaw conversation clean --keep 20

2. 清理缓存

openclaw cache clear

3. 优化数据库

openclaw db optimize

4. 重启Gateway

openclaw gateway restart

5. 检查性能

openclaw health check


### 场景5：故障排查

1. 查看运行状态

openclaw status

2. 查看日志

openclaw logs --tail 100

3. 检查配置

openclaw config list

4. 测试模型连接

openclaw models test

5. 性能诊断

openclaw diagnose


---

## 🔧 配置文件路径

主配置文件

~/.openclaw/openclaw.json

Skills目录

~/.openclaw/extensions/

日志目录

~/.openclaw/logs/

缓存目录

~/.openclaw/cache/

备份目录

~/.openclaw/backups/

对话历史

~/.openclaw/conversations/


---

## 💡 使用技巧

### 技巧1：使用别名

在 ~/.zshrc 或 ~/.bashrc 中添加

alias oc="openclaw" alias ocg="openclaw gateway" alias occ="openclaw config" alias ocs="openclaw skills"

使用别名

oc chat "你好" ocg restart occ get model.name ocs list


### 技巧2：使用管道

从文件读取内容发送

cat report.txt | openclaw agent --message

保存输出到文件

openclaw agent --message "总结一下OpenClaw的优势" > summary.txt

组合使用

cat input.txt | openclaw agent --message | tee output.txt


### 技巧3：使用环境变量

设置环境变量

export OPENCLAW_API_KEY="sk-xxx" export OPENCLAW_MODEL="claude-sonnet-4"

OpenClaw会自动读取这些环境变量

openclaw start


### 技巧4：批量操作

批量安装Skills

for skill in peekaboo feishu telegram; do clawhub install $skill done

批量更新Skills

openclaw skills list --installed | xargs -I {} openclaw skills update {}

批量测试模型

openclaw models list | xargs -I {} openclaw models test {}


---

## 📚 相关资源

- OpenClaw官方文档：https://docs.openclaw.ai/
- 命令行参考：https://docs.openclaw.ai/cli
- Skills市场：https://hub.openclaw.ai/
- 社区论坛：https://community.openclaw.ai/

---

**提示**：本速查表会随OpenClaw版本更新而更新，建议收藏本页面以便随时查阅。


### A.X ACP 溯源与回执（2026.3.8+）

为 ACP 会话注入溯源元数据（可选）

openclaw acp --provenance meta

注入溯源元数据 + 可见回执（用于审计/追踪）

openclaw acp --provenance meta+receipt

#关闭溯源（默认行为可能随版本变化，以官方为准） openclaw acp --provenance off

附录A 命令速查表 ​

📋 目录 ​

A.1 基础命令 ​

A.1.1 启动与停止 ​

A.1.2 版本与帮助 ​

A.1.3 配置管理 ​

A.1.4 Gateway管理 ​

A.1.5 对话管理 ​

A.1.6 通道管理 ​

A.1.7 日志管理 ​

清理旧对话（保留最近N条） ​

导出对话历史 ​

导入对话历史 ​

搜索文件（按名称） ​

搜索文件（按内容） ​

搜索文件（按类型） ​

搜索文件（按时间） ​

搜索文件（按大小） ​

组合搜索 ​

读取文件 ​

总结文件 ​

提取信息 ​

转换格式 ​

合并文件 ​

压缩文件 ​

批量重命名 ​

按类型分类 ​

按日期分类 ​

删除重复文件 ​

清理临时文件 ​

整理下载文件夹 ​

打开应用 ​

关闭应用 ​

切换应用 ​

查看运行的应用 ​

强制退出应用 ​

查看系统信息 ​

查看CPU使用率 ​

查看内存使用 ​

查看硬盘空间 ​

查看网络状态 ​

查看电池状态（笔记本） ​

截取全屏 ​

截取窗口 ​

截取区域 ​

延迟截图 ​

录制屏幕 ​

停止录制 ​

列出可用Skills ​

查看技能详情 ​

搜索Skills ​

安装Skills ​

安装指定版本 ​

从URL安装 ​

从本地安装 ​

查看已安装Skills ​

查看Skills详情 ​

更新Skills ​

更新所有Skills ​

卸载Skills ​

启用Skills ​

禁用Skills ​

查看Skills配置 ​

设置Skills配置 ​

重置Skills配置 ​

导出Skills配置 ​

导入Skills配置 ​

列出可用模型 ​

列出已配置模型 ​

添加模型 ​

删除模型 ​

设置默认模型 ​

测试模型连接 ​

查看模型使用统计 ​

列出插件 ​

安装插件 ​

启用插件（需要重启网关） ​

禁用插件 ​

卸载插件 ​

查看插件详情 ​

附录A 命令速查表

📋 目录

A.1 基础命令

A.1.1 启动与停止

A.1.2 版本与帮助

A.1.3 配置管理

A.1.4 Gateway管理

A.1.5 对话管理

A.1.6 通道管理

A.1.7 日志管理

清理旧对话（保留最近N条）

导出对话历史

导入对话历史

搜索文件（按名称）

搜索文件（按内容）

搜索文件（按类型）

搜索文件（按时间）

搜索文件（按大小）

组合搜索

读取文件

总结文件

提取信息

转换格式

合并文件

压缩文件

批量重命名

按类型分类

按日期分类

删除重复文件

清理临时文件

整理下载文件夹

打开应用

关闭应用

切换应用

查看运行的应用

强制退出应用

查看系统信息

查看CPU使用率

查看内存使用

查看硬盘空间

查看网络状态

查看电池状态（笔记本）

截取全屏

截取窗口

截取区域

延迟截图

录制屏幕

停止录制

列出可用Skills

查看技能详情

搜索Skills

安装Skills

安装指定版本

从URL安装

从本地安装

查看已安装Skills

查看Skills详情

更新Skills

更新所有Skills

卸载Skills

启用Skills

禁用Skills

查看Skills配置

设置Skills配置

重置Skills配置

导出Skills配置

导入Skills配置

列出可用模型

列出已配置模型

添加模型

删除模型

设置默认模型

测试模型连接

查看模型使用统计

列出插件

安装插件

启用插件（需要重启网关）

禁用插件

卸载插件

查看插件详情