LangBot の接続

難易度 🧩 中級　|　インターフェース形式 OpenAI 互換　|　base_url https://byesu.com/v1

接続情報 · これらを入力

API アドレスhttps://byesu.com/v1

API キーsk-xxxxxxxxコンソールで作成 →

モデルgpt-5.5

API 形式 OpenAI 互換 · モデル名は コンソール に準拠

LangBot はオープンソースのインスタントメッセージング向けボット開発プラットフォームで、Feishu（飛書）、DingTalk（釘釘）、企業向け WeChat（企業微信）、QQ、Telegram、Discord、Slack など多数のプラットフォームに対応し、ナレッジベース、Agent、MCP の機能を内蔵しています。Byesu 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 に変更すればOKです。ない場合は OpenAI 互換プロバイダーを選んでください。結果は同じです。

モデル名は、グループ内で実際に利用可能なものと一致させる必要があります。よく使うもの：

• 対話用途：gpt-5.5、claude-opus-4-8
• 長文 / 推論：gemini-3.1-pro-high

ステップ 3：パイプラインで有効化して動作確認する

1. パイプライン（Pipeline） 設定に入り、対話ノードのモデル選択でステップ 2 で追加したモデルを選択します。
2. 保存したら、管理画面に備わっている 対話デバッグ ウィンドウで一言送信してテストします。
3. 正常に返信を受け取れれば、接続成功です。あとは Feishu / QQ などのプラットフォームアカウントを紐付ければ運用を開始できます。

ナレッジベース（任意）

LangBot は Embedding モデルを使ったベクトルナレッジベースに対応しています。もう 1 つモデルを追加し、リクエスト先のアドレスには同じく https://byesu.com/v1 を入力し、モデル名にはグループ内で利用可能な Embedding モデルを入力します。そのうえで、新しいナレッジベースを作成する際にそれを選択すればOKです。

うまくいかないときは？

• 401 / 認証失敗：API Key の入力が間違っているか、余分なスペースが含まれています。コンソール に戻って、完全な sk-xxxx をコピーし直してください。詳しくは よくあるエラー #auth をご覧ください。
• 404 / インターフェースが見つからない：リクエスト先のアドレスに /v1 が抜けています。https://byesu.com/v1 とする必要があります。
• 利用可能なチャネルがない / モデルが存在しない：トークンのグループにそのモデルが含まれていません。別のモデル名に変えるか、トークンを作り直して正しいグループを選んでください。グループの選択 と よくあるエラー #no-channel をご覧ください。
• 残高不足：アカウントの残高を使い切っています。チャージ後に再試行してください。よくあるエラー #balance をご覧ください。

その他のトラブルシューティングは よくあるエラー をご覧ください。