以下是针对 Linux(主流发行版,使用 systemd)和 Windows 的详细指南

openclaw openclaw中文博客 2

Linux 系统(使用 systemd)

这是最推荐的方法,适用于 Ubuntu、Debian、CentOS、RHEL 等大多数现代发行版。

以下是针对 Linux(主流发行版,使用 systemd)和 Windows 的详细指南-第1张图片-OpenClaw 中文版 - 真正能做事的 AI

步骤 1:创建 systemd 服务文件

  1. 使用 root 权限创建服务文件:

    sudo nano /etc/systemd/system/openclaw.service

    或者使用 vi 等其他编辑器。

  2. 复制到文件中。请根据您的实际安装路径和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:启用并启动服务

  1. 重新加载 systemd 配置,使其识别新服务:

    sudo systemctl daemon-reload
  2. 启用开机自启:

    sudo systemctl enable openclaw.service
  3. 立即启动服务(无需重启):

    sudo systemctl start openclaw.service
  4. 检查服务状态和日志,确认运行正常:

    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 系统

使用任务计划程序(推荐)

  1. Win + R,输入 taskschd.msc 打开任务计划程序
  2. 在右侧点击 “创建基本任务”
  3. 名称:输入 OpenClaw AutoStart
  4. 触发器:选择 “当计算机启动时”
  5. 操作:选择 “启动程序”
  6. 程序或脚本
    • 如果您安装了 Python 并将脚本关联,可以直接填写 pythonw.exe(无黑框窗口)。
    • 或者填写完整的 Python 路径,如:C:\Users\YourName\AppData\Local\Programs\Python\Python310\pythonw.exe
  7. 添加参数:填写 OpenClaw 主程序的完整路径,如:"C:\Projects\OpenClaw\main.py"
  8. 起始于:填写 OpenClaw 项目所在目录,如:C:\Projects\OpenClaw
  9. 完成向导,在任务列表中找到该任务,可以右键 “运行” 进行测试。

创建快捷方式放入启动文件夹

  1. 为您的启动脚本(一个 .bat 文件或直接指向 python main.py 的快捷方式)创建快捷方式。
  2. Win + R,输入 shell:startup 打开当前用户的启动文件夹。
  3. 将上一步的快捷方式拖入此文件夹即可。

注意:此方法依赖于用户登录,不适合服务器无登录界面自启的场景。


macOS 系统

使用 launchd(类似 systemd)

  1. 创建 plist 文件:

    nano ~/Library/LaunchAgents/com.user.openclaw.plist
  2. (同样,修改路径):

    <?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>
  3. 加载并启动:

    launchctl load ~/Library/LaunchAgents/com.user.openclaw.plist
    launchctl start com.user.openclaw

重要提示

  1. 路径检查:所有示例中的路径(ExecStartWorkingDirectory、Python解释器路径)都必须替换为您系统的实际路径,使用 which python3where python 命令查找Python的确切位置。
  2. 环境依赖:确保OpenClaw所需的环境变量、配置文件等在系统启动时已就绪。systemdEnvironment 指令和 After 依赖项可以很好地管理这些。
  3. 权限:确保服务运行用户(如 User=username)有足够的权限访问OpenClaw文件和相关资源。
  4. 测试:在配置开机自启前,务必先通过命令行手动运行一次,确保程序本身能正常启动和工作。

按照以上步骤操作,您的 AI小龙虾OpenClaw 应该就能在开机后自动稳定运行了,如果遇到问题,请检查对应系统的服务日志以获取详细错误信息。

抱歉,评论功能暂时关闭!