OpenClaw CLI 是 OpenClaw 框架的官方命令行工具，它以UNIX 哲学为核心，提供对 AI 代理系统的全生命周期管理 —— 从服务启停、配置管理，到技能部署、会话交互，所有操作都在终端完成，让你完全掌控本地 AI 生态，数据不离开服务器，隐私与安全尽在掌握。
一、快速安装与初始化
1. 安装 CLI
通过 npm 全局安装 OpenClaw CLI：
bash
运行
npm install -g openclaw-cli
# 验证安装
openclaw --version
2. 首次配置（新手必做）
运行引导式配置，完成 Gateway、模型 API、聊天通道的初始化：
bash
运行
# 全功能引导配置（推荐）
openclaw onboard
# 或快速配置核心参数
openclaw configure
二、核心命令体系（附实战示例）
OpenClaw CLI 采用层级化命令结构，主命令下分 gateway、config、agent、channels、skills 等子命令，清晰易用。
1. 系统状态与诊断
查看系统概览
bash
运行
# 快速查看 Gateway 状态、活跃通道、模型信息
openclaw status
# 深度健康检查（验证 API 连接、配置有效性）
openclaw status --deep
系统诊断（Doctor 工具）
自动检测配置、依赖、网络问题，快速定位故障：
bash
运行
# 运行完整诊断
openclaw doctor
# 输出示例：
# ✓ Node.js version: v22.22.0 (supported)
# ✓ OpenClaw CLI: 2026.2.26
# ✓ Gateway: running
# ✓ Model API: connected
# ✗ Telegram channel: token invalid
2. Gateway 网关管理（核心服务）
Gateway 是 OpenClaw 的通信中枢，负责代理与外部通道、模型的交互。
bash
运行
# 启动 Gateway（前台运行，适合调试）
openclaw gateway start
# 后台启动（生产环境）
openclaw gateway start --daemon
# 停止/重启 Gateway
openclaw gateway stop
openclaw gateway restart
# 查看 Gateway 健康状态
openclaw gateway health
# 指定端口启动
openclaw gateway start --port 8080
3. 配置管理（Config）
支持点号路径访问嵌套配置，无需手动编辑配置文件：
bash
运行
# 查看当前配置
openclaw config get
# 查看指定配置项（如模型 API 密钥）
openclaw config get models.openai.api_key
# 修改配置（设置工具权限为完整模式）
openclaw config set tools.profile full
# 重置配置
openclaw config reset
4. AI 代理交互（Agent）
单轮消息交互
直接在终端向 AI 发送指令并获取回复：
bash
运行
# 发送单轮消息
openclaw agent --message "帮我创建一个 hello.txt 文件，写入 'Hello from OpenClaw'"
# 向指定通道发送消息
openclaw agent --to telegram --message "今日任务：完成文档整理"
交互式会话
进入持续对话模式，支持多轮交互：
bash
运行
# 启动交互式 Agent 会话
openclaw agent
# 进入后直接输入指令：
> 用 Python 写一个猜数字小游戏，保存为 game.py 并运行
5. 聊天通道管理（Channels）
集成 Telegram、Discord、Slack 等外部通道，让 AI 代理跨平台交互。
bash
运行
# 列出已配置通道
openclaw channels list
# 检查通道连接状态
openclaw channels status
# 深度探测通道健康度
openclaw channels status --probe
# 添加 Telegram 通道（非交互式）
openclaw channels add --channel telegram --token $TELEGRAM_BOT_TOKEN
# 登录 WhatsApp 通道（扫码）
openclaw channels login --channel whatsapp
# 查看通道日志
openclaw channels logs --channel telegram --lines 200
6. 技能管理（Skills）
Skills 是 OpenClaw 的核心扩展能力，让 AI 代理具备文件操作、代码执行、设备控制等功能。
bash
运行
# 列出已安装技能
openclaw skills list
# 查看技能详情
openclaw skills info file-manager
# 安装新技能（从本地路径或 npm 源）
openclaw skills install ./my-skill.tgz
# 启用/禁用技能
openclaw skills enable file-manager
openclaw skills disable screen-recorder
# 检查技能运行状态
openclaw skills check
7. 会话与历史（Sessions）
管理 AI 代理的对话会话，回溯历史记录。
bash
运行
# 列出所有会话
openclaw sessions list
# 查看指定会话详情
openclaw sessions info <session-id>
# 删除会话
openclaw sessions delete <session-id>
8. 定时任务（Cron）
自动化执行周期性任务，如每日总结、健康检查。
bash
运行
# 列出定时任务
openclaw cron list
# 添加每日总结任务
openclaw cron add --name "daily-summary" --every 24h \
--system-event "生成今日工作日报并发送到 Telegram"
# 手动触发任务
openclaw cron run <job-id> --force
# 查看任务运行记录
openclaw cron runs --id <job-id> --limit 5
三、实战场景：用 OpenClaw CLI 打造个人 AI 助手
场景 1：文件管理助手
让 AI 代理自动整理下载文件夹：
bash
运行
# 启用文件管理技能
openclaw skills enable file-manager
# 发送指令
openclaw agent --message "将 ~/Downloads 文件夹中所有 .pdf 文件移动到 ~/Documents/PDF 目录"
场景 2：跨平台消息通知
配置 Telegram 通道，让系统状态自动推送：
bash
运行
# 添加 Telegram 通道
openclaw channels add --channel telegram --token $BOT_TOKEN
# 创建定时任务，每日推送系统状态
openclaw cron add --name "daily-status" --every 24h \
--message "发送 OpenClaw 系统状态到 Telegram"
场景 3：代码开发辅助
让 AI 代理直接生成并运行代码：
bash
运行
# 切换到完整工具模式（允许执行命令）
openclaw config set tools.profile full
openclaw gateway restart
# 发送代码指令
openclaw agent --message "写一个 Python 脚本，统计当前目录下所有 .md 文件的行数，并保存为 count.md"
四、进阶技巧
- 命令组合：通过管道符组合命令，实现复杂操作bash运行
# 查看 Gateway 日志并过滤错误信息 openclaw gateway logs | grep ERROR - 脚本自动化：将常用命令写入 Shell 脚本，一键执行bash运行
# startup.sh #!/bin/bash openclaw gateway start --daemon openclaw skills enable file-manager code-executor openclaw channels status - 环境变量配置：通过环境变量传递敏感信息，避免明文泄露bash运行
export OPENCLAW_MODEL_API_KEY=sk-xxx openclaw model test
五、总结
OpenClaw CLI 打破了 AI 代理依赖图形界面的限制，让开发者、运维人员通过终端即可完成从部署到运维的全流程操作。它的轻量、高效、安全特性，让本地 AI 生态管理变得简单可控。无论是个人助手搭建，还是企业级 AI 代理部署，OpenClaw CLI 都是不可或缺的核心工具。
OpenClaw CLI 极速速查表（可直接复制使用）
一、基础命令
bash
运行
# 查看版本
openclaw --version
# 首次初始化配置
openclaw onboard
# 系统状态概览
openclaw status
# 深度诊断问题
openclaw doctor
二、网关（Gateway）核心管理
bash
运行
# 前台启动（调试用）
openclaw gateway start
# 后台守护启动（生产用）
openclaw gateway start --daemon
# 停止网关
openclaw gateway stop
# 重启网关
openclaw gateway restart
# 指定端口启动
openclaw gateway start --port 8080
# 查看网关健康状态
openclaw gateway health
三、配置管理
bash
运行
# 查看全部配置
openclaw config get
# 查看指定配置
openclaw config get models.openai.api_key
# 修改配置
openclaw config set tools.profile full
# 重置配置
openclaw config reset
四、AI 代理交互（最常用）
bash
运行
# 单轮指令（直接执行）
openclaw agent --message "帮我创建一个 test.txt 文件"
# 进入交互式多轮对话
openclaw agent
# 发送消息到指定通道
openclaw agent --to telegram --message "服务器状态正常"
五、通道管理（Telegram/WhatsApp 等）
bash
运行
# 列出所有通道
openclaw channels list
# 查看通道状态
openclaw channels status
# 添加 Telegram 通道
openclaw channels add --channel telegram --token 你的机器人令牌
# 扫码登录 WhatsApp
openclaw channels login --channel whatsapp
# 查看通道日志
openclaw channels logs --channel telegram --lines 100
六、技能管理（文件 / 代码 / 自动化）
bash
运行
# 列出所有技能
openclaw skills list
# 启用技能
openclaw skills enable file-manager
# 禁用技能
openclaw skills disable screen-recorder
# 查看技能详情
openclaw skills info file-manager
七、会话与历史记录
bash
运行
# 查看所有会话
openclaw sessions list
# 查看会话详情
openclaw sessions info 会话ID
# 删除会话
openclaw sessions delete 会话ID
八、定时任务（自动化）
bash
运行
# 列出定时任务
openclaw cron list
# 创建每日任务
openclaw cron add --name "daily-report" --every 24h --message "生成今日总结"
# 手动运行任务
openclaw cron run 任务ID
九、实战一键脚本（直接复制运行）
bash
运行
# 1. 启动服务 + 开启文件管理技能
openclaw gateway start --daemon
openclaw skills enable file-manager
openclaw status
# 2. 让 AI 整理下载文件夹
openclaw agent --message "把 ~/Downloads 里所有 PDF 移动到 ~/Documents/PDF"
# 3. 让 AI 生成并运行 Python 代码
openclaw agent --message "写一个 Python 脚本输出当前时间，保存为 time.py"正文完
可以使用微信扫码关注公众号（ID：xzluomor）
