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 skill list	列出已安装技能
openclaw skill install seo-analyzer	安装技能（ClawHub）
openclaw skill install [email protected]	安装特定版本
openclaw skill update seo-analyzer	更新技能
openclaw skill update --all	更新所有技能
openclaw skill uninstall seo-analyzer	卸载技能
openclaw skill info seo-analyzer	查看技能详情
openclaw skill dev ./my-skill	本地开发技能
openclaw skill publish	发布技能

配对与设备

命令	说明
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	只显示错误日志

监控与诊断

命令	说明
openclaw status	查看系统状态
openclaw stats	查看资源使用
openclaw cost today	查看今日成本
openclaw cost month	查看本月成本
openclaw logs --follow	实时日志
openclaw logs --export logs-$(date +%Y%m%d).txt	导出日志
openclaw doctor	诊断常见问题
openclaw reset --confirm	重置（慎用！会清除所有配置）

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 控制台

Docker 管理

命令	说明
docker pull openclaw/openclaw:latest	拉取最新镜像
docker run -d --name openclaw -p 8080:8080 -v $(pwd)/config:/app/config -e ANTHROPIC_API_KEY=$ANTHROPIC_API_KEY openclaw/openclaw:latest	Docker 启动
docker logs openclaw -f	查看容器日志
docker ps | grep openclaw	检查运行状态
docker restart openclaw	重启容器
docker stop openclaw	停止容器

安装与更新

命令	说明
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 config show	查看当前配置
openclaw config set ANTHROPIC_API_KEY "sk-ant-xxx"	设置环境变量
openclaw config reload	重载配置（不需要重启）
openclaw config export > backup-$(date +%Y%m%d).json	备份配置
openclaw config import backup-20260310.json	恢复配置

用量统计

命令	说明
openclaw usage today	查看今日 Token 用量
openclaw usage month	查看本月用量
openclaw usage --by-skill	按技能统计用量
openclaw usage --by-model	按模型统计用量

对话

命令	说明
openclaw chat	在终端中开始对话
openclaw agent --message "你好"	发送单条消息

外部工具后端管理

命令	说明
clawhub install <skill-slug>	安装 ClawHub 上的技能
clawhub update --all	更新所有已安装的技能
clawhub sync --all	同步（扫描 + 发布更新）

常用别名

频繁使用 CLI 的用户可以配置 Shell 别名：

# 添加到 ~/.zshrc 或 ~/.bashrc
alias oc='openclaw'
alias ocg='openclaw gateway'
alias ocs='openclaw status'
alias oca='openclaw agent'

获取帮助

任意命令加 --help 查看详细说明：

openclaw --help
openclaw channels --help
openclaw models --help