openclaw cli进阶指南涵盖六大核心工作流:一、系统初始化与诊断(onboard、status --deep、health);二、gateway管理(启停、端口、守护模式);三、渠道接入监控(list、status --probe、logs);四、模型切换与用量审计(set、set-image、--usage);五、技能控制(install、disable、run);六、自动排障与安全卸载(doctor、uninstall --all)。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您已安装 OpenClaw 并希望高效使用其命令行界面(CLI)完成系统管理、排障、模型切换与渠道控制等任务,则需掌握一组结构清晰、功能明确的终端指令。以下是围绕核心工作流组织的进阶操作指南:
一、系统初始化与状态诊断
该类命令用于首次配置后验证系统完整性,或在服务异常时快速定位基础问题。所有诊断命令均输出结构化结果,支持后续自动化解析。
1、运行 openclaw onboard 启动交互式引导,完成模型提供商选择、API Key 输入及技能模块安装。
2、执行 openclaw status --deep 触发全链路探测,包括 Gateway 连通性、模型响应延迟、渠道心跳状态及本地数据库可写性。
3、输入 openclaw health 获取 Gateway 服务的轻量级存活反馈,响应时间低于 200ms 视为健康。
二、Gateway 网关服务管理
Gateway 是 OpenClaw 的消息中枢,所有聊天请求、Agent 调度与会话持久化均经由此服务。启停与参数调整必须通过 CLI 完成。
1、启动带自定义端口的 Gateway:运行 openclaw gateway --port 18789,服务监听于 127.0.0.1:18789。
2、后台守护模式启动:执行 openclaw gateway --daemon --port 18789,进程将脱离终端并写入 PID 文件至 ~/.openclaw/run/。
3、强制终止当前 Gateway 实例:输入 openclaw gateway stop,该命令会安全关闭 WebSocket 连接并释放端口。
三、多渠道接入与实时监控
Channels 模块负责对接 Telegram、WhatsApp、Discord 等第三方平台,每条渠道独立认证、独立日志、独立健康检查,支持按需启停。
1、列出全部已注册渠道及其状态码:运行 openclaw channels list,输出含 ID、类型、连接状态(online/offline)、最后活跃时间。
2、对指定渠道执行深度探活:执行 openclaw channels status --probe --target telegram_main,返回 HTTP 状态、Webhook 可达性、消息收发往返时延。
多链钱包与交易工具,为 AI 代理提供 27 项功能:钱包管理(创建、查余额、导出密钥),灵活额度代币兑换(100美元、50%、最大),跨链桥,DEX 市场数据(热门、成交量、涨跌榜),分层市值的代币发行,费用管理。支持 Solana 与 EVM 链。适用于代理需要操作钱包、执行交易、调研或发行代币的场景。
3、查看某渠道最近 50 条原始收发日志:输入 openclaw channels logs --target whatsapp_work --limit 50,日志按时间倒序排列,含消息 ID 与错误堆栈(如有)。
四、模型动态切换与用量审计
OpenClaw 支持运行时切换默认模型及图像专用模型,同时提供细粒度用量统计,便于成本管控与性能调优。
1、将默认文本模型设为 claude-3-5-sonnet-20241022:运行 openclaw models set --name claude-3-5-sonnet-20241022。
2、为图像生成任务单独指定 qwen2-vl-7b:执行 openclaw models set-image --name qwen2-vl-7b。
3、查询过去 24 小时各模型 Token 消耗明细:输入 openclaw status --usage --since 24h,输出含输入/输出 Token 数、调用次数、平均延迟。
五、技能(Skills)加载与运行时干预
Skills 是 OpenClaw 的扩展能力单元,每个技能以独立进程或函数形式注册,可通过 CLI 控制其启用、禁用与手动触发。
1、安装浏览器自动化技能:运行 claw install browser,安装包解压至 ~/.openclaw/workspace/skills/browser/ 并自动注册。
2、临时禁用桌面控制技能:执行 claw disable desktop-control,该技能将从当前会话的可用列表中移除,但不卸载文件。
3、手动触发天气技能获取北京实时数据:输入 claw run weather --location 北京,结果以 JSON 格式直接输出至终端。
六、自动排障与安全卸载
当系统出现不可预期行为时,应优先使用内置诊断工具;如需彻底清除环境,必须使用原子化卸载命令避免残留。
1、运行全自动排障流程:执行 openclaw doctor,该命令依次检查 Node.js 版本、~/.openclaw 目录权限、credentials 文件格式、Gateway 端口占用及模型 API Key 可用性。
2、执行无交互式全量卸载:输入 openclaw uninstall --all --yes,删除 Gateway 守护进程、SQLite 数据库、credentials 文件、skills 目录及配置快照。










