在 app.py 或 main.py 中

openclaw openclaw解答 2026-04-09 3

下面我将详细说明OpenClaw系统常见的端口配置与使用方法。

在 app.py 或 main.py 中-第1张图片-OpenClaw下载官网 - OpenClaw电脑版 | ai小龙虾

核心架构与端口概览

一个典型的OpenClaw系统可能包含以下服务,每个服务都会占用一个或多个端口：

AI视觉服务：运行目标检测模型（如YOLO），提供REST API或gRPC服务，常用端口：5000， 8000， 9000-9010。
Web控制面板：用于手动控制、参数设置和状态监控，常用端口：80， 8080， 8000。
视频流服务：将摄像头的实时画面通过RTSP、HTTP-FLV、MJPEG或WebRTC推送出去，常用端口：1935， 8081， 8888。
机械臂控制服务：与下位机（如Arduino、树莓派、机械臂控制器）通信，可能通过串口（虚拟COM）或Socket，网络通信端口可能自定义，如 54321。
消息中间件/通信总线：用于模块间通信，如ROS的 11311，或MQTT的 1883。

详细配置与使用步骤

第一步：确定软件栈与配置文件

你需要知道你的OpenClaw项目使用的是哪个具体的代码库或框架,常见的包括：

自定义Python项目：查找 config.ini， config.yaml， settings.py， app.py 或 main.py 中的端口定义。
Docker部署：查看 docker-compose.yml 或 Dockerfile 中的端口映射（ports: 部分）。
ROS (Robot Operating System)：查看launch文件（.launch）和各节点的参数服务器。

第二步：修改端口配置

找到对应的配置文件后，根据需要进行修改,以下是几个示例：

修改Web服务端口 (Python Flask/FastAPI示例)

import uvicorn
app = FastAPI()
if __name__ == "__main__":
    # 将端口从默认的8000改为自定义的8090
    uvicorn.run(app, host="0.0.0.0", port=8090)

或者在启动时通过命令行参数指定：

python app.py --port 8090

修改视频流端口 (使用RTSP服务器) 如果使用 rtsp-simple-server 或类似软件，修改其配置文件 rtsp-simple-server.yml：

rtspPort: 8554        # RTSP默认端口
httpPort: 8888        # HTTP监控和API端口

Docker Compose 端口映射 在 docker-compose.yml 中，ports 指令将容器内部端口映射到宿主机端口。

services:
  ai-server:
    image: openclaw-ai:latest
    ports:
      - "5000:5000"  # 宿主机端口:容器端口
      - "8080:8080"
  web-ui:
    image: openclaw-web:latest
    ports:
      - "80:80"

要修改端口，直接更改冒号左边的宿主机端口号即可，将Web UI改为通过 8081 访问：- "8081:80"。

第三步：配置硬件通信端口

串口 (USB): 在配置中指定设备路径，在Linux下可能是 /dev/ttyUSB0 或 /dev/ttyACM0；在Windows下是 COM3、COM4等，确保运行程序的用户有读写权限（在Linux下可能需要将用户加入 dialout 组）。
网络Socket: 如果机械臂控制器本身是一个网络设备（如带以太网口的舵机控制器），需在配置中设置其IP地址和端口，并确保宿主机网络（或Docker网络）能与其连通。

第四步：防火墙与安全设置

修改端口后,必须更新防火墙规则以允许流量通过。

Linux (UFW):

sudo ufw allow 8090/tcp
sudo ufw allow 8888/tcp
sudo ufw reload

Windows防火墙: 通过“高级安全Windows防火墙”添加入站规则。
路由器/云服务器安全组: 如果要从外网访问，需要在路由器设置端口转发，或在云服务器控制台配置安全组/防火墙规则,将公网IP的特定端口转发到运行OpenClaw的内网机器的IP和端口上。

典型访问方式

配置完成后,你可以在浏览器或代码中访问这些服务：

Web控制界面: http://<你的设备IP>:<Web端口>，http://192.168.1.100:8080
AI API接口: http://<你的设备IP>:<API端口>/docs (如果使用FastAPI) 或调用 http://<你的设备IP>:<API端口>/predict 等端点。
视频流:
- MJPEG: http://<你的设备IP>:<视频端口>/stream
- RTSP: rtsp://<你的设备IP>:<RTSP端口>/<流名称> (用VLC播放)
远程SSH/调试: ssh -p <SSH端口> user@<你的设备IP> (SSH默认22端口)。

故障排查

端口冲突: 使用 netstat -tulpn | grep <端口号> (Linux) 或 Get-NetTCPConnection -LocalPort <端口号> (PowerShell) 检查端口是否被其他程序占用。
服务未启动: 检查服务日志,确认服务已成功监听在指定端口。
防火墙阻挡: 临时关闭防火墙测试是否是防火墙问题。
Docker网络问题: 确保容器内服务监听在 0.0.0，而非 0.0.1,检查Docker网络模式。
无法外网访问: 确认路由器端口转发规则正确，且你的公网IP是真实的（很多家用宽带是内网IP）。