Linux 系统(使用 systemd)
这是最推荐的方法,适用于 Ubuntu、Debian、CentOS、RHEL 等大多数现代发行版。

步骤 1:创建 systemd 服务文件
-
使用 root 权限创建服务文件:
sudo nano /etc/systemd/system/openclaw.service
或者使用
vi等其他编辑器。 -
复制到文件中。请根据您的实际安装路径和Python环境进行修改:
[Unit] Description=AI OpenClaw Service After=network.target # 如果依赖数据库(如MySQL/Redis),可以添加: # After=network.target mysql.service redis.service [Service] Type=simple # !!!重点修改以下路径 !!! # 假设您的OpenClaw主程序位于 /home/username/OpenClaw/main.py # 并且使用虚拟环境 /home/username/venv/openclaw/bin/python ExecStart=/home/username/venv/openclaw/bin/python /home/username/OpenClaw/main.py # 或者如果您是直接安装的python包:ExecStart=python3 /path/to/OpenClaw/main.py # 设置工作目录(通常是项目根目录) WorkingDirectory=/home/username/OpenClaw # 以哪个用户运行(建议使用非root用户) User=username Group=username # 自动重启配置 Restart=on-failure RestartSec=10s # 环境变量(如果需要) Environment="PATH=/home/username/venv/openclaw/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin" # Environment="KEY=value" [Install] WantedBy=multi-user.target
步骤 2:启用并启动服务
-
重新加载 systemd 配置,使其识别新服务:
sudo systemctl daemon-reload
-
启用开机自启:
sudo systemctl enable openclaw.service
-
立即启动服务(无需重启):
sudo systemctl start openclaw.service
-
检查服务状态和日志,确认运行正常:
sudo systemctl status openclaw.service # 查看实时日志 sudo journalctl -u openclaw.service -f
常用管理命令
- 停止服务:
sudo systemctl stop openclaw - 重启服务:
sudo systemctl restart openclaw - 禁用开机自启:
sudo systemctl disable openclaw - 查看日志:
sudo journalctl -u openclaw -n 50
Windows 系统
使用任务计划程序(推荐)
- 按
Win + R,输入taskschd.msc打开任务计划程序。 - 在右侧点击 “创建基本任务”。
- 名称:输入
OpenClaw AutoStart。 - 触发器:选择 “当计算机启动时”。
- 操作:选择 “启动程序”。
- 程序或脚本:
- 如果您安装了 Python 并将脚本关联,可以直接填写
pythonw.exe(无黑框窗口)。 - 或者填写完整的 Python 路径,如:
C:\Users\YourName\AppData\Local\Programs\Python\Python310\pythonw.exe
- 如果您安装了 Python 并将脚本关联,可以直接填写
- 添加参数:填写 OpenClaw 主程序的完整路径,如:
"C:\Projects\OpenClaw\main.py" - 起始于:填写 OpenClaw 项目所在目录,如:
C:\Projects\OpenClaw - 完成向导,在任务列表中找到该任务,可以右键 “运行” 进行测试。
创建快捷方式放入启动文件夹
- 为您的启动脚本(一个
.bat文件或直接指向python main.py的快捷方式)创建快捷方式。 - 按
Win + R,输入shell:startup打开当前用户的启动文件夹。 - 将上一步的快捷方式拖入此文件夹即可。
注意:此方法依赖于用户登录,不适合服务器无登录界面自启的场景。
macOS 系统
使用 launchd(类似 systemd)
-
创建 plist 文件:
nano ~/Library/LaunchAgents/com.user.openclaw.plist
-
(同样,修改路径):
<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <dict> <key>Label</key> <string>com.user.openclaw</string> <key>ProgramArguments</key> <array> <string>/usr/local/bin/python3</string> <string>/Users/username/OpenClaw/main.py</string> </array> <key>WorkingDirectory</key> <string>/Users/username/OpenClaw</string> <key>RunAtLoad</key> <true/> <key>StandardOutPath</key> <string>/tmp/openclaw.stdout</string> <key>StandardErrorPath</key> <string>/tmp/openclaw.stderr</string> </dict> </plist> -
加载并启动:
launchctl load ~/Library/LaunchAgents/com.user.openclaw.plist launchctl start com.user.openclaw
重要提示
- 路径检查:所有示例中的路径(
ExecStart、WorkingDirectory、Python解释器路径)都必须替换为您系统的实际路径,使用which python3或where python命令查找Python的确切位置。 - 环境依赖:确保OpenClaw所需的环境变量、配置文件等在系统启动时已就绪。
systemd的Environment指令和After依赖项可以很好地管理这些。 - 权限:确保服务运行用户(如
User=username)有足够的权限访问OpenClaw文件和相关资源。 - 测试:在配置开机自启前,务必先通过命令行手动运行一次,确保程序本身能正常启动和工作。
按照以上步骤操作,您的 AI小龙虾OpenClaw 应该就能在开机后自动稳定运行了,如果遇到问题,请检查对应系统的服务日志以获取详细错误信息。
版权声明:除非特别标注,否则均为本站原创文章,转载时请以链接形式注明文章出处。