Openclaw常用命令
⚡⚡⚡ 新年新文⚡⚡⚡
文章目录
- 1，核心状态与诊断命令
- 1.1，核心状态解读
- 1.2，命令
- 2，服务管理命令 (Systemd User Mode)
- 3，配置与文件路径速查
- 4，常见运维场景实操
1，核心状态与诊断命令
1.1，核心状态解读
openclaw gateway status[root@tigerhhzz03 bin]# openclaw gateway status🦞 OpenClaw2026.2.3-1(d84eb46)— If it works, it's automation; if it breaks, it's a"learning opportunity."│ ◇ Service: systemd(enabled)File logs: /tmp/openclaw/openclaw-2026-03-02.log Command: /usr/bin/node /usr/lib/node_modules/openclaw/dist/index.js gateway--port18789Service file: ~/.config/systemd/user/openclaw-gateway.service Service env:OPENCLAW_GATEWAY_PORT=18789Config(cli): ~/.openclaw/openclaw.json Config(service): ~/.openclaw/openclaw.json Gateway:bind=lan(0.0.0.0),port=18789(service args)Probe target: ws://127.0.0.1:18789 Dashboard: http://127.0.0.1:18789/ Probe note: Local probe uses loopback(127.0.0.1).bind=lan listens on0.0.0.0(all interfaces);use a LAN IPforremote clients. Runtime: running(pid1090355, state active, sub running, lastexit0, reason0)RPC probe: ok Troubles: run openclaw status Troubleshooting: https://docs.openclaw.ai/troubleshooting- 运行状态：Runtime: running (PID 1090355) —— 服务活着的，正在运行。
- 启动方式：Service: systemd (enabled) —— 它是以 用户级 systemd 服务 (user service) 运行的，而不是系统级 (system)。这就是为什么你之前用 sudo systemctl status openclaw-gateway 找不到的原因（系统级和用户级是隔离的）。
- 监听地址：Gateway: bind=lan (0.0.0.0), port=18789 —— 好消息！ 它监听在 0.0.0.0，意味着不仅本地能访问，局域网内的其他机器也能直接访问，不需要 SSH 隧道了！
- 配置文件位置：~/.openclaw/openclaw.json (即 /root/.openclaw/openclaw.json)。
- 日志文件位置：/tmp/openclaw/openclaw-2026-03-02.log。
1.2，命令
命令用于检查服务是否健康、获取 Token 和排查问题。
| 功能 | 命令 | 说明 |
|---|---|---|
| 查看网关状态 | openclaw gateway status | 最常用。查看运行状态、PID、端口、配置文件路径及 Dashboard 地址。 |
| 查看探针状态 | openclaw probe status | 检查 OpenClaw 是否能成功连接到后端的 AI 模型或工具。 |
| 一键诊断 | openclaw status | 运行全面的自我诊断，报告潜在问题（Troubles）。 |
| 查看版本 | openclaw --version | 查看当前安装的版本号。 |
| 查看帮助 | openclaw --help | 查看所有可用命令列表。 |
| 查看子命令帮助 | openclaw gateway --help | 查看 gateway 子命令的具体用法。 |
2，服务管理命令 (Systemd User Mode)
由于服务文件位于 ~/.config/systemd/user/，不需要 sudo，但必须使用 --user 标志（或者确保当前用户就是运行服务的用户，即 root）。
| 功能 | 命令 | 说明 |
|---|---|---|
| 重启服务 | systemctl --user restart openclaw-gateway | 修改配置后必须执行此命令生效。 |
| 停止服务 | systemctl --user stop openclaw-gateway | 暂时关闭服务。 |
| 启动服务 | systemctl --user start openclaw-gateway | 启动服务。 |
| 查看实时日志 | journalctl --user -u openclaw-gateway -f | 调试神器。 -f 表示跟随输出最新日志，类似 tail -f。 |
| 查看最近日志 | journalctl --user -u openclaw-gateway -n 50 | 查看最近 50 行日志。 |
| 开机自启 | systemctl --user enable openclaw-gateway | 设置开机自动启动（需配合 loginctl enable-linger）。 |
| 取消自启 | systemctl --user disable openclaw-gateway | 取消开机自动启动。 |
| 重载配置 | systemctl --user daemon-reload | 如果修改了 service 文件本身，需运行此命令。 |
关于开机自启 用户级服务 (–user) 默认在用户注销后会停止。如果你希望 root 用户注销 SSH 后服务依然运行，必须执行一次：
bash loginctl enable-linger root
3，配置与文件路径速查
根据你的状态输出，关键文件位置如下，方便你直接编辑：
| 类型 | 路径 | 操作建议 |
|---|---|---|
| 主配置文件 | ~/.openclaw/openclaw.json(即 /root/.openclaw/openclaw.json) | 修改端口、绑定 IP、API Key 等核心参数。修改后需重启服务。 |
| 日志文件 | /tmp/openclaw/openclaw-YYYY-MM-DD.log | 直接 cat 或 tail -f 查看。注意 /tmp 目录重启可能清空，重要日志建议备份。 |
| 服务定义文件 | ~/.config/systemd/user/openclaw-gateway.service | 一般不需要手动修改，除非要改环境变量或启动参数。 |
| 程序源码 | /usr/lib/node_modules/openclaw | Node.js 模块所在目录，一般无需触碰。 |
| 启动命令 | /usr/bin/node … | 实际运行的底层命令。 |
4，常见运维场景实操
场景 A：修改了配置文件，想生效
# 1. 编辑配置vi~/.openclaw/openclaw.json# 2. 重启服务systemctl--userrestart openclaw-gateway# 3. 确认状态openclaw gateway status场景 B：服务起不来，要看报错
# 实时查看报错日志journalctl--user-uopenclaw-gateway-f# 或者查看具体的日志文件tail-f/tmp/openclaw/openclaw-$(date+%Y-%m-%d).log场景 C：忘记 Token 了，要重新获取
# 在日志中搜索 tokengrep"token"/tmp/openclaw/openclaw-$(date+%Y-%m-%d).log# 或者journalctl--user-uopenclaw-gateway|grep"token"场景 D：彻底卸载 (如果需要)
# 1. 停止并禁用服务systemctl--userstop openclaw-gateway systemctl--userdisable openclaw-gateway# 2. 删除 Node 模块npmuninstall-gopenclaw# 或者手动删除rm-rf/usr/lib/node_modules/openclawrm/usr/bin/openclaw# 3. 删除配置和日志rm-rf~/.openclawrm-rf/tmp/openclawrm~/.config/systemd/user/openclaw-gateway.service systemctl--userdaemon-reload感谢阅读，下期更精彩 👋👋👋