openclaw如何如何命令行配置不要自动启动,命令是什么
核心方案:通过安装命令中的参数避免自启动,或用特定命令移除已配置的自启动。
OpenClaw 的自启动本质上是安装了一个系统服务 (macOS 为 LaunchAgent,Linux 为 systemd user service)。"不要自动启动"即不安装/不启用这个服务;"手动启动"即直接用 openclaw gateway start 命令前台运行。
根据你的操作系统和当前状态,分两种情况操作:
🔵 情况 A:全新安装,希望不要自动启动
在运行安装向导时,绝对不要使用 --install-daemon 参数。
-
错误命令(会安装自启动服务) :
bashopenclaw onboard --install-daemon -
正确命令(仅配置,不安装自启) :
bashopenclaw onboard直接运行
openclaw onboard仅进行配置,不会在后台注册开机自启服务。
🔵 情况 B:已安装,希望移除现有自启动
根据系统不同,执行对应的禁用和卸载命令。
1. macOS(移除 LaunchAgent)
bash
# 1. 停止当前运行的服务
launchctl unload ~/Library/LaunchAgents/com.openclaw.board.plist
# 2. 删除自启动配置文件(防止下次开机启动)
rm ~/Library/LaunchAgents/com.openclaw.board.plist
说明:如果文件名不是 com.openclaw.board,请根据实际安装时的 plist 名称调整 。
2. Linux(移除 systemd 用户服务)
bash
# 1. 禁用开机自启(停止开机自动运行)
systemctl --user disable openclaw-gateway
# 2. 停止当前服务
systemctl --user stop openclaw-gateway
对应的自启动配置文件位于 ~/.config/systemd/user/openclaw-gateway.service 。
🟢 如何手动启动/停止/查看状态(移除自启后)
移除自启动后,OpenClaw 完全由你手动控制。所有操作均通过 openclaw gateway 子命令完成:
| 操作 | 命令 | 说明 |
|---|---|---|
| 手动启动 | openclaw gateway start |
这是你需要的核心命令。启动服务(前台或后台取决于版本,通常为后台驻留)。 |
| 停止运行 | openclaw gateway stop |
完全停止进程 。 |
| 重启服务 | openclaw gateway restart |
修改配置后常用 。 |
| 查看状态 | openclaw gateway status |
确认当前是否在运行 。 |
| 查看日志 | openclaw gateway logs |
或 Linux 下使用 journalctl --user -u openclaw-gateway.service -f 。 |
⚠️ 补充说明
- 若启动守护进程时提示权限弹窗 :这是 macOS 的完全磁盘访问权限要求,需在系统设置中授予终端或
imsg权限,这是正常的安全机制 。 - 无需卸载重装:即使安装时选了自启动,直接按"情况 B"删除 plist 或 disable 服务即可,无需重装整个软件。
如果你现在执行 openclaw gateway status 提示正在运行,可以先 stop 再按上述方法移除自启配置。