PicGo-Skill：调用本地 PicGo 服务上传图片

PicGo-Skill

项目地址：https://github.com/Naratsuna/Picgo-Skill

一个用于调用本地 PicGo 服务上传图片的 Python 技能，支持灵活配置服务地址、外部传入图片路径，适配 OpenClaw 等技能调用框架。

功能特点

• 🚀 封装 PicGo 上传接口，一键上传本地图片
• ⚙️ 服务地址优先读取环境变量，支持自定义配置
• 📁 支持单张/多张图片批量上传
• 🛡️ 完善的参数校验和异常处理
• 🖥️ 支持命令行传参调用，适配自动化场景

前置条件

1. 本地已启动 PicGo 服务（默认端口 36677）
2. Python 3.7+ 环境

安装依赖

pip install requests

快速使用

方式1：命令行传参（推荐）

# 上传单张图片
python picgo_skill.py "C:/Users/XIAOREN/.openclaw/workspace/cat_couplets.jpg"

# 上传多张图片
python picgo_skill.py "C:/img1.jpg" "D:/img2.png" "E:/img3.jpg"

方式2：编程调用

from picgo_skill import PicgoSkill

# 初始化技能（可选指定服务地址，默认读取环境变量）
picgo = PicgoSkill(server_url="http://127.0.0.1:36677")

# 传入图片路径列表
image_list = [
    "C:/test/photo.jpg",
    "D:/demo/pic.png"
]

# 执行上传
result = picgo.upload_images(image_list)

# 处理结果
if result:
    print("上传成功！响应：", result)
else:
    print("上传失败，请检查配置或图片路径")

环境变量配置

可选配置环境变量自定义 PicGo 服务地址，无需修改代码：

# Windows (cmd)
set PICGO_SERVER_URL=http://127.0.0.1:36677

# Windows (PowerShell)
$env:PICGO_SERVER_URL="http://127.0.0.1:36677"

# Linux/Mac
export PICGO_SERVER_URL=http://127.0.0.1:36677

常见问题

Q1: 提示上传失败，服务连接超时？

A1: 检查 PicGo 服务是否启动、端口是否为 36677，或确认 PICGO_SERVER_URL 配置的地址正确。

Q2: 提示图片路径为空？

A2: 确保传入的图片路径是列表类型且非空，路径为本地真实存在的图片。

Q3: 命令行调用时参数报错？

A3: 图片路径包含空格时需用引号包裹，例如：python picgo_skill.py "C:/My Pictures/photo.jpg"。

注意事项

• 默认超时时间 30 秒，可修改代码中 timeout 参数调整
• 支持 Windows/macOS/Linux 系统
• 上传前请确保 PicGo 已配置好图床（如阿里云 OSS、腾讯云 COS 等）