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

⚙️ 配置管理命令

交互式配置向导

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
• 实时查看日志：openclaw-cn logs --follow

🔧 其他有用命令

• 初始安装向导：openclaw-cn onboard
• 打开控制面板：openclaw-cn dashboard
• 检查并安装更新：openclaw-cn update
• 查看所有可用命令：openclaw-cn help

🌐 飞书机器人专用命令

命令	说明
/status	查看机器人状态
/reset	重置对话会话
/model	查看/切换模型

📁 重要文件位置

文件	位置	说明
配置文件	~/.openclaw/openclaw.json	主配置文件
工作区	~/.openclaw/workspace/	工作区文件
日志文件	~/clawdbot/clawdbot-YYYY-MM-DD.log	每日日志
记忆文件	~/.openclaw/workspace/MEMORY.md	长期记忆

🔍 故障排除

问题 1：网关无法启动

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

# 查看错误日志
openclaw-cn logs

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

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

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

问题 3：模型调用失败

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

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

🎯 常用命令速查表

场景	命令
查看状态	openclaw-cn gateway status
重启网关	openclaw-cn gateway restart
查看日志	openclaw-cn logs --follow
添加渠道	openclaw-cn channels add
飞书配对	openclaw-cn pairing list feishu
诊断问题	openclaw-cn doctor
打开面板	openclaw-cn dashboard
终端对话	openclaw-cn tui

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