LangBot 接入

难度 🧩 中等　|　接口格式 OpenAI 兼容　|　base_url https://byesu.com/v1

接入信息 · 填这几样

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

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

推荐模型gpt-5.5

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

LangBot 是一款开源的即时通信机器人开发平台，支持飞书、钉钉、企业微信、QQ、Telegram、Discord、Slack 等多种平台，并内置知识库、Agent 与 MCP 能力。把半页酥 API 接进 LangBot，你就能用 gpt-5.5、claude-opus-4-8 等模型驱动你的聊天机器人。

开始之前

先到 控制台 → 令牌 创建一个 API 令牌（形如 sk-xxxx）。

创建时务必选对分组——分组决定了你能调用哪些模型、走哪条线路。不清楚怎么选看 选择分组。

第 1 步：安装并启动 LangBot

LangBot 提供多种部署方式，推荐 Docker 一键启动。

Docker（推荐）

git clone https://github.com/langbot-app/LangBot
cd LangBot
docker compose up -d

手动部署

# 从 Releases 下载对应平台安装包
# https://github.com/langbot-app/LangBot/releases
# 解压后按文档启动

启动后在浏览器打开 http://localhost:5300，按提示完成初始化（设置管理员账号密码），进入管理后台。

官方文档：https://docs.langbot.app

第 2 步：添加模型（填 base_url + Key）

在 LangBot 管理后台左侧进入 模型 管理页面，点击 添加模型，按下表填写：

字段	填写内容
模型供应商 / 请求 URL	https://byesu.com/v1
API Key	你的令牌 sk-xxxx
模型名称	gpt-5.5（或 claude-opus-4-8、gemini-3.1-pro-high）

base_url 要带 /v1

LangBot 走 OpenAI 兼容接口，请求地址必须是 https://byesu.com/v1，结尾带 /v1。漏掉会报 404。

如果供应商列表里有 NewAPI 选项，直接选它，再把请求地址改成 https://byesu.com/v1 即可；没有的话选 OpenAI 兼容供应商，效果一致。

模型名要和分组里真实可用的对应。常用：

• 对话场景：gpt-5.5、claude-opus-4-8
• 长文/推理：gemini-3.1-pro-high

第 3 步：在流水线中启用并验证

1. 进入 流水线（Pipeline） 配置，在对话节点的模型选择里选中第 2 步添加的模型。
2. 保存后，在后台自带的 对话调试 窗口发一句话测试。
3. 能正常收到回复，说明接入成功。再去绑定飞书 / QQ 等平台账号即可上线。

知识库（可选）

LangBot 支持用 Embedding 模型做向量知识库。再添加一个模型，请求地址同样填 https://byesu.com/v1，模型名填分组内可用的 Embedding 模型，然后在新建知识库时选中它即可。

卡住了？

• 401 / 鉴权失败：API Key 填错或带了多余空格，回 控制台 重新复制完整的 sk-xxxx。详见 常见错误 #auth。
• 404 / 接口找不到：请求地址漏了 /v1，应为 https://byesu.com/v1。
• 无可用渠道 / 模型不存在：令牌分组里没有这个模型，换个模型名或重建令牌选对分组。见 选择分组 与 常见错误 #no-channel。
• 余额不足：账户额度用尽，充值后重试。见 常见错误 #balance。

更多排查见 常见错误。