AstrBot の接続
難易度 ⌨️ 上級 | インターフェース形式 OpenAI 互換 | base_url
https://byesu.com/v1
AstrBot は、オープンソースのオールインワン型チャットボット Agent プラットフォームで、AI を QQ、Feishu（飛書）、DingTalk（釘釘）、WeChat Work（企業微信）などのチャットアプリに接続できます。その「モデルプロバイダー」を Byesu API に向けるだけで、あなたのボットで gpt-5.5、claude-opus-4-8 などのモデルを利用できるようになります。
はじめる前に
まず コンソール → トークン で新しいトークン（sk-xxxx のような形式）を作成し、トークンに正しいグループを選択してください。グループによって、呼び出せるモデルと課金方式が決まります。選び方が分からない場合は グループの選択 をご覧ください。
ステップ 1：AstrBot 管理パネルをデプロイして開く
AstrBot は Docker、宝塔（Baota）、ソースコードなど複数のデプロイ方式に対応しています。デプロイの詳細は AstrBot 公式ドキュメント をご覧ください。Docker でのワンクリック起動の例：
docker run -d \
--name astrbot \
-p 6185:6185 \
-v $PWD/astrbot/data:/AstrBot/data \
soulter/astrbot:latest起動後、ブラウザで管理パネルを開きます：
http://あなたのサーバーIP:6185初回アクセス時は管理者アカウントとパスワードの設定が案内されます。ログインするとコンソールに入ります。
ステップ 2：モデルプロバイダーを追加する（base_url + Key を入力）
管理パネル左側の モデルプロバイダー（Provider） に入り、サービスプロバイダーの追加 / 新規作成 をクリックして、以下のように入力します：
| 項目 | 入力内容 |
|---|---|
| プロバイダータイプ | OpenAI を選択（OpenAI インターフェース互換） |
| API Base URL | https://byesu.com/v1 |
| API Key | あなたのトークン sk-xxxx |
| モデル（Model） | Byesu の実際のモデル名、例：gpt-5.5 |
base_url には必ず /v1 を付ける
AstrBot は OpenAI 互換インターフェースを使用するため、API Base URL には必ず https://byesu.com/v1（末尾に /v1 を付ける）を入力してください。/v1 を省くとリクエストが 404 になったり、接続できなくなったりします。
よく使うモデル名（必要に応じて選んで入力、パネル内で複数設定可能）：
gpt-5.5 # OpenAI、総合的な対話
claude-opus-4-8 # Anthropic、強力な推論 / 長文
gemini-3.1-pro-high # Google、マルチモーダル入力したら 保存 をクリックします。一部のバージョンには「テスト / モデルリストの取得」ボタンがあり、クリックすると base_url と Key の接続を確認できます。
ステップ 3：デフォルトモデルに設定して検証する
- 設定ファイル（Configuration）→ モデル / 大規模言語モデル の領域に入ります。
- デフォルトチャットモデル（Default Chat Provider / Model） を、前のステップで新規作成した Byesu プロバイダーに設定します。
- 保存 をクリックし、必要に応じて再起動 / 設定の再読み込みを行います。
その後、すでに連携したチャットプラットフォーム（またはパネル付属の対話テスト入口）で一言メッセージを送り、ボットが正常に返信すれば接続成功です。返信がおかしい場合は、まずプロバイダー設定に戻って base_url、Key、モデル名を確認してください。
うまくいかないときは？
- 401 / 認証失敗：Key の入力ミス、または
sk-プレフィックスの付け忘れです。完全なトークンをコピーして再入力してください。詳しくは よくあるエラー · 認証 をご覧ください。 - 404 / 接続できない：API Base URL に
/v1が付いていません。https://byesu.com/v1にする必要があります。 - 利用可能なチャネルがない / モデルが存在しないと表示される：トークンのグループがそのモデルをカバーしていないか、モデル名が間違っています。
gpt-5.5、claude-opus-4-8などの実際のモデル名に変更し、正しいグループを選択 してください。よくあるエラー · 利用可能なチャネルなし をご覧ください。 - 残高不足：アカウントまたはトークンの残高が尽きています。チャージするか、トークンの上限を引き上げてから再試行してください。よくあるエラー · 残高 をご覧ください。
その他のトラブルシューティングは よくあるエラー をご覧ください。