onboarding

オンボーディングスキル

実用的で冪等な手順と明示的な安全性のデフォルト設定により、AIBTC エージェントの初回セットアップを自動化します。

使用方法

bun run onboarding/onboarding.ts <subcommand> [options]

サブコマンド

doctor

オンボーディングの診断を実行し、実行可能な次の手順を返します。

チェック項目：

• ウォレットの有無とロック状態
• AIBTC 登録の確認（/api/verify/<stxAddress>）
• ハートビートエンドポイントへの到達性（/api/heartbeat?address=<btcAddress>）
• オプションのコミュニティステップの対象（https://www.moltbook.com/m/aibtc）

bun run onboarding/onboarding.ts doctor

install-packs

厳選されたスキルパックをプレビューまたはインストールします。

パック：

• core：ウォレット、設定、署名、クエリ、認証情報
• builder：x402、bns
• finance：bitflow、defi（メインネットで書き込み可能）
• all：core + builder + finance

プレビューのみ：

bun run onboarding/onboarding.ts install-packs --pack core

インストールを実行：

bun run onboarding/onboarding.ts install-packs --pack builder --run

run

登録とハートビートのチェックインを任意で行い、初回1時間のオンボーディングフローを実行します。

bun run onboarding/onboarding.ts run \
  --wallet-password <password> \
  --pack core \
  --install \
  --register \
  --check-in

オプション：

• --wallet-password（任意）— 必要に応じてウォレットを自動ロック解除します（安全性は低下します：プロセス引数に含まれます）
• --wallet-password-env（任意）— ウォレットパスワードを保存する環境変数名（デフォルト：AIBTC_WALLET_PASSWORD）
• --register（フラグ）— 未登録の場合、AIBTC への登録を試みます
• --check-in（フラグ）— 診断後にハートビートのチェックインを送信します
• --pack（任意）— core | builder | finance | all（デフォルト：core、無効な値はエラー）
• --install（フラグ）— 選択したパックをインストールします
• --skip-community（フラグ）— オプションの Moltbook /aibtc の推奨事項をスキップします

安全性とベストプラクティス

• ウォレットのロック解除は明示的に行い、推測で実行することはありません。
• プロセス一覧での秘密情報の露出を減らすため、CLI 引数より環境変数によるパスワード入力（--wallet-password-env）を優先してください。
• finance パックは任意であり、デフォルトで自動的に有効になることはありません。
• コミュニティステップはブロッキングではありません（利用できない場合は安全にスキップできます）。
• 出力は JSON 形式で、各ステップの状態が含まれ、自律的なループをサポートします。

推奨される初回実行

# 1) Inspect current state
bun run onboarding/onboarding.ts doctor

# 2) Install safe defaults
bun run onboarding/onboarding.ts install-packs --pack core --run

# 3) Complete bootstrap
bun run onboarding/onboarding.ts run --wallet-password <password> --register --check-in