本页参考 New API 官方 AI 应用文档，已按青云 TOP API（New API 兼容）环境整理。API 地址使用 https://top.qingyuntop.ai/v1，API Key 使用 $QINGYUN_TOP_API_KEY 占位符，请在青云 TOP API 控制台创建并妥善保存密钥。

Memoh 对接教程 — 将自托管容器化 AI 智能体平台对接 青云 TOP API，为 Telegram、Discord、飞书、QQ、微信等渠道创建具有长期记忆的 AI 机器人。

Memoh 是一个开源的自托管 AI 智能体平台，每个机器人运行在独立的容器中，拥有持久化记忆和独立文件系统。支持接入 Telegram、Discord、飞书、QQ、Matrix、企业微信、微信、邮件以及内置 Web UI 等 9 种渠道，并支持 MCP 工具调用、浏览器自动化、定时任务等丰富的智能体能力。

核心特性

  • 容器化隔离：每个机器人运行在独立的 containerd 容器中，拥有专属文件系统和网络，支持快照、数据导入导出
  • 记忆引擎：基于 LLM 的事实抽取、混合检索（稠密 + 稀疏 + BM25）、24 小时上下文加载、记忆压缩与重建
  • 多渠道支持：Telegram、Discord、飞书、QQ、Matrix、企业微信、微信、邮件、Web UI
  • MCP 支持：完整的 MCP 协议支持（HTTP / SSE / Stdio / OAuth），每个机器人可独立管理 MCP 连接
  • 浏览器自动化：内置 Playwright 驱动的无头浏览器，支持网页浏览、表单填写、截图等操作
  • Web 管理面板：基于 Vue 3 + Tailwind CSS 的现代化管理界面，支持流式对话、工具调用可视化、文件管理等

快速安装

Memoh 基于 Docker 部署，一键安装（需要 Docker）：

curl -fsSL https://memoh.sh | sudo sh

或手动安装：

git clone --depth 1 https://github.com/memohai/Memoh.git
cd Memoh
cp conf/app.docker.toml config.toml
# 编辑 config.toml 配置文件
sudo docker compose up -d

启动后访问 http://localhost:8082，默认账号密码：admin / admin123。

青云 TOP API 接入方法

Memoh 支持接入任何 OpenAI 兼容的模型提供商，可以通过 青云 TOP API 来统一管理和访问各种 AI 模型服务。

配置步骤

获取 青云 TOP API API Key 密钥

在 青云 TOP API 注册并登录后，点击上方导航栏的「控制台」，点击「令牌管理」，然后点击「添加令牌」按钮，创建一个新的 API Key 密钥，选择适当的权限，然后点击「创建」。

创建成功后，点击复制密钥按钮，复制生成的 API Key 密钥。

copy-api-key

在 Memoh 中添加模型提供商

登录 Memoh Web 管理面板，进入提供商管理页面，点击青云 TOP API。

switch-to-青云 TOP API-provider

在配置页面中填写以下信息：

  • API Base URL：填写 青云 TOP API 的接口地址，例如 https://top.qingyuntop.ai/v1（如果本地部署则填写 https://top.qingyuntop.ai/v1）
  • API Key：粘贴从 青云 TOP API 复制的 API Key 密钥

点击保存，完成提供商配置。

导入模型

提供商配置完成后，进入模型管理页面，点击自动导入或手动添加你需要使用的模型。

为机器人配置模型

进入机器人设置页面，在模型配置一栏中，将默认聊天模型切换为刚刚通过 青云 TOP API 提供商添加的模型，点击保存。

set\_chat\_model

至此，您已经成功配置了 青云 TOP API 作为 Memoh 的模型提供商。现在，您可以通过 Memoh 中的各个渠道（Telegram、Discord、飞书等）与 AI 机器人对话，所有请求将通过 青云 TOP API 进行转发。

接入检查

  • API 地址填写青云 TOP API 的 Base URL：https://top.qingyuntop.ai/v1；应用若要求不带 /v1 的站点地址，请按页面说明填写对应格式。
  • API Key 只使用环境变量 $QINGYUN_TOP_API_KEY 或应用的安全密钥存储，不要把真实密钥提交到代码仓库。
  • 模型名称必须与控制台可用模型完全一致；遇到 401/403 检查密钥、分组和模型权限，遇到 404 检查 Base URL 是否重复填写 /v1。

发布前检查

以下检查适用于客户端中选择 OpenAI 兼容 或 Responses 提供商的场景；如果你选择的是 Anthropic、Gemini 等原生协议，请按对应协议的接口和返回结构配置。

  1. 模型 ID：先用目标 API Key 请求 GET https://top.qingyuntop.ai/v1/models，把返回的 data[].id 原样填入客户端。截图、教程和历史配置中的模型名不保证仍可用。
  2. 协议选择：新 OpenAI 集成优先选择 Responses；只有客户端或模型明确要求 Chat Completions 时才选择 Chat。Responses 的返回从 output 读取，Chat 的返回从 choices[].message 读取。
  3. Base URL：通常填写 https://top.qingyuntop.ai/v1，也就是只保留一个 /v1。要求完整接口地址的客户端才追加 /responses 或 /chat/completions，不要重复追加。
  4. 流式与重试：流式响应必须按所选协议解析事件；连接中断后不要盲目重放可能已被服务端接受的生成请求。对 429 和 5xx 使用带抖动的退避，并设置连接、读取和总超时。
  5. 上线前验证：分别验证普通文本、流式文本、工具调用或结构化输出中实际用到的能力，并记录 request id、HTTP 状态、业务状态和完成原因，避免只根据 HTTP 200 判定成功。