ORANGE BOOK · OPENCLAW

附录 A 常用命令速查表

一、安装 / 升级 / 卸载

# 一键安装（macOS / Linux）
curl -fsSL https://openclaw.ai/install.sh | bash

# 一键安装（Windows，管理员 PowerShell）
iwr -useb https://openclaw.ai/install.ps1 | iex

# npm 安装
npm install -g openclaw@latest

# 国内镜像
npm install -g openclaw@latest --registry https://registry.npmmirror.com

# 升级
openclaw upgrade

# 卸载
openclaw uninstall

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

二、初始化与基础

# 首次引导
openclaw onboard

# 引导 + 安装后台守护
openclaw onboard --install-daemon

# 查看状态
openclaw status

# 启动文本界面
openclaw tui

# 启动 Web 界面
openclaw web
openclaw web --port 7799     # 指定端口

# 后台守护
openclaw daemon start
openclaw daemon stop
openclaw daemon restart
openclaw daemon status

# 完整诊断打包
openclaw doctor

# 进入只读安全模式（紧急）
openclaw safe-mode

# 杀掉所有运行中的代理
openclaw kill --all

三、模型管理

# 添加模型（交互式）
openclaw models add

# 列出已配模型
openclaw models list

# 查看某模型详情
openclaw models info <provider>/<model>

# 测试可用性
openclaw models test <provider>/<model>

# 设置默认模型
openclaw models set-default <provider>/<model>

# 删除模型
openclaw models remove <provider>/<model>

# 查看本月使用量与成本
openclaw models usage --since 2026-04-01

# 编辑配置文件（直接打开编辑器）
openclaw config edit

# 校验配置
openclaw config validate

四、记忆与上下文

# 添加全局记忆
openclaw memory add

# 列出
openclaw memory list

# 编辑
openclaw memory edit <id>

# 删除
openclaw memory remove <id>

# 导出 / 导入（用于换电脑）
openclaw memory export ~/Desktop/memory.json
openclaw memory import ~/Desktop/memory.json

五、提示词模板

# 列出
openclaw prompt list

# 跑一个模板
openclaw prompt run <name> --var1 val1 --var2 val2

# 查看模板内容
openclaw prompt show <name>

# 创建新模板
openclaw prompt create <name>

# 编辑
openclaw prompt edit <name>

# 删除
openclaw prompt remove <name>

# 从社区库装一个模板
openclaw prompt install <github-url>

六、Skills 管理（Claw Hub）

# 搜索
clawhub search "关键词"

# 查看详情
clawhub info <skill-name>

# 安装
clawhub install <skill-name>
clawhub install <skill-name>@1.2.3   # 指定版本
clawhub install <skill-name>@beta    # 标签

# 升级
clawhub update <skill-name>
clawhub update --all

# 列出已装
clawhub list
clawhub list --usage           # 按使用频率排序
clawhub list --size            # 按占用磁盘排序

# 卸载
clawhub uninstall <skill-name>
clawhub uninstall --unused-since 90d   # 清理超过 90 天没用的

# 查看 Skill 源码（学习用）
clawhub source <skill-name>

# 安全审计
clawhub audit <skill-name>

# 全部 Skill 安全审计
clawhub audit --all

# 离线包导出（备份用）
clawhub export <skill-name> > skill.tgz
clawhub import skill.tgz

七、Skill 开发

# 创建骨架
clawhub init <skill-name>

# 本地调试（热加载）
clawhub dev

# 跑测试
npm test

# 校验发布前的元信息
clawhub validate

# 登录 Claw Hub
clawhub login
clawhub logout

# 发布
clawhub publish
clawhub publish --tag beta
clawhub publish --dry-run

# 撤回某个版本
clawhub unpublish <skill-name>@1.2.3

# 查看自己发布的 Skill 数据
clawhub stats my

八、工作流

# 添加工作流（从 yaml 文件）
openclaw workflow add <yaml-path>

# 列出
openclaw workflow list

# 启用 / 禁用
openclaw workflow enable <name>
openclaw workflow disable <name>

# 立刻跑一次
openclaw workflow run <name>

# 干跑
openclaw workflow run <name> --dry-run

# 查看运行历史
openclaw workflow history <name> --limit 10

# 查看一次具体运行的日志
openclaw workflow logs <run-id>

# 删除
openclaw workflow remove <name>

# 改完 yaml 不重启
openclaw workflow reload <name>

# 总状态
openclaw workflow status

# 统计：本月各工作流的执行次数与成本
openclaw workflow stats --since 2026-04-01
openclaw workflow stats --group-by name

九、子代理（Sub-Agent）

# 在 tui / web 界面斜杠命令
/subagents list
/subagents spawn --model deepseek/deepseek-chat --timeout 60
/subagents info <id>
/subagents kill <id>
/subagents wait <id>

# 命令行
openclaw subagents list
openclaw subagents kill <id>
openclaw subagents stats

十、安全与权限

# 完整审计
openclaw security audit
openclaw security audit --deep

# 自动修复（建议先看后修）
openclaw security audit --fix

# 沙箱自检
openclaw security sandbox-check

# 立即撤销所有 API Key
openclaw secrets revoke --all

# 列出已配密钥
openclaw secrets list

# 删除某个密钥
openclaw secrets remove <name>

十一、日志与调试

# 看最近日志
openclaw logs

# 只看错误
openclaw logs --level error

# 看某个时间窗口
openclaw logs --since 1h
openclaw logs --since "2026-04-19 09:00" --until "2026-04-19 18:00"

# 跟随日志（tail -f）
openclaw logs --follow

# 看某个 Skill 的日志
openclaw logs --skill browser-pilot

# 看某个工作流的日志
openclaw logs --workflow morning-brief

# 清理 30 天以上的日志
openclaw logs --cleanup --older-than 30d

# 系统资源占用
openclaw stats

十二、MCP（Model Context Protocol）

# 添加 MCP 服务器
openclaw mcp add <name> --command "<启动命令>" --trust-level prompt-on-action

# 列出
openclaw mcp list

# 查看可用工具
openclaw mcp tools <name>

# 重启
openclaw mcp restart <name>

# 审计 MCP 服务器
openclaw mcp audit <name>

# 删除
openclaw mcp remove <name>

十三、备份与迁移

# 一键导出全部配置
openclaw backup export ~/Desktop/openclaw-backup.tar.gz

# 导入
openclaw backup import ~/Desktop/openclaw-backup.tar.gz

# 只导出某个工作流
openclaw workflow export <name> > <name>.yaml

# 仅导出 prompts 模板
openclaw prompt export-all ~/Desktop/prompts/

十四、单次任务

# 不进入交互界面，命令行一次性跑
openclaw run "请帮我把 ~/Downloads 整理一下，先 dry-run"

# 指定模型
openclaw run --model deepseek/deepseek-reasoner "..."

# 临时升级权限
openclaw run --permissions allow=fs.write "..."

# 用某个 Skill
openclaw run --use-skills excel-power "..."

十五、CRON 表达式速查

* * * * *
│ │ │ │ │
│ │ │ │ └── 星期 (0-7, 0/7 = 周日)
│ │ │ └──── 月 (1-12)
│ │ └────── 日 (1-31)
│ └──────── 时 (0-23)
└────────── 分 (0-59)

常用表达式：
"0 8 * * *"          每天 8:00
"*/30 * * * *"       每 30 分钟
"0 9 * * 1-5"        工作日 9:00
"0 17 * * 5"         每周五 17:00
"0 22 1 * *"         每月 1 号 22:00
"0 0 1 1 *"          每年 1 月 1 日
"0 9-18 * * 1-5"     工作日 9:00 到 18:00 每小时

OpenClaw 扩展 6 段（首位为秒，慎用）：
"*/30 * * * * *"     每 30 秒
"0 */5 * * * *"      每 5 分钟（在第 0 秒触发）

十六、常用环境变量

# 模型 Key
export DEEPSEEK_API_KEY="sk-xxx"
export OPENAI_API_KEY="sk-xxx"
export ANTHROPIC_API_KEY="sk-ant-xxx"
export GOOGLE_API_KEY="xxx"
export MOONSHOT_API_KEY="sk-xxx"

# 行为开关
export OPENCLAW_HOME="$HOME/.openclaw"   # 自定义配置目录
export OPENCLAW_LOG_LEVEL="info"         # debug / info / warn / error
export OPENCLAW_PROXY="http://127.0.0.1:7890"   # HTTP 代理
export OPENCLAW_NO_TELEMETRY=1           # 关闭遥测