WSL2 环境下 AI 助手调用摄像头方案实践

实际测试确认摄像头硬件正常，能拍到清晰画面，但无法满足自动化集成需求。

第三阶段：Python + OpenCV 本地程序（成功）

采用 Python 结合 OpenCV 库编写本地脚本，绕过 WSL2 直接调用 Windows 原生摄像头接口。

1. 安装依赖

pip install opencv-python

OpenCV 是成熟的计算机视觉库，支持摄像头访问、图像处理等功能。

2. 创建摄像头脚本

版本 1：实时预览版 (webcam.py)

#!/usr/bin/env python3
""" 本地摄像头测试工具 - 复刻 webcamtests.com 核心功能
功能：实时预览、拍照、录像、摄像头信息
"""
import cv2
import os
from datetime import datetime

class WebcamTest:
    def __init__(self, camera_id=0):
        self.camera_id = camera_id
        self.cap = None
        self.save_dir = os.path.expanduser("~/Pictures/WebcamTest")
        os.makedirs(self.save_dir, exist_ok=True)

    def open_camera(self):
        """打开摄像头"""
        self.cap = cv2.VideoCapture(self.camera_id)
        if not self.cap.isOpened():
            print(f"❌ 无法打开摄像头 (ID: {self.camera_id})")
            return False
        width = int(self.cap.get(cv2.CAP_PROP_FRAME_WIDTH))
        height = int(self.cap.get(cv2.CAP_PROP_FRAME_HEIGHT))
        fps = int(self.cap.get(cv2.CAP_PROP_FPS))
        print(f"✅ 摄像头已打开")
        print(f"  分辨率：{width}x{height}")
        print(f" FPS: {fps}")
        return True

    def show_preview(self):
        """实时预览"""
        print("📺 实时预览中...")
        print(" 按 'q' 退出预览")
        print(" 按 'p' 拍照")
        print(" 按 'r' 开始/停止录像")
        while True:
            ret, frame = self.cap.read()
            cv2.imshow('Webcam Test', frame)
            key = cv2.waitKey(1) & 0xFF
            if key == ord('q'):
                break
            elif key == ord('p'):
                self.take_photo(frame)
        cv2.destroyAllWindows()

版本 2：自动拍照版 (webcam-snap.py)

#!/usr/bin/env python3
""" 本地摄像头测试工具 - 自动拍照版本 """
import cv2
import os
from datetime import datetime

def main():
    save_dir = os.path.expanduser("~/Pictures/WebcamTest")
    os.makedirs(save_dir, exist_ok=True)
    cap = cv2.VideoCapture(0)
    if not cap.isOpened():
        print("❌ 无法打开摄像头")
        return
    print("✅ 摄像头已打开")
    print(f"  分辨率：{int(cap.get(cv2.CAP_PROP_FRAME_WIDTH))}x{int(cap.get(cv2.CAP_PROP_FRAME_HEIGHT))}")
    # 预热摄像头
    for i in range(30):
        cap.read()
    # 拍照
    ret, frame = cap.read()
    if ret:
        timestamp = datetime.now().strftime("%Y%m%d_%H%M%S")
        filename = os.path.join(save_dir, f"photo_{timestamp}.jpg")
        cv2.imwrite(filename, frame)
        print(f"✅ 照片已保存：{filename}")
    cap.release()

if __name__ == "__main__":
    main()

3. 运行并拍照

python D:\openclaw-scripts\webcam-snap.py

技术总结

WSL2 无法直接访问摄像头硬件，需要 Windows 原生程序配合。通过 Python + OpenCV 方案可成功实现自动化调用，适用于 AI 助手的视觉输入场景。

经验教训

1. 理解架构限制：WSL2 与 Windows 存在网络与硬件隔离。
2. 利用现有工具：优先选择成熟的开源库如 OpenCV。
3. 自动化优先：避免依赖手动操作的浏览器方案。
4. 灵活变通：当主方案受阻时，及时切换至底层原生方案。