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密钥更换或补充Keyopenclaw 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 askalways每次执行命令都询问确认安全控制/approve id allow-once批准一次高危操作授权执行工具与帮助/help或/commands查看所有斜杠命令忘记命令时七、 核心文件路径了解这些路径有助于手动备份和故障排查。路径说明~/.openclaw/openclaw.json主配置文件~/.openclaw/workspace/默认工作区文件操作、下载等~/.openclaw/skills/全局技能目录~/.config/systemd/user/openclaw-gateway.servicesystemd 用户服务文件八、 标准急救流程当 OpenClaw 表现异常时建议按以下顺序操作openclaw status- 确认网关是否在运行 。openclaw doctor- 进行全面健康检查 。openclaw logs- 查看日志定位具体错误 。openclaw doctor --fix- 尝试自动修复 。openclaw gateway restart- 重启服务修改配置或卡死时。检查端口lsof -i :18789若被占用则kill -9 PID。
OpenClaw的运维命令
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密钥更换或补充Keyopenclaw 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 askalways每次执行命令都询问确认安全控制/approve id allow-once批准一次高危操作授权执行工具与帮助/help或/commands查看所有斜杠命令忘记命令时七、 核心文件路径了解这些路径有助于手动备份和故障排查。路径说明~/.openclaw/openclaw.json主配置文件~/.openclaw/workspace/默认工作区文件操作、下载等~/.openclaw/skills/全局技能目录~/.config/systemd/user/openclaw-gateway.servicesystemd 用户服务文件八、 标准急救流程当 OpenClaw 表现异常时建议按以下顺序操作openclaw status- 确认网关是否在运行 。openclaw doctor- 进行全面健康检查 。openclaw logs- 查看日志定位具体错误 。openclaw doctor --fix- 尝试自动修复 。openclaw gateway restart- 重启服务修改配置或卡死时。检查端口lsof -i :18789若被占用则kill -9 PID。
