Memoh 接入

难度 ⌨️ 进阶　|　接口格式 OpenAI 兼容　|　base_url https://byesu.com/v1

接入信息 · 填这几样

接口地址https://byesu.com/v1

API 密钥sk-xxxxxxxx去控制台创建 →

推荐模型gpt-5.5

接口格式 OpenAI 兼容 · 模型名以 控制台 实际为准

Memoh 是一个开源、自托管的 AI 智能体（Agent）平台，每个机器人都运行在独立容器中，拥有持久记忆和独立文件系统，并可接入 Telegram、Discord、飞书、QQ、微信等多个渠道。它支持任意 OpenAI 兼容的模型供应商，因此可以直接接入「半页酥 API」。

开始之前

先到 控制台 → 令牌 创建一个令牌（形如 sk-xxxx）。创建时务必选对分组，分组决定了你能用哪些模型和计费倍率——不清楚选哪个就先看 选择分组。

第 1 步：安装 Memoh

Memoh 通过 Docker 一键部署。在你的服务器上执行：

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

也可以手动部署：git clone --depth 1 https://github.com/memohai/Memoh.git 后进入目录，先 cp conf/app.docker.toml config.toml（按需编辑），再 docker compose up -d——别漏掉复制配置文件这步，否则起不来。安装完成后，浏览器访问管理面板：

• 地址：http://localhost:8082（远程服务器替换为对应 IP/域名）
• 默认账号：admin　密码：admin123

安全提示

首次登录后请立即修改默认密码，避免管理面板被他人访问。

第 2 步：添加供应商（填 base_url 与 API Key）

登录管理面板后，进入「供应商管理 / Provider Management」，新增一个 OpenAI 兼容供应商（可命名为 byesu），填写：

字段	填写内容
API Base URL	https://byesu.com/v1
API Key	你在 byesu 控制台创建的令牌，如 sk-xxxx

填好后点击「保存」。

base_url 末尾的 /v1

Memoh 走 OpenAI 兼容协议，base_url 必须带 /v1，即 https://byesu.com/v1，不要漏写也不要重复写成 /v1/v1。

第 3 步：导入模型

进入「模型管理 / Model Management」，使用「自动导入」拉取该供应商可用模型，或手动添加你需要的模型名。建议填写 byesu 真实可用的模型，例如：

gpt-5.5
claude-opus-4-8
gemini-3.1-pro-high

模型要与分组匹配

能否调用某个模型由令牌所在分组决定。如果导入或调用时报模型不可用，多半是分组没选对，回到控制台改令牌分组，详见 选择分组。

第 4 步：配置机器人并验证

1. 进入某个机器人的「设置 → 模型配置 / Model Configuration」。
2. 把默认对话模型切换为上一步导入的 byesu 模型（如 claude-opus-4-8）。
3. 保存。

随后在对应渠道（Telegram / Discord / 飞书等）或面板内的对话框给机器人发一条消息，能正常收到回复即接入成功。

卡住了？

常见问题

• 提示 401 / 无效令牌：API Key 填错或带了多余空格，重新从控制台复制 sk-xxxx。详见 常见错误 #auth。
• 提示余额不足：账户额度用尽，前往控制台充值。详见 常见错误 #balance。
• 提示无可用渠道 / 模型不可用：令牌分组不支持该模型，换模型或改分组。详见 常见错误 #no-channel 与 选择分组。
• 连接超时 / 拉取模型失败：检查 base_url 是否为 https://byesu.com/v1（带 /v1、用 https），以及服务器到外网是否通畅。详见 常见错误 #timeout。

更多排查见 常见错误。