主题
CLI 参考
OpenClaw 提供完整的命令行界面，用于管理网关的所有功能。
常用命令速查
网关控制
| 命令 | 说明 |
|---|---|
openclaw start | 启动网关（前台运行） |
openclaw daemon start | 后台守护进程方式启动 |
openclaw daemon stop | 停止后台进程 |
openclaw daemon restart | 重启后台进程 |
openclaw health | 检查网关运行状态 |
初始化与配置
| 命令 | 说明 |
|---|---|
openclaw setup | 初始化工作区 |
openclaw configure | 交互式配置向导 |
openclaw config | 非交互式配置助手 |
openclaw onboard | 运行入门向导 |
openclaw --version | 查看版本号 |
openclaw update | 检查并安装更新 |
频道管理
| 命令 | 说明 |
|---|---|
openclaw channels list | 列出所有已配置频道 |
openclaw channels login <channel> | 登录频道 |
openclaw channels logout <channel> | 登出频道 |
openclaw channels config <channel> | 查看/编辑频道配置 |
Agent 与工作区
| 命令 | 说明 |
|---|---|
openclaw agent | 执行单次 Agent 轮次 |
openclaw agents | 管理隔离 Agent 实例 |
openclaw skills list | 列出可用技能 |
openclaw skills enable <skill> | 启用指定技能 |
openclaw memory list | 查看记忆索引 |
openclaw memory clear | 清除所有记忆 |
配对与设备
| 命令 | 说明 |
|---|---|
openclaw pairing | DM 安全配对 |
openclaw devices | 管理设备 Token |
openclaw qr | 生成 iOS 配对二维码 |
工具集成
| 命令 | 说明 |
|---|---|
openclaw browser | 管理 Chrome/Chromium 浏览器 |
openclaw cron list | 查看已注册的定时任务 |
openclaw webhooks | 管理 Webhook |
openclaw plugins | 管理第三方插件 |
日志
| 命令 | 说明 |
|---|---|
openclaw logs | 查看实时日志 |
openclaw logs --tail 100 | 查看最近 100 行日志 |
openclaw logs --level error | 只显示错误日志 |
Secrets 管理
| 命令 | 说明 |
|---|---|
openclaw secrets list | 列出已存储的密钥（Key 名称，不含值） |
openclaw secrets set <key> <value> | 存储密钥 |
openclaw secrets delete <key> | 删除密钥 |
AI 模型
| 命令 | 说明 |
|---|---|
openclaw models list | 列出可用模型 |
openclaw models set <model> | 设置默认模型 |
openclaw models test | 测试当前模型连接 |
查询与安全
| 命令 | 说明 |
|---|---|
openclaw docs | 搜索实时文档 |
openclaw doctor | 系统诊断和修复建议 |
openclaw security | 安全审计工具 |
界面
| 命令 | 说明 |
|---|---|
openclaw tui | 打开终端 UI |
openclaw dashboard | 在浏览器中打开 Web 控制台 |
安装与更新
| 命令 | 说明 |
|---|---|
openclaw update | 升级到最新版本 |
openclaw update --channel beta | 切换到 Beta 频道 |
openclaw uninstall | 交互式卸载 |
openclaw uninstall --all --yes | 完全卸载（包括配置和数据） |
配置管理
| 命令 | 说明 |
|---|---|
openclaw config get <key> | 查看配置项 |
openclaw config set <key> <value> | 设置配置项 |
openclaw config unset <key> | 删除配置项 |
openclaw config validate | 验证配置文件格式 |
用量统计
| 命令 | 说明 |
|---|---|
openclaw usage today | 查看今日 Token 用量 |
openclaw usage month | 查看本月用量 |
openclaw usage --by-skill | 按技能统计用量 |
openclaw usage --by-model | 按模型统计用量 |
对话
| 命令 | 说明 |
|---|---|
openclaw chat | 在终端中开始对话 |
openclaw agent --message "你好" | 发送单条消息 |
常用别名
频繁使用 CLI 的用户可以配置 Shell 别名：
bash
# 添加到 ~/.zshrc 或 ~/.bashrc
alias oc='openclaw'
alias ocg='openclaw gateway'
alias ocs='openclaw status'
alias oca='openclaw agent'获取帮助
任意命令加 --help 查看详细说明：
bash
openclaw --help
openclaw channels --help
openclaw models --help