若重启电脑后需手动启动 openclaw gateway 服务，说明开机自启未配置成功；文章提供了 macos（launchd）、windows（任务计划程序/windows 服务）和 linux（systemd 用户服务）四套完整配置方案。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已部署 OpenClaw AI 工具，但每次重启电脑后需手动启动 gateway 服务，则说明开机自启尚未配置成功。以下是针对不同操作系统的多种可靠配置方法：
一、macOS 使用 launchd 配置开机自启
macOS 推荐使用 launchd 管理系统级后台服务，它支持自动拉起、崩溃重启和环境变量继承，比 crontab 更稳定可靠。关键在于正确配置 .plist 文件并确保权限与路径无误。
1、打开终端，执行命令检查当前 gateway 状态：openclaw gateway status
2、若显示未安装或未加载，先执行安装：openclaw gateway install
3、创建并编辑 launchd 配置文件：nano ~/Library/LaunchAgents/com.openclaw.gateway.plist
4、粘贴以下内容（注意替换 /path/to/your/node 为实际 Node.js 路径，可通过 which node 获取）：
5、保存后加载服务：launchctl load ~/Library/LaunchAgents/com.openclaw.gateway.plist
6、验证是否生效：launchctl list | grep openclaw，应返回非空结果
二、Windows 使用任务计划程序配置开机自启
Windows 系统不支持类 Unix 的守护进程机制，但可通过任务计划程序在用户登录时自动启动 gateway，兼顾稳定性与权限可控性。该方式无需管理员权限即可运行，且能捕获标准输出日志。
1、以普通用户身份打开“任务计划程序”（可在开始菜单搜索）
2、点击右侧“创建基本任务”，命名为：OpenClaw Gateway AutoStart
3、触发器选择“当用户登录时”
4、操作选择“启动程序”，程序/脚本栏填写：powershell.exe
5、添加参数栏输入：-ExecutionPolicy Bypass -Command "start-process 'openclaw' -ArgumentList 'gateway','start','--port','18888' -WindowStyle Hidden"
6、勾选“不管用户是否登录都要运行”，并启用“只在使用电源时运行”（避免笔记本电池耗尽）
OpenClaw专家 — 用于任何OpenClaw问题或需求，包括配置错误、网关崩溃、网关未启动、斜杠指令、频道路由等。
7、完成设置后，右键新任务 → “运行”，观察任务管理器中是否有 node.exe 或 Gateway.exe 进程启动
三、Windows 使用 Windows 服务（sc 命令）配置系统级自启
此方法将 OpenClaw gateway 注册为 Windows 系统服务，实现真正意义上的开机即启（早于用户登录），适合长期无人值守的桌面服务器场景。需以管理员权限运行，且必须确保 gateway 可在无交互环境下静默启动。
1、以管理员身份打开 PowerShell
2、执行命令注册服务（请先确认 openclaw 命令全局可用，否则需使用完整路径）：sc create OpenClawGateway binPath= "C:\Windows\System32\cmd.exe /c start /min powershell -ExecutionPolicy Bypass -Command \"openclaw gateway start --port 18888\"" start= auto obj= "LocalSystem"
3、设置服务失败响应（防止意外退出）：sc failure OpenClawGateway actions= restart/60000/restart/60000/restart/60000 reset= 86400
4、启动服务：sc start OpenClawGateway
5、检查状态：sc query OpenClawGateway，State 应显示 RUNNING
6、验证日志：服务默认输出至 Windows 事件查看器 → Windows 日志 → 应用程序，筛选来源为 Service Control Manager
四、Linux 使用 systemd 配置用户级自启
Linux 桌面环境（如 Ubuntu、CentOS）推荐使用 systemd user session 管理 gateway，避免 root 权限依赖，同时支持自动重启与日志轮转。配置文件需置于用户目录下，并启用 linger 机制确保登录前启动。
1、创建服务文件：mkdir -p ~/.config/systemd/user
2、执行：nano ~/.config/systemd/user/openclaw-gateway.service
3、填入以下内容（替换 /home/username 为实际家目录路径）：
[Unit]
Description=OpenClaw Gateway Service
After=network.target
[Service]
Type=simple
User=username
WorkingDirectory=/home/username
Environment="PATH=/home/username/.nvm/versions/node/v22.1.0/bin:/usr/local/bin:/usr/bin:/bin"
ExecStart=/home/username/.nvm/versions/node/v22.1.0/bin/node -e "require('child_process').execSync('openclaw gateway start --port 18888', {stdio: 'ignore'})"
Restart=always
RestartSec=10
StandardOutput=append:/home/username/logs/openclaw-gateway.log
StandardError=append:/home/username/logs/openclaw-gateway.err
[Install]
WantedBy=default.target
4、启用 linger（确保用户 session 在登录前启动）：sudo loginctl enable-linger username
5、重载配置并启用服务：systemctl --user daemon-reload && systemctl --user enable openclaw-gateway.service && systemctl --user start openclaw-gateway.service
6、查看运行状态：systemctl --user status openclaw-gateway.service
