#!/usr/bin/env bash
# ═══════════════════════════════════════════════════════════
#  OpenClaw CLI 核心命令速查
#  docs.openclaw.ai · 2026
# ═══════════════════════════════════════════════════════════

# ── 网关 · gateway ──────────────────────────────────────────
openclaw gateway status                  # 查看运行状态
openclaw gateway start                   # 启动网关
openclaw gateway stop                    # 停止网关
openclaw gateway restart                 # 重启网关
openclaw gateway install                 # 注册为系统服务
openclaw gateway status --deep           # 深度探测扫描
openclaw gateway status --json           # JSON 输出（脚本用）

# ── 初始化 · setup ──────────────────────────────────────────
openclaw onboard                         # 交互式引导向导
openclaw onboard --install-daemon        # 引导 + 安装服务（首次推荐）
openclaw configure                       # 重新配置模型/通道
openclaw dashboard                       # 打开浏览器控制台
openclaw reset --scope config            # 重置配置（保留凭证）
openclaw reset --scope full              # 完全重置（慎用）

# ── 通道 · channels ─────────────────────────────────────────
openclaw channels list                                        # 列出所有通道
openclaw channels status --probe                              # 探测连接状态
openclaw channels login                                       # WhatsApp 扫码登录
openclaw channels add --channel telegram --token "$TGTOKEN"  # 接入 Telegram
openclaw channels logs --channel telegram                     # 查看通道日志
openclaw channels remove --channel discord                    # 移除通道

# ── 定时任务 · cron ─────────────────────────────────────────
openclaw cron list --all                                      # 查看全部任务
openclaw cron status                                          # 任务状态概览
openclaw cron add --name "brief" --cron "0 9 * * 1-5" --message "发送今日摘要"  # 添加定时任务
openclaw cron run    --id brief                               # 立即触发任务
openclaw cron enable --id brief                               # 启用任务
openclaw cron disable --id brief                              # 暂停任务
openclaw cron runs   --id brief --limit 10                    # 查看运行历史
openclaw cron rm     --id brief                               # 删除任务

# ── 诊断 · doctor & logs ────────────────────────────────────
openclaw doctor                          # 健康检查
openclaw doctor --deep --yes             # 深度检查并自动修复
openclaw logs --follow                   # 实时日志流
openclaw logs --json --limit 200         # JSON 格式日志
openclaw status --all --deep             # 全面系统诊断
openclaw status --usage                  # 查看提供商用量/配额
openclaw health --json --verbose         # 详细健康报告

# ── 模型 · models ───────────────────────────────────────────
openclaw models list                                                      # 列出可用模型
openclaw models status --check                                            # 检查 API Key 状态
openclaw models auth paste-token --provider anthropic                     # 设置 API Key
openclaw models aliases add "claude" "claude-sonnet-4-20250514"           # 添加模型别名
openclaw models fallbacks add "claude-sonnet-4" "gpt-4o"                  # 配置回退模型链
openclaw models scan --set-default --yes                                  # 扫描并更新模型目录

# ── 技能 & 插件 · skills / plugins ─────────────────────────
openclaw skills list                         # 列出所有技能
openclaw skills list --eligible              # 仅显示可用技能
openclaw skills info <name>                  # 查看技能详情
npx clawhub install email                    # 从 ClaWHub 安装技能
openclaw plugins list                        # 列出已安装插件
openclaw plugins install --path ./my-plugin  # 本地安装插件
openclaw plugins doctor                      # 检查插件加载错误

# ── 多 Agent & 配置 · agents / config ──────────────────────
openclaw agents list --bindings              # 列出 Agent 及路由绑定
openclaw agents add <name> --workspace ./ws  # 创建新 Agent
openclaw agents delete <name>                # 删除 Agent
openclaw config get                          # 查看当前配置
openclaw config set <key> <value>            # 修改配置项
openclaw --profile work channels add        # 多配置文件隔离

# ── 全局 Flag（适用于所有命令）─────────────────────────────
#   --json          JSON 格式输出（适合脚本 / CI）
#   --no-color      禁用彩色输出
#   --profile <n>   指定配置文件（多环境隔离）