Skip to main content
Open WebUI 是一个功能丰富的自托管 AI 平台,支持完全离线运行。通过 老张API,您可以在 Open WebUI 中集成各种主流大语言模型。

快速部署

Docker 快速启动

Docker Compose 部署

配置 老张API

方法一:环境变量配置

在部署时设置环境变量:

方法二:界面配置

  1. 访问 Open WebUI 管理界面
  2. 进入 Settings > Connections
  3. OpenAI API 部分配置:
    • API Base URL: https://api2.laozhang.ai/v1
    • API Key: 输入您的 老张API 密钥
  4. 点击保存配置
配置要点
  • API Base URL 需要包含 /v1 后缀
  • API Key 可在 老张API控制台 获取
  • 建议使用环境变量方式,便于管理和更新

支持的模型

Open WebUI 通过 老张API 支持以下模型系列:

推荐模型

特色功能模型

核心功能

RAG (检索增强生成)

Open WebUI 支持文档上传和知识库功能:
  1. 文档上传
    • 支持 PDF、TXT、DOCX 等格式
    • 自动向量化存储
    • 支持多语言文档
  2. 知识库管理
    • 创建专项知识库
    • 文档分类和标签
    • 智能检索匹配

OpenAI 兼容 API

Open WebUI 提供完整的 OpenAI 兼容 API:

工具集成

支持外部工具和插件:
  • 网络搜索
  • 代码执行
  • 图像生成
  • 文档处理

高级配置

多模型配置

docker-compose.yml 中配置多个模型源:

用户权限管理

数据持久化

API 集成示例

Python 集成

JavaScript 集成

故障排除

常见问题

连接失败
  • 检查 API Base URL 是否正确:https://api2.laozhang.ai/v1
  • 验证 API Key 有效性
  • 确认防火墙设置
模型不可用
  • 检查账户余额
  • 确认模型在服务范围内
  • 查看 老张API 服务状态
上传失败
  • 检查文件格式支持
  • 确认存储空间充足
  • 验证文件大小限制

日志调试

启用调试模式:
查看详细日志:

最佳实践

性能优化

  1. 模型选择
    • 日常对话使用 GPT-4.1 Mini
    • 复杂任务使用 GPT-5.5
    • 长文本处理使用 Claude Sonnet 4.6
  2. 缓存策略
    • 启用对话缓存
    • 设置合理的缓存过期时间
    • 定期清理无用缓存
  3. 资源管理
    • 监控内存使用
    • 设置合理的并发限制
    • 定期备份用户数据

安全配置

监控告警

集成监控系统:
需要更多帮助?请查看 Open WebUI 官方文档 或访问 老张API官网