---
read_when:
    - 你仍在脚本中使用 `openclaw daemon ...`
    - 你需要服务生命周期命令（install/start/stop/restart/status）
summary: '`openclaw daemon` 的 CLI 参考（Gateway 网关服务管理的旧版别名）'
title: 守护进程
x-i18n:
    generated_at: "2026-05-11T20:25:15Z"
    model: gpt-5.5
    provider: openai
    source_hash: 0131c3838ac0240f38e755eb779134d19a935821d90bb2898648b947696be12e
    source_path: cli/daemon.md
    workflow: 16
---

# `openclaw daemon`

Gateway 网关服务管理命令的旧版别名。

`openclaw daemon ...` 映射到与 `openclaw gateway ...` 服务命令相同的服务控制面。

## 用法

```bash
openclaw daemon status
openclaw daemon install
openclaw daemon start
openclaw daemon stop
openclaw daemon restart
openclaw daemon uninstall
```

## 子命令

- `status`：显示服务安装状态并探测 Gateway 网关健康状态
- `install`：安装服务（`launchd`/`systemd`/`schtasks`）
- `uninstall`：移除服务
- `start`：启动服务
- `stop`：停止服务
- `restart`：重启服务

## 常用选项

- `status`：`--url`、`--token`、`--password`、`--timeout`、`--no-probe`、`--require-rpc`、`--deep`、`--json`
- `install`：`--port`、`--runtime <node|bun>`、`--token`、`--force`、`--json`
- `restart`：`--safe`、`--skip-deferral`、`--force`、`--wait <duration>`、`--json`
- 生命周期（`uninstall|start|stop`）：`--json`

说明：

- `status` 会在可行时解析已配置的探测认证 SecretRefs。
- 如果此命令路径中必需的认证 SecretRef 未解析，且探测连接性/认证失败，`daemon status --json` 会报告 `rpc.authWarning`；请显式传入 `--token`/`--password`，或先解析密钥来源。
- 如果探测成功，会抑制未解析认证引用警告以避免误报。
- `status --deep` 会添加一次尽力而为的系统级服务扫描。当它发现其他类似 Gateway 网关的服务时，人类可读输出会打印清理提示，并警告每台机器一个 Gateway 网关仍然是常规建议。
- `status --deep` 还会以插件感知模式运行配置验证，并暴露已配置的插件清单警告（例如缺少渠道配置元数据），以便安装和更新冒烟检查能够捕获这些问题。默认 `status` 保持快速只读路径，跳过插件验证。
- 在 Linux systemd 安装中，`status` token 漂移检查会同时包含 `Environment=` 和 `EnvironmentFile=` 单元来源。
- 漂移检查会使用合并后的运行时环境解析 `gateway.auth.token` SecretRefs（先使用服务命令环境，再回退到进程环境）。
- 如果 token 认证没有实际启用（显式 `gateway.auth.mode` 为 `password`/`none`/`trusted-proxy`，或者模式未设置且 password 可以胜出、并且没有 token 候选可以胜出），token 漂移检查会跳过配置 token 解析。
- 当 token 认证需要 token 且 `gateway.auth.token` 由 SecretRef 管理时，`install` 会验证该 SecretRef 可解析，但不会将解析后的 token 持久化到服务环境元数据中。
- 如果 token 认证需要 token 且已配置的 token SecretRef 未解析，安装会失败并关闭。
- 如果同时配置了 `gateway.auth.token` 和 `gateway.auth.password`，并且 `gateway.auth.mode` 未设置，安装会被阻止，直到显式设置模式。
- 在 macOS 上，`install` 会保持 LaunchAgent plist 仅限所有者，并通过仅限所有者的文件和包装器加载托管服务环境值，而不是将 API key 或认证配置文件环境引用序列化到 `EnvironmentVariables`。
- 如果你有意在一台主机上运行多个 Gateway 网关，请隔离端口、配置/状态和工作区；参见 [/gateway#multiple-gateways-same-host](/zh-CN/gateway#multiple-gateways-same-host)。
- `restart --safe` 会要求正在运行的 Gateway 网关预检活动工作，并在活动工作排空后调度一次合并后的重启。普通 `restart` 保持现有服务管理器行为；`--force` 仍然是立即覆盖路径。
- `restart --safe --skip-deferral` 会运行 OpenClaw 感知的安全重启，但绕过活动工作延迟门控，因此即使报告了阻塞项，Gateway 网关也会立即发出重启。当卡住的任务运行固定住安全重启时，这是操作员的逃生通道；需要 `--safe`。

## 建议使用

当前文档和示例请使用 [`openclaw gateway`](/zh-CN/cli/gateway)。

## 相关内容

- [CLI 参考](/zh-CN/cli)
- [Gateway 网关运行手册](/zh-CN/gateway)