openclaw安装教程指南实用

安装 OpenClaw 需要准备什么

OpenClaw 是一个基于 Python 的轻量级工具，安装前需要一台 Linux 服务器（CentOS 7+ 或 Ubuntu 20.04+）并拥有 sudo 权限。
确保已安装 Git 和 Python 3.8 以上的版本，如果尚未安装，先执行以下命令：

# Ubuntu/Debian
sudo apt update && sudo apt install git python3 python3-pip -y

# CentOS/RHEL
sudo yum install git python3 python3-pip -y

同时，请确认服务器能正常访问 GitHub，如果网络受限，需要提前配置代理或使用国内镜像。

下载源码并安装依赖

在合适的目录下（例如 /opt 或 /home）克隆 OpenClaw 官方仓库：

cd /opt
sudo git clone https://github.com/openclaw/openclaw.git

进入项目目录：

cd openclaw

OpenClaw 的依赖写在 requirements.txt 中，使用 pip 安装：

sudo pip3 install -r requirements.txt

如果安装速度慢，可以临时切换国内 PyPI 镜像：

sudo pip3 install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

安装完成后，不要关闭终端，继续下一步。

配置并启动服务

OpenClaw 的主配置文件是 config.py，启动前需要根据实际环境修改几项关键参数：

• 监听端口：默认 5000，如果已被占用，改为其他端口（例如 8080）。
• 数据库连接：默认使用 SQLite，路径为 data/app.db，可保持默认。

可以使用任意文本编辑器修改，例如：

nano config.py

找到 PORT = 5000 这行，按需修改后保存。
更安全的方式是创建一个 local_config.py 覆盖默认值，具体可参考项目 README。

启动 OpenClaw：

python3 app.py

如果看到类似 Running on http://0.0.0.0:5000 的输出，说明启动成功。
如需后台运行，可使用 nohup 或 screen：

nohup python3 app.py > /var/log/openclaw.log 2>&1 &

安装中容易踩的坑

1. Python 版本过低：低于 3.8 时部分依赖无法安装，请先升级 Python。可使用 python3 --version 检查。
2. 端口被占用：如果启动报错 Address already in use，换用其他端口，或先关闭占用进程。
3. 依赖安装报错：常见于缺少编译工具（如 gcc、libffi-dev），按提示安装对应开发包即可。
4. 外网无法访问：检查服务器防火墙（iptables/firewalld）和安全组策略，放行对应端口。

如何验证安装成功

• 在本机执行 curl http://127.0.0.1:5000，如果返回 HTML 内容（非空），说明服务正常。
• 在浏览器输入 http://服务器公网IP:端口，看到 OpenClaw 的默认首页即成功。
• 查看日志文件（若使用 nohup）确认无 ERROR 级别报错。

如果你也在折腾 OpenClaw 安装，建议先按本文步骤完整走一遍，遇到异常时优先回看避坑和高频问题部分。