用途:该技能用于通过 API 操作已部署的 Open WebUI 实例,将请求转化为对应的 Open WebUI / Ollama 接口调用。适用请求包括:列出 Open WebUI 实例中的可用模型、向指定模型发送对话补全、上传文件用于 RAG、管理知识库集合与文件、使用 Ollama 代理端点(生成、嵌入、拉取模型)、通过 Open WebUI 生成图像或处理音频、查询 Ollama 状态与管理模型(加载、卸载、删除)、创建或管理 pipelines。不适用:安装或配置 Open WebUI 服务器、解释 Open WebUI 是什么、排查服务端问题、与 Open WebUI API 无关的本地文件操作。
前提与鉴权:需设置环境变量,例如 export OPENWEBUI_URL="http://localhost:3000" 与 export OPENWEBUI_TOKEN="your-api-key-here",Token 来自 Open WebUI 的 Settings > Account。使用 Bearer Token 鉴权,高级场景也可用 JWT。
使用方式:推荐用随附 CLI,如 python3 scripts/openwebui-cli.py --help、python3 scripts/openwebui-cli.py models list、python3 scripts/openwebui-cli.py chat --model llama3.2 --message "Hello";也可用 curl 直连,如 curl -H "Authorization: Bearer $OPENWEBUI_TOKEN" "$OPENWEBUI_URL/api/models"。核心端点包括对话补全 POST /api/chat/completions、模型列表 GET /api/models、Ollama 原生对话 POST /ollama/api/chat 与生成 POST /ollama/api/generate;Ollama 代理含 tags、pull、delete、embed、ps;RAG 与知识库含 POST /api/v1/files/、GET /api/v1/files/{id}/process/status、/api/v1/knowledge/ 及加文件;图像与音频含 /api/v1/images/generations、/api/v1/audio/speech、/api/v1/audio/transcriptions。
限制与边界:删除模型、拉取大模型、删除知识集合、上传敏感文件前需确认;不得记录完整 API Token,应脱敏;上传文件默认位于工作目录,访问工作目录外文件需确认;纯 API 客户端,不需要 sudo/root。文件用于 RAG 时异步处理,需轮询状态为 completed 后再加入知识集合;大模型下载可能耗时较长;对话补全支持流式输出。常见错误:401 检查 Token,404 检查模型名或端点,422 检查参数,400 可能文件仍在处理,连接被拒检查 URL。