当前位置：首页 > news >正文

Openclaw 附录A 命令速查表

news 2026/3/26 21:38:29

附录A 命令速查表

💡本附录目标：提供OpenClaw常用命令的快速参考。所有命令均基于官方CLI文档（https://docs.openclaw.ai/cli）验证，适用于v2026.3.7+版本。

📋 目录

A.1 安装与初始化
A.2 配置管理（config）
A.3 Gateway与守护进程（daemon）
A.4 状态与诊断
A.5 通道管理（channels）
A.6 模型管理（models）
A.7 Skills管理
A.8 插件管理（plugins）
A.9 日志与会话
A.10 定时任务（cron）
A.11 消息发送（message）
A.12 安全与备份
A.13 重置与卸载
A.14 常用场景组合
A.15 配置文件路径

A.1 安装与初始化

# 全局安装OpenClaw npm install -g openclaw@latest # 首次引导向导（推荐） openclaw onboard # 引导向导（高级模式，完整控制每个步骤） openclaw onboard --advanced # 重新运行引导向导（重置配置+凭据+会话） openclaw onboard --reset # 交互式配置向导（已安装后修改配置） openclaw configure # 查看版本 openclaw --version # 查看帮助 openclaw --help # 查看子命令帮助 openclaw config --help

A.2 配置管理（config）

⚠️openclaw config不带子命令等同于openclaw configure（打开交互式向导）。
config 仅支持get、set、unset、file、validate五个子命令。

# 查看特定配置项 openclaw config get <path> openclaw config get gateway.port openclaw config get agents.defaults.workspace openclaw config get agents.list[0].id # 设置配置项（值自动解析为JSON5，否则视为字符串） openclaw config set <path> <value> openclaw config set gateway.port 19001 --strict-json openclaw config set agents.defaults.heartbeat.every "2h" openclaw config set channels.whatsapp.groups '["*"]' --strict-json # 删除配置项 openclaw config unset <path> openclaw config unset tools.web.search.apiKey # 查看配置文件路径 openclaw config file # 校验配置文件 openclaw config validate

⚠️不存在的命令：config list、config reset、config export、config import、config delete均不是有效子命令。查看全部配置请直接打开配置文件：openclaw config file。重置配置请使用openclaw reset。

A.3 Gateway与守护进程（daemon）

⚠️ Gateway的启停通过daemon命令管理，而非gateway start/stop。

# 安装系统服务（macOS: LaunchAgent / Linux: systemd） openclaw daemon install # 启动守护进程 openclaw daemon start # 停止守护进程 openclaw daemon stop # 重启守护进程（配置变更后执行） openclaw daemon restart # 查看守护进程状态 openclaw daemon status # 卸载系统服务 openclaw daemon uninstall # 查看守护进程日志 openclaw daemon logs # 直接运行Gateway（前台模式，适合调试） openclaw gateway # Gateway运行参数 openclaw gateway --port 18789 --verbose # 查询运行中的Gateway健康状态 openclaw gateway health # 查询Gateway详细状态 openclaw gateway status # 探测Gateway（附加检查） openclaw gateway probe # 发现局域网内的Gateway（Bonjour/mDNS） openclaw gateway discover # 调用Gateway RPC方法 openclaw gateway call <method> # 打开控制面板（Web UI） openclaw dashboard

A.4 状态与诊断

# 查看整体运行状态 openclaw status # 健康检查 openclaw health # 综合诊断与修复建议 openclaw doctor # 自动执行修复 openclaw doctor --yes # 非交互模式诊断 openclaw doctor --non-interactive # 深度扫描（检查系统服务等） openclaw doctor --deep # 启动TUI终端界面 openclaw tui # 搜索官方文档 openclaw docs <关键词>

A.5 通道管理（channels）

# 列出已配置的通道 openclaw channels list # 查看通道状态（含连接健康检查） openclaw channels status # 通道状态（附加探测） openclaw channels status --probe # 添加通道 openclaw channels add <channel> # 移除通道 openclaw channels remove <channel> # 通道登录 openclaw channels login <channel> # 通道登出 openclaw channels logout <channel> # 配对管理（WhatsApp/Telegram DM配对） openclaw pairing list <channel> openclaw pairing approve <channel> <code>

A.6 模型管理（models）

# 列出已配置的模型 openclaw models list # 查看模型状态 openclaw models status # 切换默认模型 openclaw models set <model> openclaw models set anthropic/claude-sonnet-4-5 # 设置图片模型 openclaw models set-image <model> # 添加认证（API Key / OAuth / setup-token） openclaw models auth add # 模型别名管理 openclaw models aliases list openclaw models aliases add <alias> <model> openclaw models aliases remove <alias> # 备用模型管理 openclaw models fallbacks list openclaw models fallbacks add <model> openclaw models fallbacks remove <model> openclaw models fallbacks clear # 图片模型备用 openclaw models image-fallbacks list openclaw models image-fallbacks add <model> openclaw models image-fallbacks remove <model> # 扫描可用模型 openclaw models scan # 认证优先级 openclaw models auth order get openclaw models auth order set <providers...>

A.7 Skills管理

⚠️ Skills的安装/卸载/更新通过clawhubCLI 完成，而非openclaw skills命令。

openclaw skills（查看与检查）

# 列出所有Skills（内置+工作区+托管） openclaw skills list # 仅列出符合条件可加载的Skills openclaw skills list --eligible # 查看Skills详情 openclaw skills info <skill-name> # 检查Skills依赖是否满足 openclaw skills check

clawhub（安装/卸载/更新/搜索）

# 全局安装ClawHub CLI npm install -g clawhub # 搜索Skills clawhub search <关键词> clawhub search browser clawhub search --sort downloads # 安装Skills clawhub install <slug> clawhub install brave-search # 安装到指定目录 clawhub install <slug> --dir /path/to/skills # 查看Skills详情（不安装） clawhub inspect <slug> # 列出已安装Skills clawhub list # 更新单个Skills clawhub update <slug> # 更新所有Skills clawhub update --all # 卸载Skills clawhub uninstall <slug> # 同步Skills clawhub sync

A.8 插件管理（plugins）

# 列出插件 openclaw plugins list # 查看插件详情 openclaw plugins info <id> # 安装插件 openclaw plugins install <id> # 启用插件（需重启Gateway） openclaw plugins enable <id> # 禁用插件 openclaw plugins disable <id> # 插件诊断 openclaw plugins doctor

A.9 日志与会话

# 查看日志 openclaw logs # 实时跟踪日志 openclaw logs --follow # JSON格式日志 openclaw logs --json # 纯文本日志 openclaw logs --plain # 限制日志行数 openclaw logs --limit 100 # 查看会话信息 openclaw sessions

A.10 定时任务（cron）

# 添加一次性定时任务 openclaw cron add \ --name "发送提醒" \ --at "2026-03-15T18:00:00Z" \ --session main \ --system-event "提醒：提交费用报告" # 添加循环定时任务 openclaw cron add \ --name "早间状态" \ --cron "0 7 * * *" \ --tz "Asia/Shanghai" \ --session isolated \ --message "总结今天的收件箱和日历" \ --deliver \ --channel whatsapp # 列出定时任务 openclaw cron list # 删除定时任务 openclaw cron remove <job-id>

A.11 消息发送（message）

# 发送消息 openclaw message send --channel <channel> --target <target> "消息内容" # 发送投票 openclaw message poll --channel discord --target channel:123 \ --poll-question "今晚吃什么？" --poll-option 火锅 --poll-option 烧烤 # 其他消息操作 openclaw message react openclaw message edit openclaw message delete openclaw message pin openclaw message search # 运行单次Agent对话 openclaw agent --message "你好"

A.12 安全与备份

# 安全审计 openclaw security audit # 深度安全审计 openclaw security audit --deep # 创建备份 openclaw backup create # 仅备份配置 openclaw backup create --only-config # 校验备份 openclaw backup verify <backup-id或路径> # 列出备份 openclaw backup list # 恢复备份 openclaw backup restore <文件路径> # 管理密钥 openclaw secrets

A.13 重置与卸载

# 重置（配置+凭据+会话） openclaw reset # 卸载 openclaw uninstall # 全自动卸载 openclaw uninstall --all --yes --non-interactive # 模拟卸载（仅显示结果） openclaw uninstall --dry-run # 软件更新 openclaw update # 查看更新状态 openclaw update status # 更新到指定版本 openclaw update --tag <版本号> # 更新到指定通道 openclaw update --channel stable openclaw update --channel beta

A.14 常用场景组合

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

# 1. 运行引导向导 openclaw onboard # 2. 安装守护进程 openclaw daemon install # 3. 启动 openclaw daemon start # 4. 打开控制面板 openclaw dashboard

场景2：切换模型

# 1. 查看可用模型 openclaw models list # 2. 切换模型 openclaw models set anthropic/claude-sonnet-4-5 # 3. 重启守护进程 openclaw daemon restart

场景3：安装新Skills

# 1. 搜索Skills clawhub search 截图 # 2. 安装Skills clawhub install peekaboo # 3. 确认已安装 openclaw skills list # 4. 重启守护进程 openclaw daemon restart

场景4：故障排查

# 1. 查看运行状态 openclaw status # 2. 综合诊断 openclaw doctor # 3. 查看日志 openclaw logs --follow # 4. Gateway健康检查 openclaw gateway health # 5. 安全审计 openclaw security audit

A.15 配置文件路径

# 查看配置文件路径 openclaw config file # 主配置文件（默认位置） ~/.openclaw/openclaw.json # Skills目录（工作区级） <workspace>/skills/ # Skills目录（全局级） ~/.openclaw/skills/ # 人设文件 ~/clawd/SOUL.md ~/clawd/USER.md ~/clawd/AGENTS.md # 记忆目录 ~/clawd/memory/