モデルの設定
概要
モデルの設定は任意です:あなたのプランには毎月のモデルクレジットが含まれているため、エージェントを作成してチャネルを接続するとすぐに会話を始めることができ、クレジットがなくなった後にのみモデルを設定する必要があります。コンソールのモデルセクションには、次の3つのオプションがあります:モデルコーディングプラン(毎月または年間、使用量が多い場合に最適)、モデルAPI(従量制、軽い利用や試用に最適)、カスタムモデル(OpenAI互換のエンドポイントを接続)。いずれも、対応するプロバイダから取得した自身のAPIキーが必要です。手順は次の通りです:ソースを選ぶ、特定のモデルを選ぶ、APIキーを貼り付け、デフォルトとして設定する。メモリを失うことなく後でモデルを切り替えることができます。APIキーは機密情報です— チャットグループや公開ページに投稿せず、Gitリポジトリにコミットせず、もし漏洩した場合はプロバイダーコンソールで直ちに無効化またはローテーションしてください。
このページでは、Hermes Agent用に大規模言語モデルを設定する方法について説明します。設定方法の違い、APIキーの取得方法、コンソールでの設定手順、サポートされているモデル、およびモデル選択のガイダンスが含まれます。
このページの内容
-
3つの設定方法(コーディングプラン / API / カスタムモデル)の違い
-
APIキーの取得方法
-
コンソール設定手順
-
モデルの切り替え
-
サポートされているモデル
-
モデル選択のガイダンス
3つの設定方法
コンソールの「モデル」カードの第一レベルのドロップダウンには、3つのオプションがあります:
| 方法 | 請求モード | APIキーの提供元 | 使用例 |
|---|---|---|---|
| モデルコーディングプラン | 月額 / 年額 | 提供者 | 高頻度使用 |
| モデルAPI | 従量課金 | 提供者 | 低頻度使用またはトライアル |
| カスタムモデル | エンドポイントによる | ユーザー提供 | 海外モデルやOpenAI互換のエンドポイントに接続 |
API キー取得の一般的な手順
プロバイダーの画面は異なりますが、手順は概ね同じです:
-
プロバイダーのウェブサイトを訪問:コンソールのモデルカードでモデルを選択すると、「API KEY を取得」リンクが下に表示されます。クリックしてプロバイダーのウェブサイトを開きます
-
登録またはサインイン: ほとんどの中国のプラットフォームはWeChatまたは電話番号でのログインをサポートしています
-
実名認証を完了する: 中国のモデル提供者は通常、API呼び出しが許可される前に実名認証を要求します
-
APIキー管理ページを開く: 通常「コンソール → API管理 / キー管理 / 認証情報」の下にあります
-
新しいキーを作成する: キーに名前を付け(例:
LightVela)、作成後すぐにコピーします。ほとんどのプラットフォームではキー全体は一度しか表示されません -
LightVelaに戻り、キーを貼り付ける
コンソールで設定
コンソールに入り、「モデル」ボタンを開きます。
設定手順
-
ソースを選択(第一レベルのドロップダウン):Model API / Model Coding Plan / カスタムモデル
-
特定のモデルを選択(第二レベルのドロップダウン):上記で選択したソースに基づいて利用可能なモデルが表示されます
-
APIキーを入力:取得したキーを貼り付けます。右側の目のアイコンで表示/非表示を切り替えられます
-
「デフォルトとして追加」をクリック
-
対応するレコードが「現在のモデル」リストに表示され、設定が成功したことを示します

カスタムモデル用の追加フィールド
「カスタムモデル」を選択すると、通常、APIキーに加えて以下のフィールドを入力する必要があります:
-
ベースURL:モデルサービスのAPIアドレス、例えば
https://api.openai.com/v1 -
モデル名: モデルの識別子、例えば
gpt-4oまたはclaude-3-5-sonnet-20241022
実際のフィールドはコンソールインターフェースに依存します。
モデルの切り替え
切り替え方法
再度設定手順を実行します。新しい「デフォルトとして追加」アクションは以前の設定を上書きします。
メモリへの影響
モデルを切り替えても会話のメモリには影響しません。メモリはHermes Agent自体に属し、モデルは応答を生成する役割のみを担います。
サポートされているモデル
モデルコーディングプラン(月間)
| 名前 | 提供者 |
|---|---|
| Zhipu AI(GLM国際 - コーディングプラン) | Zhipu AI |
| Kimiコーディングプラン | Moonshot AI |
| Xiaomiトークンプラン | Xiaomi |
| 百聯コーディング計画 | アリババクラウド百聯 |
| ボルケーノエンジンアークコーディング計画 | ボルケーノエンジン(バイトダンス) |
モデルAPI(従量課金制)
| 名前 | 提供者 |
|---|---|
| OpenAI | OpenAI |
| Anthropic | Anthropic |
| Google Gemini | グーグル |
| OpenRouter | OpenRouter |
| DeepSeek | DeepSeek |
| 百聯(Qwen) | アリババ |
| MiniMax(国際版) | MiniMax |
| Moonshot AI(Kimi International) | ムーンショット |
| 智谱AI(GLM International) | 智谱 |
| ボルケーノエンジン(Doubao) | バイトダンス |
| Xiaomi MiMo | Xiaomi |
カスタムモデル
OpenAI Chat Completions プロトコルと互換性のある任意のエンドポイントを接続できます。具体的には以下を含みます:
-
自己ホスト型モデル: vLLM、Ollama、LM Studio、その他のOpenAI互換エンドポイントを提供するサービス
-
集約プラットフォーム: OpenRouter など
選択ガイド
異なる優先事項に応じた選択の指針:
| 優先事項 | 推奨方向 |
|---|---|
| 無料クオータ | 多くのプロバイダーが新規アカウントに無料クオータを提供しています。まずトライアルから始めましょう |
| 長い文脈の処理 | より大きなコンテキストウィンドウを持つモデルを選んでください(例:Moonshot AI) |
| 応答速度 | プロバイダーによって大きく異なります。実際の使用経験に頼りましょう |
| 中国語理解 | 中国のモデルは一般的に中国語のサポートがより優れています |
| 高頻度使用 | 対応するプロバイダーの月額コーディングプランを選択してください |
推奨: 最初にLaunchプランのトライアルクレジットを使って数回会話してみてください。Hermes Agentが正常に動作することを確認した後、どのモデルを使用するか決定してください。
FAQ
| 問題 | 考えられる原因 | 解決策 |
|---|---|---|
| キーを入力した後でも「現在のモデル」はまだ空です | キーの形式が間違っているか、スペースが含まれています | もう一度コピーして貼り付け、前後にスペースがないことを確認してください |
| メッセージを送信しても長時間応答がありません | プロバイダの残高が不足しているか、キーが無効です | プロバイダコンソールで残高とキーの状態を確認してください |
| 応答内容が文字化けしているか意味不明です | カスタムモデルのエンドポイントはOpenAIプロトコルと互換性がありません | まず別のOpenAI互換クライアントでエンドポイントの利用可能性を確認してください |
| 「モデル応答タイムアウト」 | プロバイダのレート制限やネットワークの不安定性 | 後でもう一度試すか、別のプロバイダに切り替えてください |
| カスタムモデルのBase URLがわからない | — | 対応するサービスのAPIドキュメントを確認してください。通常はhttps://xxx.com/v1です |
会話エラー「HTTP 401: InvalidAuthentication」または類似の401エラー
会話中にOpenClawでHTTP 401:InvalidAuthenticationまたは他の401 xxxエラーが表示される場合は、通常、以下のいずれかが原因です:
-
モデルのAPIキーが正しく設定されていない;
-
コーディングプランのAPIキーと通常のモデルAPIキーが混同されている;
-
モデルプロバイダーの国内版または国際版が誤って選択されている;
このような場合は、モデル設定を再度確認してください。
次のステップ
最終更新日: 2026-08-28
設定の概要
すべてのLightVela設定は「My Hermes」コンソールにあり、サインイン後に右上隅から開くことができます。エージェントインスタンスのタブは上部にあり、その下には3つの設定ボタンがあります:Models(モデルコーディングプラン、Model API、またはカスタムOpenAI互換エンドポイントを選択)、Channels(各メッセージングプラットフォー…
チャンネルを設定 - Telegram
Telegram チャンネルはボットトークンを使用して接続されるため、Hermes Agent を Telegram のダイレクトメッセージやグループに素早く導入する方法として便利です: Telegram で BotFather を通じてボットを作成し、そのボットトークンをコピーして LightVela コンソールのチャンネルセクションに貼り付けます。