LightVela

モデルの設定

概要

モデルの設定は任意です:あなたのプランには毎月のモデルクレジットが含まれているため、エージェントを作成してチャネルを接続するとすぐに会話を始めることができ、クレジットがなくなった後にのみモデルを設定する必要があります。コンソールのモデルセクションには、次の3つのオプションがあります:モデルコーディングプラン(毎月または年間、使用量が多い場合に最適)、モデルAPI(従量制、軽い利用や試用に最適)、カスタムモデル(OpenAI互換のエンドポイントを接続)。いずれも、対応するプロバイダから取得した自身のAPIキーが必要です。手順は次の通りです:ソースを選ぶ、特定のモデルを選ぶ、APIキーを貼り付け、デフォルトとして設定する。メモリを失うことなく後でモデルを切り替えることができます。APIキーは機密情報です— チャットグループや公開ページに投稿せず、Gitリポジトリにコミットせず、もし漏洩した場合はプロバイダーコンソールで直ちに無効化またはローテーションしてください。


このページでは、Hermes Agent用に大規模言語モデルを設定する方法について説明します。設定方法の違い、APIキーの取得方法、コンソールでの設定手順、サポートされているモデル、およびモデル選択のガイダンスが含まれます。


このページの内容

  • 3つの設定方法(コーディングプラン / API / カスタムモデル)の違い

  • APIキーの取得方法

  • コンソール設定手順

  • モデルの切り替え

  • サポートされているモデル

  • モデル選択のガイダンス


3つの設定方法

コンソールの「モデル」カードの第一レベルのドロップダウンには、3つのオプションがあります:

方法請求モードAPIキーの提供元使用例
モデルコーディングプラン月額 / 年額提供者高頻度使用
モデルAPI従量課金提供者低頻度使用またはトライアル
カスタムモデルエンドポイントによるユーザー提供海外モデルやOpenAI互換のエンドポイントに接続

API キー取得の一般的な手順

プロバイダーの画面は異なりますが、手順は概ね同じです:

  1. プロバイダーのウェブサイトを訪問:コンソールのモデルカードでモデルを選択すると、「API KEY を取得」リンクが下に表示されます。クリックしてプロバイダーのウェブサイトを開きます

  2. 登録またはサインイン: ほとんどの中国のプラットフォームはWeChatまたは電話番号でのログインをサポートしています

  3. 実名認証を完了する: 中国のモデル提供者は通常、API呼び出しが許可される前に実名認証を要求します

  4. APIキー管理ページを開く: 通常「コンソール → API管理 / キー管理 / 認証情報」の下にあります

  5. 新しいキーを作成する: キーに名前を付け(例: LightVela)、作成後すぐにコピーします。ほとんどのプラットフォームではキー全体は一度しか表示されません

  6. LightVelaに戻り、キーを貼り付ける


コンソールで設定

コンソールに入り、「モデル」ボタンを開きます。

設定手順

  1. ソースを選択(第一レベルのドロップダウン):Model API / Model Coding Plan / カスタムモデル

  2. 特定のモデルを選択(第二レベルのドロップダウン):上記で選択したソースに基づいて利用可能なモデルが表示されます

  3. APIキーを入力:取得したキーを貼り付けます。右側の目のアイコンで表示/非表示を切り替えられます

  4. 「デフォルトとして追加」をクリック

  5. 対応するレコードが「現在のモデル」リストに表示され、設定が成功したことを示します

カスタムモデル用の追加フィールド

「カスタムモデル」を選択すると、通常、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(従量課金制)

名前提供者
OpenAIOpenAI
AnthropicAnthropic
Google Geminiグーグル
OpenRouterOpenRouter
DeepSeekDeepSeek
百聯(Qwen)アリババ
MiniMax(国際版)MiniMax
Moonshot AI(Kimi International)ムーンショット
智谱AI(GLM International)智谱
ボルケーノエンジン(Doubao)バイトダンス
Xiaomi MiMoXiaomi

カスタムモデル

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エラーが表示される場合は、通常、以下のいずれかが原因です:

  1. モデルのAPIキーが正しく設定されていない;

  2. コーディングプランのAPIキーと通常のモデルAPIキーが混同されている;

  3. モデルプロバイダーの国内版または国際版が誤って選択されている;

このような場合は、モデル設定を再度確認してください。


次のステップ

最終更新日: 2026-08-28