Memoh への接続
難易度 ⌨️ 上級 | インターフェース形式 OpenAI 互換 | base_url
https://byesu.com/v1
Memoh はオープンソースのセルフホスト型 AI エージェント（Agent）プラットフォームです。各ボットは独立したコンテナ内で動作し、永続的なメモリと独立したファイルシステムを持ち、Telegram、Discord、Feishu（飛書）、QQ、WeChat（微信）など複数のチャネルに接続できます。任意の OpenAI 互換モデルプロバイダーに対応しているため、Byesu 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：ボットを設定して動作を確認する
- いずれかのボットの「設定 → モデル設定 / Model Configuration」に進みます。
- デフォルトの会話モデルを、前のステップでインポートした byesu モデル（例：
claude-opus-4-8）に切り替えます。 - 保存します。
その後、該当するチャネル（Telegram / Discord / Feishu など）または画面内のチャットボックスからボットにメッセージを送り、正常に返信が受け取れれば接続成功です。
うまくいかないときは？
よくある質問
- 401 / 無効なトークンと表示される：API Key の入力ミス、または余分なスペースが含まれています。コンソールから
sk-xxxxを再度コピーしてください。詳しくは よくあるエラー #auth をご覧ください。 - 残高不足と表示される：アカウントの残高が尽きています。コンソールでチャージしてください。詳しくは よくあるエラー #balance をご覧ください。
- 利用可能なチャネルがない / モデルが利用できないと表示される：トークンのグループがそのモデルに対応していません。モデルを変更するかグループを変更してください。詳しくは よくあるエラー #no-channel と グループの選択 をご覧ください。
- 接続タイムアウト / モデルの取得失敗：base_url が
https://byesu.com/v1（/v1付き、https を使用）になっているか、およびサーバーから外部ネットワークへの接続が正常かを確認してください。詳しくは よくあるエラー #timeout をご覧ください。
その他のトラブルシューティングは よくあるエラー をご覧ください。