Skip to Content
Getting Startedインストール

インストール

@komlock_lab/kova を public npm レジストリ（registry.npmjs.org ）からインストールする手順です。

前提条件

  • 対応 OS: macOS (Intel / Apple Silicon)、Linux glibc (x64 / arm64)
  • Node.js 20 以上 — ダウンロード 
  • pnpm 10 以上（推奨） — npm install -g pnpm
  • AI エージェント機能を使う場合は Claude Code CLI （claude を起動して Kova のスキルを呼び出すため）

⚠️ Windows および Alpine Linux (musl) は非対応です。 Windows では WSL2 をご利用ください。

バージョン確認:

node --version  # v20.0.0 以上
pnpm --version  # 10.0.0 以上

CLI のインストール

public npm から取得

npm install -g @komlock_lab/kova

認証は不要です。

動作確認

kova --help
kova --version

Skills のインストール

AI エージェント（Claude Code、GPT、Gemini 等）にウォレット機能を組み込む場合にインストールします。kova init の Step 3/4 でも自動的にスキルが取得されます。手動で追加・更新したい場合は次のコマンドを使います。

kova skills install
kova skills update
kova skills list

詳細は skills リファレンス を参照してください。

主要なスキル:

  • create-wallet — ウォレット作成と管理
  • check-balance — 残高確認
  • send-tokens — トークン送信
  • setup-agent — エージェントキー発行フローを自動化
  • manage-config — 設定管理

動作確認

CLI が正しくインストールされたか確認します。

# バージョン確認
kova --version
 
# ヘルプ
kova --help

kova init を走らせればフルセットアップに進みます。詳細は クイックスタート を参照してください。

次のステップ

トラブルシューティング

pnpm が見つからない

症状: pnpm: command not found

解決策:

npm install -g pnpm

kova launch claude が claude バイナリを見つけられない

症状: UNKNOWN_ERROR: claude binary not found. Install Claude Code first.

解決策:

Claude Code  をインストールし、claude --version が PATH 上で動くことを確認してください。kova launch <agent> は stdio: 'inherit' で エージェントプロセスを spawn する設計です。

kova init で INTERACTIVE_INPUT_REQUIRED が出る

CI 等の非 TTY 環境では init は動きません。owner-only 操作のため、対話可能な端末で実行してください（OperationKind 分類）。

Last updated on
ユースケースクイックスタート