OpenClawゲートウェイがシャットダウンを拒否すると、すぐにそれを感じることができます。ファンは回転し続け、ポートはバインドされたままで、アプリを「終了」した後もエージェントは自動化を実行し続けます。ゲートウェイはバックグラウンドサービスとして実行されるため、UIを閉じたり、デスクトップセッションからサインアウトしたりしても、プロセスが強制終了されることはほとんどありません。クリーンに停止しないと、インスタンスの重複、マウント不可能なドライブ、または残存するWebhookが発生します。このガイドでは、実際に何が起こっているのか、そしてすべてのオペレーティングシステムでサービスを安全に停止する方法について説明します。
要約
- OpenClawは永続的なサービス(Windowsでは
systemd --user、launchctl、またはOpenClawGateway)としてインストールされるため、UIを終了しても何も起こりません。 - まず公式の方法で停止します(
openclaw gateway stop、openclaw gateway autostart disable)。再起動を続ける場合は、起動エージェントまたはサービス定義を削除してください。 - 実行前と実行後に
systemctl --user status openclaw-gateway、launchctl list ai.openclaw.gateway、またはGet-Service OpenClawGatewayで検証します。 - 停止したら、残存するソケット/ログをクリアし、実際に必要な場合にのみ自動起動を再構築します。
サービスがどのようにインストールされるかを理解する
OpenClawは、初めてopenclaw gateway startを実行したときにバックグラウンドゲートウェイを展開します。インストーラーは以下を配置します:
- Linux: ユーザーレベルの
systemdユニット~/.config/systemd/user/openclaw-gateway.serviceと、ログアウトしても実行されるようにするためのlingering有効化。 - macOS: ゲートウェイを再起動するLaunchAgent plist
~/Library/LaunchAgents/ai.openclaw.gateway.plist。 - Windows:
OpenClawGatewayという名前のサービスコントロールマネージャーエントリと、UIでのみ自動起動を無効にした場合にそれを再有効化するスケジュールされたタスク。 - どのスーパーバイザーがプロセスを所有しているかを知ることで、実際にそれを停止するコマンドがわかります。
強制終了する前のクイックトリアージ
アクティブなセッションの確認: openclaw statusを実行して、実行中のジョブがあるかどうかを確認します。中断するとワークフローが孤立する可能性があります。
正常な停止の試行: openclaw gateway stop --timeout 30。成功が返されたら、完了です。
再起動ロジックの確認: openclaw gateway autostart statusは、ウォッチャーがそれを再起動するかどうかを示します。
ログのキャプチャ: ~/.openclaw/logs/gateway.log(Linux/macOS)またはWindowsイベントログをtailして、修正後に根本原因を確認できるようにします。
Linux: systemdユーザーサービスを停止する
systemctl --user stop openclaw-gateway.service
systemctl --user disable openclaw-gateway.service
systemctl --user daemon-reload
loginctl disable-linger $USER (オプション)ログアウト後の自動起動を防ぐため。
systemctl --user status openclaw-gatewayで確認します — inactive (dead)と表示されるはずです。
不正なプロセスが残っている場合は、pkill -f openclaw-gatewayを実行し、再有効化する前にユニットファイルを削除してください。
macOS: LaunchAgentをアンロードする
launchctl unload ~/Library/LaunchAgents/ai.openclaw.gateway.plist
launchctl remove ai.openclaw.gateway 2>/dev/null
自動起動が不要な場合はplistを削除します: rm ~/Library/LaunchAgents/ai.openclaw.gateway.plist
残りのプロセスを強制終了します: pkill -f openclaw-gateway
ps aux | grep openclawで古いPIDがなくなったことを確認した後にのみ、再起動するかopenclaw gateway startを実行してください。
Windows: SCMエントリとスケジュールされたタスクを停止する
PowerShellを管理者として開き、Stop-Service -Name OpenClawGateway -Forceを実行します
Set-Service -Name OpenClawGateway -StartupType Disabled
再起動させるスケジュールされたタスクを削除します: Unregister-ScheduledTask -TaskName "OpenClaw Autostart" -Confirm:$false
PIDが残存する場合は、Stop-Process -Name openclaw -Forceを実行します
Get-Service OpenClawGatewayで確認します — ステータスはStoppedになるはずです。
Microsoftのドキュメントも参照できます。
サービスが自己再起動を続ける場合
OpenClawのCLIは、更新または認証するたびに自動起動ヘルパーを再構築できます。以下のコマンドを実行して期待値をリセットします:
openclaw gateway autostart disable(CLI管理の再起動機能をオフにします)openclaw gateway doctor(孤立したユニットを報告します)- 古いソケットを削除します(Linux/macOS):
rm -f ~/.openclaw/run/gateway.sock - サービスがすぐに再起動する場合、何か他のもの(例:監視スクリプトやMDMプロファイル)が
openclaw gateway startを呼び出しています。crontab、~/.config/openclaw/autostart.sh、およびエンタープライズ管理ツールを検索してください。
シャットダウンを検証する
上記の手順を実行した後:
- プロセス:
ps、タスクマネージャー、またはアクティビティモニターでopenclawのエントリがゼロであることを確認します。 - ポート:
lsof -i :11434(お使いのOpenClawポートに置き換えてください) は何も返さないはずです。 - ログ: ゲートウェイログの最後の行に
Stopping gateway...が含まれ、それ以降に新しいエントリがないことを確認します。 - リソースモニター: CPUとRAMの使用率がベースラインに戻るはずです。
再発防止
- 24時間365日のカバレッジが本当に必要なマシンでのみ自動起動を有効にします。
- どのユーザーとホストがOpenClawを実行しているかを文書化します。チームが認証情報を共有すると、重複インストールが頻繁に発生します。
- 四半期ごとの監査をスケジュールします:
*openclaw*という名前のすべてのsystemdユーザーユニット、LaunchAgents、およびWindowsサービスをリストアップして、構成のずれを検出します。 - CLIを最新の状態に保ちます。古いビルドでは、スーパーバイザーのバイナリがゲートウェイのバージョンと一致しないため、
stopリクエストが無視されることがあります。
結論
暴走するOpenClawのバックグラウンドサービスは、ほとんどの場合、スーパーバイザーの問題です。OSは、あなたが要求したこと、つまりゲートウェイを存続させることを正確に実行しています。ユニット、plist、またはWindowsサービスを削除し、自動起動フラグを再確認すれば、プロセスは停止したままになります。ゲートウェイを他のデーモンと同様に扱います。クリーンに停止し、ウォッチャーを無効にし、停止したことを確認してから、準備ができたときにのみ再度有効にします。ガイドとしてOpenClawをアンインストールすることもできます。
AI受付を数分で稼働。
眠らないAIでフロントデスクを拡張しましょう。Solveaは複数チャネルの問い合わせに対応し、予約を自動でカレンダーに登録し、24時間機会損失を防ぎます。
よくある質問
OpenClawを停止してもすぐに再起動するのはなぜですか?
自動起動ウォッチャー(systemd lingering、LaunchAgents、またはスケジュールされたタスク)がまだ有効になっているためです。サービスを停止する前にウォッチャーを無効にしてください。
アクティビティモニターやタスクマネージャーからプロセスを強制終了するだけでよいですか?
可能ですが、サービス定義を無効にしない限り、おそらく再起動します。まず、上記OS固有の手順に従ってスーパーバイザーのエントリを削除してください。
LaunchAgentやsystemdユニットを削除しても安全ですか?
はい、後で再インストールまたは再有効化する予定であれば安全です。バックグラウンドモードが再び必要になったら、CLIは openclaw gateway autostart enable で新しいユニットを再生成できます。






