CLI 概览
openclaw 是 OpenClaw 平台的命令行界面，用于管理 Agent、渠道、定时任务和系统配置。
安装验证
bash
openclaw --version如果命令未找到，请参阅 安装指南 完成安装。
全局标志
所有命令均支持以下全局标志：
| 标志 | 说明 |
|---|---|
--help, -h | 显示命令帮助信息 |
--version, -v | 显示 CLI 版本号 |
--config <path> | 指定配置文件路径 |
--json | 以 JSON 格式输出，便于程序解析 |
命令分类
Agent 管理
| 命令 | 说明 |
|---|---|
openclaw agent | 管理 Agent 实例（启动、停止、状态） |
openclaw agents | 列出所有已配置的 Agent |
openclaw acp | 打开 Agent 控制面板（Web UI） |
openclaw clawbot | 使用内置助手快速问答 |
渠道操作
| 命令 | 说明 |
|---|---|
openclaw channels | 管理消息渠道（登录、状态、列表） |
openclaw devices | 管理已连接设备 |
openclaw gateway | 控制 API 网关 |
自动化
| 命令 | 说明 |
|---|---|
openclaw cron | 管理定时任务 |
openclaw hooks | 管理事件钩子 |
openclaw approvals | 管理待审批的工具/动作 |
系统与配置
| 命令 | 说明 |
|---|---|
openclaw config | 读写配置项 |
openclaw configure | 交互式配置向导 |
openclaw daemon | 管理后台守护进程 |
openclaw doctor | 运行系统诊断检查 |
openclaw health | 快速健康检查 |
openclaw dashboard | 打开监控仪表盘 |
工具与辅助
| 命令 | 说明 |
|---|---|
openclaw browser | 无头浏览器操作 |
openclaw completion | 生成 Shell 自动补全脚本 |
openclaw directory | 服务发现与目录浏览 |
openclaw dns | DNS 记录与发现管理 |
openclaw docs | 访问文档 |
输出格式
默认情况下，CLI 以人类可读的表格或文本格式输出。添加 --json 标志可获取 JSON 格式输出：
bash
openclaw agents list --jsonjson
{
"agents": [
{ "name": "default", "status": "running", "uptime": "2h30m" }
]
}Shell 补全
使用 openclaw completion 为你的 Shell 安装自动补全，详见 completion 文档。
bash
# Bash
openclaw completion bash >> ~/.bashrc
# Zsh
openclaw completion zsh >> ~/.zshrc