🦞 OpenClaw 常用命令大全

本文是 openclaw-cn（中文社区版）和 openclaw（官方版）CLI 的常用命令速查表。两者命令结构完全一致，仅二进制名不同。以下示例统一使用 openclaw-cn。如果你使用官方版，将 openclaw-cn 替换为 openclaw 即可。快速上手指南 – 收藏这篇就够了！

什么是 OpenClaw？

OpenClaw 是一个本地运行的 AI 助手框架，可以让你通过飞书、Telegram、微信等渠道与 AI 对话，同时支持丰富的自动化功能。

🚀 网关管理命令

这些命令用于控制 OpenClaw 网关服务的运行状态。

查看网关状态

openclaw-cn gateway status

输出示例：

Service: Scheduled Task (registered)
Gateway: bind=loopback (127.0.0.1), port=18789
RPC 探测：正常
Listening: 127.0.0.1:18789

启动网关

openclaw-cn gateway start

停止网关

openclaw-cn gateway stop

重启网关

openclaw-cn gateway restart

💡 提示：配置更改后需要重启网关才能生效

安装网关服务（开机自启）

openclaw-cn gateway install

终端界面模式（TUI）

openclaw-cn tui

启动终端用户界面，直接在命令行中与 AI 对话。

常用参数：

# 指定会话
openclaw-cn tui --session main

# 发送初始消息
openclaw-cn tui --message "你好"

# 启用回复交付
openclaw-cn tui --deliver

# 指定网关 URL
openclaw-cn tui --url ws://127.0.0.1:18789

💡 提示：TUI 模式适合在服务器或无图形界面环境中使用

⚙️ 配置管理命令

交互式配置向导

openclaw-cn config

首次安装或重新配置时使用。

添加新渠道

openclaw-cn channels add

支持添加飞书、Telegram、WhatsApp 等渠道。

查看配置列表

openclaw-cn config list

🔐 配对管理（飞书专用）

当陌生用户首次与飞书机器人对话时，需要配对授权。

查看待批准的配对请求

openclaw-cn pairing list feishu

批准配对请求

openclaw-cn pairing approve feishu <配对码>

拒绝配对请求

openclaw-cn pairing reject feishu <配对码>

📊 状态查询命令

查看整体状态

openclaw-cn status

运行诊断检查

openclaw-cn doctor

非交互式诊断

openclaw-cn doctor --non-interactive

查看技能状态

openclaw-cn skills status

查看会话使用情况

openclaw-cn sessions usage

📋 日志查看命令

查看日志

openclaw-cn logs

实时查看日志（类似 tail -f）

openclaw-cn logs --follow

💡 提示：调试问题时非常有用，可以看到实时请求和响应

查看特定日期的日志

日志文件位置：\tmp\clawdbot\clawdbot-YYYY-MM-DD.log

🔧 其他有用命令

初始安装向导

openclaw-cn onboard

首次使用时运行，引导完成安装和配置。

打开控制面板

openclaw-cn dashboard

在浏览器中打开 Web 控制面板（默认 http://127.0.0.1:18789/）

检查并安装更新

openclaw-cn update

查看所有可用命令

openclaw-cn help

查看特定命令的帮助

openclaw-cn gateway --help

🌐 飞书机器人专用命令

在飞书中与机器人对话时，可以发送以下命令：

⚠️ 注意：飞书目前不支持原生命令菜单，命令需要以文本形式发送。

💡 快捷技巧

1. 快速重启网关

配置更改后，快速重启：

openclaw-cn gateway restart

2. 查看实时日志（调试用）

打开两个终端窗口：

# 窗口 1：实时日志
openclaw-cn logs --follow

# 窗口 2：执行操作
openclaw-cn gateway restart

3. 检查飞书连接状态

openclaw-cn logs --follow | grep feishu

4. 查看模型使用情况

openclaw-cn sessions usage

📁 重要文件位置

🔍 故障排除

问题 1：网关无法启动

# 检查端口是否被占用
netstat -ano | findstr :18789

# 查看错误日志
openclaw-cn logs

问题 2：飞书机器人不响应

# 检查网关状态
openclaw-cn gateway status

# 查看飞书相关日志
openclaw-cn logs --follow | grep feishu

# 检查配对状态
openclaw-cn pairing list feishu

问题 3：模型调用失败

# 检查 API 密钥配置
openclaw-cn config list

# 查看模型使用情况
openclaw-cn sessions usage

🎯 常用命令速查表

本文内容及配图均由OpenClaw完成，站长只负责复制粘贴！！！