附录A 命令速查表

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

📋 目录

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

A.1 基础命令

A.1.1 启动与停止

# 启动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 版本与帮助

# 查看版本
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 配置管理

# 交互式配置向导
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管理

# 安装系统服务（根据平台注册守护进程）
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 对话管理

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

# 查看对话历史
openclaw conversation list

# 清空对话历史
openclaw conversation clear

A.1.6 通道管理

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

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

# 查看通道状态
openclaw channels status

A.1.7 日志管理

# 显示日志
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 文件搜索

```bash
# 搜索文件（按名称）
"帮我找一下名为'报告.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