OpenClaw的运维命令主要可以分为终端CLI命令 （在服务器Shell中执行）和聊天斜杠命令（在Web/飞书/Telegram对话框中输入）两大类。以下按功能分类整理常用命令，方便快速查阅。
一、 基础操作与入门
这些命令帮助你完成初始安装、版本查看和快速上手。
| 命令 | 说明 | 使用场景 |
|---|---|---|
| `curl -fsSL https://openclaw.ai/install.sh | bash` | 一键安装（macOS/Linux） |
openclaw --version 或 -v |
查看当前版本 | 验证安装 |
openclaw --help 或 -h |
查看所有命令帮助 | 忘记命令时 |
openclaw tui |
启动终端交互界面（直接对话） | 无需浏览器，纯命令行环境调试 |
openclaw dashboard |
打开网页控制台 | 浏览器可视化管理 |
二、 生命周期与网关服务控制
这是运维中最核心的部分，负责启动、停止、重启 OpenClaw 的后台服务（Gateway）。
| 命令 | 说明 | 使用场景 |
|---|---|---|
| 初始化与向导 | ||
openclaw onboard |
启动交互式配置向导（模型、渠道等） | 首次配置或重新引导设置 |
openclaw onboard --install-daemon |
初始化并安装系统服务（开机自启） | 生产环境推荐 |
openclaw configure |
重新进入配置向导 | 修改配置 |
| 网关启停与状态 | ||
openclaw gateway start |
启动网关服务 | 日常启动 |
openclaw gateway stop |
停止网关服务 | 维护或升级前 |
openclaw gateway restart |
重启网关服务 | 修改配置后必做 |
openclaw gateway status |
查看网关运行状态（是否active） | 故障排查第一步 |
openclaw gateway start --port 19000 |
指定端口启动 | 避免端口冲突 |
openclaw gateway start --force |
强制启动（杀死占用进程） | 端口被僵尸进程占用时 |
systemctl --user status openclaw-gateway |
通过系统服务查看详细状态 | 查看服务详细日志或PID |
三、 配置管理
主要用于查看和修改 ~/.openclaw/openclaw.json 配置文件。
| 命令 | 说明 | 使用场景 |
|---|---|---|
openclaw config get |
查看完整当前配置 | 检查所有设置 |
openclaw config get models.default |
查看特定配置项（如默认模型） | 精准查询 |
openclaw config set models.default gpt-4 |
设置配置项 | 快速修改 |
openclaw config set providers.deepseek.apiKey "你的密钥" |
配置模型API密钥 | 更换或补充Key |
openclaw config edit |
直接使用编辑器打开配置文件 | 复杂修改 |
openclaw config path |
显示配置文件路径 | 手动备份时 |
四、 诊断、日志与维护
当服务出现异常时，这些命令是你的"急救工具包"。
| 命令 | 说明 | 使用场景 |
|---|---|---|
openclaw doctor |
全面健康检查（配置、端口、依赖） | 出现问题首选命令 |
openclaw doctor --fix |
健康检查并自动尝试修复 | 让系统自愈 |
openclaw logs 或 openclaw gateway logs |
查看实时日志 | 定位具体错误原因 |
journalctl --user -u openclaw-gateway.service -f |
通过 systemd 跟踪日志 | 更底层的日志查看 |
openclaw status |
查看整体运行状态 | 快速确认各模块健康度 |
openclaw update |
更新 CLI 到最新版本 | 版本升级 |
lsof -i :18789 |
查找占用端口的进程 | 解决端口冲突 |
kill -9 <PID> |
强制杀死占用进程 | 清理僵尸进程 |
loginctl enable-linger <用户名> |
开启用户常驻模式（防止SSH退出后进程被回收） | 远程服务器必做 |
五、 模型与技能管理
管理 AI 模型和扩展功能（技能）。
| 命令 | 说明 | 使用场景 |
|---|---|---|
openclaw models list |
列出已配置的模型 | 查看可用模型 |
openclaw models set <模型名> |
切换默认模型 | 更换对话模型 |
openclaw skill list |
查看已安装的技能 | 查看可用工具 |
clawhub install <技能名> |
安装技能 | 扩展能力 |
clawhub list |
查看可安装/已安装的技能 | 技能商店 |
六、 聊天斜杠命令
在与 OpenClaw 的对话框（Web、飞书、Telegram）中输入的指令，用于控制会话本身。
| 命令 | 说明 | 重要度 |
|---|---|---|
| 会话管理 | ||
/new 或 /clear 或 /reset |
新建会话/清空上下文（大幅节省Token） | ⭐⭐⭐⭐⭐ |
/compact |
压缩上下文（保留摘要） | ⭐⭐⭐⭐ |
/status |
查看当前会话状态、模型、Token用量 | ⭐⭐⭐⭐⭐ |
| 模型切换 | ||
/model list |
查看可用模型列表 | 切换前查询 |
/model <模型名> |
切换当前会话模型 | 临时换模型 |
| 权限与执行 | ||
/exec ask=always |
每次执行命令都询问确认 | 安全控制 |
/approve <id> allow-once |
批准一次高危操作 | 授权执行 |
| 工具与帮助 | ||
/help 或 /commands |
查看所有斜杠命令 | 忘记命令时 |
七、 核心文件路径
了解这些路径有助于手动备份和故障排查。
| 路径 | 说明 |
|---|---|
~/.openclaw/openclaw.json |
主配置文件 |
~/.openclaw/workspace/ |
默认工作区（文件操作、下载等） |
~/.openclaw/skills/ |
全局技能目录 |
~/.config/systemd/user/openclaw-gateway.service |
systemd 用户服务文件 |
八、 标准急救流程
当 OpenClaw 表现异常时，建议按以下顺序操作：
openclaw status- 确认网关是否在运行 。openclaw doctor- 进行全面健康检查 。openclaw logs- 查看日志，定位具体错误 。openclaw doctor --fix- 尝试自动修复 。openclaw gateway restart- 重启服务（修改配置或卡死时）。- 检查端口 ：
lsof -i :18789，若被占用则kill -9 <PID>。