OpenClaw CLI 是针对 openclaw 命令行接口的完整操作参考,面向需要在终端中管理 OpenClaw 各项能力的用户。文档按功能域组织,每一节给出可直接复制执行的命令示例。
用途方面,该文档用于管理 OpenClaw 的 gateway(网关)、agents(智能体)、channels(频道)、skills(技能)、hooks(钩子)以及自动化相关任务。典型使用场景是:完成初次安装与配置后,通过 CLI 启动和维护网关服务、注册与路由多个智能体、接入聊天频道、安装和维护技能与钩子、配置模型与认证、发送消息、控制浏览器、操作节点设备、设置定时任务与系统事件、查看日志与执行安全审计。
主要能力按命令域划分如下:
安装与配置:openclaw onboard --install-daemon 进行快速引导并安装守护进程;openclaw setup --workspace 设置工作区与配置;openclaw configure 进入交互式配置;openclaw doctor 执行健康检查。
网关管理:openclaw gateway 以交互模式运行,可通过 --port 指定端口(示例为 18789),或使用 --tailscale serve;网关可作为系统服务安装(openclaw gateway install)并进行 start / stop / restart / status 控制;openclaw status(可加 --deep 探测频道)、openclaw health 用于查看状态与健康。
智能体管理:openclaw agents list(--bindings 显示路由)、openclaw agents add(交互式向导或 --non-interactive 非交互并指定 --workspace、--model)、openclaw agents delete、openclaw agents set-identity(可从 IDENTITY.md 读取,或显式指定 --name、--emoji、--avatar)。
技能与钩子:openclaw skills list(--eligible 仅显示就绪技能、--json 输出 JSON)、openclaw skills info、openclaw skills check;openclaw hooks list(--eligible、--verbose 显示缺失条件)、openclaw hooks info、enable / disable、install(支持 npm 包、本地目录、-l 链接开发模式)、update(指定 id 或 --all)。
频道管理:openclaw channels list / status(--probe 探测)/ add(交互式,或指定 --channel telegram、--account、--name、--token 等)/ remove(--delete)、openclaw channels login --channel whatsapp 登录,以及 openclaw channels logs 查看频道日志。
模型与认证:openclaw models status(--probe 实时检查、--probe-provider 指定提供方)、openclaw models list(--all、--provider)、openclaw models set 与 set-image 设置默认、openclaw models auth setup-token / paste-token 配置认证、openclaw models fallbacks list / add / remove / clear 管理回退模型、openclaw models scan(--set-default)。
消息与其他操作:openclaw message send / poll / read / react / edit / delete,支持指定 --target、--channel、--message 等参数。
浏览器控制:openclaw browser status / start / stop / tabs / open / navigate / click / type / press / screenshot(--full-page)/ snapshot(--format ai),以及 profiles 管理与 create-profile / delete-profile。
节点与设备:openclaw nodes list / status(--connected)/ describe / run / notify(macOS)/ camera(list、snap、clip)/ canvas(snapshot、present、hide)/ screen record。
系统与定时任务:openclaw system event、heartbeat(last / enable / disable)、presence;openclaw cron list(--all)/ status / add(--every 或 --at)/ enable / disable / rm / run / runs。
配置与维护:openclaw config get / set / unset;openclaw memory status / index / search;openclaw logs(--follow、--limit、--json);openclaw sandbox list / recreate;openclaw security audit(--deep、--fix);openclaw plugins list / info / install / enable / disable / doctor;openclaw update;openclaw reset(--scope config、config+creds+sessions、full);openclaw uninstall(--service、--state、--workspace、--all)。
使用方式上,所有命令均可在全局使用 --dev(使用 ~/.openclaw-dev 隔离)、--profile <name>(使用 ~/.openclaw-<name>)、--no-color、--json、-V/--version 等全局参数。文档还提供首次安装、多智能体搭建、钩子自动化、频道接入、模型配置、调试等常见工作流的分步示例。文档提到配置位于 ~/.openclaw/openclaw.json,日志位于 ~/.openclaw/logs/,工作区默认为 ~/.openclaw/workspace。
限制方面,资料未提供各功能的具体前置条件、版本兼容性、各模型或频道的计费情况、性能指标与配额,也未提供 OpenClaw 本身的安装方式与系统要求,这些信息暂未提供。