Skip to Content
ReferenceCLIコマンドconfig

config コマンド

configコマンドは、Kovaの設定を管理するためのコマンドです。デフォルトウォレット、カスタムRPCエンドポイントなどの設定を行うことができます。

構文

kova config <subcommand> [key] [value]

サブコマンド一覧

サブコマンド説明
set <key> <value>設定値を設定
list全設定を表示（i18n 対応の整形 + JSON 両対応）
profile listプロファイル一覧を表示（read-only）
profile show [name]プロファイル詳細を表示（read-only）

プロファイルの作成・切替・削除は CLI から直接行いません。kova init が単一プロファイルを自動生成・自動アクティブ化するため、運用中は list / show で内容を確認するだけに留めます（なぜ撤去したか）。

config set

設定値を設定します。設定はローカルに保存され、他のコマンドのデフォルト値として使用されます。

構文

kova config set <key> <value>

設定キー一覧

キー説明例
defaultWalletデフォルトウォレット名my-wallet
rpc.<chain>カスタムRPC URL（チェーン別）rpc.base = https://custom-rpc.example.com

使用例

デフォルトウォレットを設定:

kova config set defaultWallet my-wallet

出力例:

{
  "ok": true,
  "data": {
    "key": "defaultWallet",
    "value": "my-wallet"
  }
}

カスタムRPCエンドポイントを設定:

kova config set rpc.base https://custom-base-rpc.example.com

出力例:

{
  "ok": true,
  "data": {
    "key": "rpc.base",
    "value": "https://custom-base-rpc.example.com"
  }
}

重要な注意点

  1. RPCエンドポイント: 信頼できるRPCエンドポイントのみを設定してください。不正なエンドポイントは資産の損失につながる可能性があります。
  2. 設定の優先順位: コマンドラインオプション > 設定値 > デフォルト値の順で優先されます。

config list

すべての設定値を一覧表示します。config get は撤去されたため、単一キーの確認も本コマンドで行います。

構文

kova config list

オプション

このサブコマンドにはオプションはありません。出力モードは共通フラグ（--json / --pretty）と TTY 判定で決まります。

使用例

TTY (pretty mode, config.lang=ja):

kova config list
全般
  デフォルトアカウント : my-wallet
  表示言語             : ja
  Strict policy        : false

RPC エンドポイント
  base : https://custom-base-rpc.example.com

プロファイル (アクティブプロファイル: default)
  - default (アクティブ)
      アカウント     : my-wallet
      クレデンシャル : ows_key_abcd****

config.lang=en の場合は英語ラベルで同じ構造を表示します（General / Profiles 等）。

JSON mode (--json / 非 TTY):

{
  "ok": true,
  "data": {
    "config": {
      "defaultWallet": "my-wallet",
      "rpc": { "base": "https://custom-base-rpc.example.com" },
      "activeProfile": "default",
      "profiles": {
        "default": {
          "credential": "ows_key_abcd****",
          "wallets": ["my-wallet"]
        }
      }
    }
  }
}

設定が空の場合 (pretty):

(設定がありません — `kova init` でセットアップを始めてください)

credential のマスク

profiles.*.credential は pretty / JSON どちらでも先頭 12 文字 + **** の形で出力されます。生の credential は CLI 経由で取得できません。

よくあるエラーと対処法

CONFIG_NOT_FOUND

エラーメッセージ:

{
  "ok": false,
  "error": {
    "code": "CONFIG_NOT_FOUND",
    "message": "Profile \"unknown\" not found"
  }
}

対処法:

  • kova config list / kova config profile list で存在する profile / 設定キーを確認する
  • profile 名のスペルミスを確認する
  • profile が未作成の場合は、kova init でセットアップを実行する

INVALID_PARAMS

エラーメッセージ:

{
  "ok": false,
  "error": {
    "code": "INVALID_PARAMS",
    "message": "Invalid chain name 'invalid-chain'."
  }
}

対処法:

  • サポートされているチェーン名を使用する（base, ethereum, polygon, arbitrum, optimism, avalanche, sepolia, base-sepolia, polygon-amoy, fuji）
  • チェーン名は小文字で指定する

UNKNOWN_ERROR

エラーメッセージ:

{
  "ok": false,
  "error": {
    "code": "UNKNOWN_ERROR",
    "message": "Failed to write configuration file."
  }
}

対処法:

  • 設定ファイルのパーミッションを確認する（~/.kova/config.json）
  • ディスク容量を確認する
  • Kovaを再起動してみる

設定ファイル

設定は~/.kova/config.jsonに保存されます。通常、手動で編集する必要はありませんが、必要に応じて直接編集することもできます。

設定ファイルの例

{
  "defaultWallet": "my-wallet",
  "rpc": {
    "base": "https://custom-base-rpc.example.com",
    "ethereum": "https://custom-eth-rpc.example.com"
  }
}

実用的な設定例

開発環境の設定

テストネット用のウォレットをデフォルトに設定:

kova config set defaultWallet test-wallet

本番環境の設定

本番ウォレットをデフォルトに設定:

kova config set defaultWallet production-wallet

カスタムRPCの設定

プライベートRPCエンドポイントを使用:

kova config set rpc.base https://base-mainnet.infura.io/v3/YOUR_API_KEY
kova config set rpc.ethereum https://mainnet.infura.io/v3/YOUR_API_KEY

プロファイル管理 (config profile)

config profile は ~/.kova/config.json の profiles / activeProfile を閲覧するためのサブコマンド群です。プロファイル本体（credential / apiKeyId / wallets の組）は kova init が自動生成・自動アクティブ化するため、CLI からの作成・切替・削除コマンドは提供しません。

  • 公開: profile list / profile show（どちらも read-only）
  • 撤去: profile create / profile switch / profile remove

撤去の根拠は次のとおりです。

  • ベータ版は単一ウォレット制（packages/cli/src/commands/init.ts の singleWalletOnly）
  • agent key 名は ADR-040 で default 固定。1 wallet あたり 1 agent key = 1 profile に集約されるため切替の出番がない
  • credential を含む profile 操作は init / key rotate 経由でのみ発生する設計に統一

config profile list

すべてのプロファイル一覧を表示します（read-only）。

kova config profile list

出力例:

{
  "ok": true,
  "data": {
    "profiles": [
      {
        "name": "default",
        "active": true,
        "wallets": ["wallet-xxx"],
        "policyId": null,
        "description": null
      },
      {
        "name": "my-agent",
        "active": false,
        "wallets": ["wallet-xxx"],
        "policyId": "pol_xxx",
        "description": "Trading agent"
      }
    ],
    "activeProfile": "default"
  }
}

config profile show

アクティブプロファイル、または指定プロファイルの詳細を表示します（read-only）。credential フィールドは先頭 12 文字 + **** の形でマスクされます。

kova config profile show           # アクティブプロファイル
kova config profile show my-agent  # 指定プロファイル

出力例:

{
  "ok": true,
  "data": {
    "name": "my-agent",
    "active": false,
    "credential": "kova_a1b2c3d4****",
    "apiKeyId": "key-xxx",
    "wallets": ["wallet-xxx"],
    "policyId": "pol_xxx",
    "description": "Trading agent"
  }
}

プロファイルの再生成・削除

CLI からの直接操作は提供しません。再生成・撤去は次のフローで行います。

  • wallet を完全に作り直したい: 設定ディレクトリ ~/.kova/ をバックアップ後に削除 → kova init を再実行
  • agent key を更新したい: kova key rotate --name default（同名 key を再発行し旧 key を revoke する純粋な置換）
  • credential だけ消したい（agent → owner 復帰）: kova config set credential ''

OWS 側の API key をローテーションしたい場合は kova key rotate を使ってください。

プロファイルの構造

設定ファイル内では次の形で保存されます。

{
  "profiles": {
    "my-agent": {
      "credential": "kova_xxx...",
      "apiKeyId": "key-xxx",
      "wallets": ["wallet-xxx"],
      "policyId": "pol_xxx",
      "description": "Trading agent"
    }
  },
  "activeProfile": "my-agent"
}

wallets は配列、policyId は単数形（複数のポリシーを束ねる仕組みは現状ありません）。

セキュリティ上の注意

  • credential は平文で保存されるため、~/.kova/config.json のパーミッションは 600（所有者のみ読み書き）に保つ
  • 不要になった profile を捨てたいときは、対応する OWS 側 API key を kova key rotate でローテーションしてから別 wallet で kova init をやり直す
  • 残った CLI 書き込み操作 (config set) は owner-only で、agent モード（非 TTY）からは INTERACTIVE_INPUT_REQUIRED で拒否されます（OperationKind 分類）

関連コマンド

  • wallet - ウォレットを作成・管理
  • balance - 残高を確認（デフォルトウォレット・チェーンを使用）
  • send - 送金（デフォルトウォレット・チェーンを使用）
  • key - API鍵を管理（デフォルトウォレットを使用）
  • init - エージェント用プロファイルの自動生成
  • launch - アクティブプロファイルの credential を環境変数として注入してエージェントを起動

次のステップ

  • デフォルト設定後: 残高確認で--nameや--chainオプションを省略してみましょう
  • ウォレット管理: walletでウォレットを作成・管理しましょう
  • AIエージェント統合: AIエージェント統合ガイドでスキル経由の設定管理を学びましょう
  • セキュリティ: カスタムRPCを使用する場合は、セキュリティガイドを確認しましょう
Last updated on
delegatetoken