Hermes AgentにKimi K3をつなぐ──公式ガイドが指定する1つのモデル名と、間違えやすい設定ミス

2026年8月27日、Kimi API Platform公式ドキュメントを実際に開いて確認した内容です。 Nous Researchのオープンソースエージェント「Hermes Agent」（永続メモリ・ツール利用・CLI/Telegram/Discord/Slack/WhatsAppなど複数インターフェース対応）は、Zenn検索で「Hermes Agent」と引くだけで40本を超える記事がヒットするほど、日本のエンジニアコミュニティで既に定番になっているツールです。導入記録・VPS構築・プラグイン自作など切り口は多様ですが、今回確認した限りでは、Kimiのプロバイダー設定に絞った日本語記事は見当たりませんでした。Kimi側の公式ドキュメントにHermes Agent専用の接続ガイドがあったので、その中身を見ていきます。

3行まとめ

• Kimi公式ドキュメントに「Use Kimi K3 in Hermes Agent」という専用ガイドがあり、Global Kimi Open PlatformのAPIキーでkimi-k3（1Mトークン文脈・ネイティブ視覚理解）を使う手順を解説
• ガイドはHermes Agent v0.18.2を前提に作られている（プロバイダー選択メニューのラベルは今後のリリースで変わる可能性があると明記）
• Hermes Agent自体は日本語コミュニティで既に定着したツールだが、Kimi K3接続という切り口は今回の実測では日本語記事が確認できなかった

Hermes Agentとは（前提）

Kimi公式ドキュメントの定義によれば、Hermes AgentはNous Researchが開発するオープンソースAIエージェントで、永続メモリ・ツール利用に対応し、CLI・Telegram・Discord・Slack・WhatsAppといった複数のインターフェースを持ちます。日本語コミュニティでは、Mac miniやVPSに常駐させて「自分専用のAIエージェント」として運用する記事が多く見られ、Zenn上の記事だけでも「サーバー代は月1,800円で足りる」「APIキーをそのまま書くな、1Passwordが預かる」といった実運用のノウハウ記事が連載形式で複数本公開されています。

Kimi側が用意している接続ガイドの中身

Kimi API Platformの公式ドキュメントには、Hermes AgentからKimiのモデルを呼び出すための専用ページがあります。冒頭の注記には次のようにあります（原文からの訳）。

「このガイドのスクリーンショットはHermes Agent v0.18.2を使用しています。メニューのラベルは以降のリリースで変わる可能性がありますが、引き続きGlobal Kimi Open PlatformのAPIキー、kimi-k3、https://api.moonshot.ai/v1を使ってください」

APIのベースURLはhttps://api.moonshot.ai/v1で、実際のChat Completionsエンドポイントはhttps://api.moonshot.ai/v1/chat/completionsになる、とも明記されています。

手順1：プロバイダーとK3を選ぶ

hermes model

を実行し、プロバイダー一覧から「Kimi / Moonshot」を選びます。ここでガイドが強調しているのが設定ミスの起きやすいポイントで、v0.18.2ではサブメニューの最初の項目（現在のラベルは「Kimi / Kimi Coding Plan」）を選ぶ必要があります。これがGlobal Moonshot APIへの組み込みエントリーでもある、とドキュメントは説明しています。KIMI_API_KEYを求められたら、platform.kimi.aiで発行したキーを貼り付けます（Hermesは入力中マスク表示します）。

正しく接続できていれば、Hermesは次のように表示するはずだとガイドは示しています。

Using Moonshot endpoint → https://api.moonshot.ai/v1

モデル一覧にkimi-k3が出てこない場合は「Enter custom model name」を選び、kimi-k3と直接入力します。このときmoonshot/のようなプレフィックスを付けないよう、ガイドは注意書きを添えています。

手順2：完全な設定をYAMLに追記する

hermes config edit

で設定ファイルを開き、既存のcustom_providersリストにkimi-k3-globalという項目を追記します。ガイドが示しているスニペットは次のような構造です。

custom_providers:
  - name: kimi-k3-global
    base_url: https://api.moonshot.ai/v1
    key_env: KIMI_API_KEY
    api_mode: chat_completions
    model: kimi-k3
    extra_body:
      reasoning_effort: max
    models:
      kimi-k3:
        context_length: 1048576
        supports_vision: true

model:
  provider: custom:kimi-k3-global
  default: kimi-k3
  context_length: 1048576
  supports_vision: true

agent:
  reasoning_effort: max

context_length: 1048576は約100万トークン、supports_vision: trueはネイティブ視覚理解に対応していることを示すフラグです。ガイドは、既存のトップレベル設定セクションが既にある場合はフィールドを更新するだけにし、新規に重複作成しないこと、関係のない既存設定やカスタムプロバイダーは保持することを注意点として挙げています。

セキュリティ上の注意書き

ガイドには次のような警告も明記されています（原文からの訳）。

「APIキーをconfig.yaml・コマンド引数・スクリーンショット・Gitリポジトリに直接書かないこと。このガイドはGlobal Kimi Open Platformのキーを使う。他のKimiサービスや別リージョンのキーで代用しないこと」

「別リージョンのキーで代用しない」という一文は、Kimiが複数のリージョン向けプラットフォームを持っていることを示唆していますが、具体的にどのリージョンがあるのかは今回確認したページには記載がありませんでした。

正直に：Hermes Agentの日本語コミュニティ内で見えたもの

今回、Zennの検索APIで「Hermes Agent」を検索したところ、40本以上の記事がヒットしました。VPS構築連載、Discord連携、Obsidianとの統合、自己改善ループの実験記録など、切り口は多岐にわたっています。その中に「Hermes Agentを2日使って、GPT-5.6 Sol実装からClaude Opus 5レビューまで回してみた」という記事タイトルもありましたが、本文レベルでの確認はしておらず、Kimi K3への言及があるかどうかは分かりません。少なくとも検索結果に出てきたタイトル一覧の範囲では、Kimi・Moonshotへの言及を含む記事は見当たりませんでした。これは「無い」ことの証明ではなく、タイトル検索でヒットしなかった、という限定的な観測です。

また、Hermes Agent自体のバージョン履歴（v0.9.0からv0.18.2までの間に何が変わったか）は、今回Kimi側のドキュメントだけを確認しており、Nous Research公式のリリースノートは未確認です。Hermes Agent自体の全体像を知りたい場合は、日本語コミュニティに既に蓄積された記事群（VPS構築連載など）を参照するほうが情報量は多いはずです。

追記：ガイドの前提バージョンから、既に7回のマイナーアップデートが進んでいた

GitHub公式のReleasesページを確認すると、Kimi公式ガイドが前提とするv0.18.2（2026年7月7日）から、本記事執筆時点（2026年8月27日）までに少なくとも7回のリリースが出ていることが分かった。

最新のv0.20.6（2026年8月27日公開、teknium1氏によるタグ付け）は、直前のv0.20.5からの約8日間だけで「約525件のマージ済みPR、約1,313コミット、約1,557ファイルに影響（+177,113行／−21,682行）」という規模の変更を取り込んでいる、とリリースノートに明記されている。

さらに、このv0.20.6のリリースノートには次の記載があった。

Fireworks AI and DeepInfra land as first-class providers [...] and the model catalogs picked up GPT-5.6 (Sol/Terra/Luna + Pro variants, wired end-to-end across every route), grok-4.5 (GA), moonshotai/kimi-k3, claude-fable-5 / claude-sonnet-5, and GA tencent/hy3.

（Fireworks AIとDeepInfraが正式プロバイダーとして追加され[中略]モデルカタログには GPT-5.6（Sol/Terra/Luna＋Pro系統、全ルートに配線済み）、grok-4.5（GA）、moonshotai/kimi-k3、claude-fable-5／claude-sonnet-5、GA版tencent/hy3が加わった）

つまり、Kimiガイドが「モデル一覧にkimi-k3が出てこない場合はEnter custom model nameで手入力する」と案内していた回避策は、v0.20.6以降のHermes Agentではmoonshotai/kimi-k3がモデルカタログに標準搭載されたことで、不要になっている可能性が高い。この点はKimi側のガイド本文には反映されておらず、Hermes Agent側のリリースノートを突き合わせて初めて分かった食い違いだ。ただし、実際にv0.20.6の環境でhermes modelを実行し、モデル一覧にkimi-k3またはmoonshotai/kimi-k3がどう表示されるかまでは、本記事では検証していない。

関連記事

• Kimi（Moonshot AI）とは何か──全体像を整理
• Kimi K3の「Dynamic Tool Loading」
• Kimi Code CLIの中身