Back to Details

onboarding

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Onboarding Skill

入职Skill

Automates first-hour setup for AIBTC agents with practical, idempotent steps and explicit safety defaults.
为AIBTC Agent自动化首小时设置流程，采用幂等性步骤与明确的安全默认配置。

Usage

使用方法

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

Subcommands

子命令

doctor

doctor

Run onboarding diagnostics and return actionable next steps.
Checks include:
  • wallet presence + lock status
  • AIBTC registration verification (
    /api/verify/<stxAddress>
    )
  • heartbeat endpoint reachability (
    /api/heartbeat?address=<btcAddress>
    )
  • optional community step target (
    https://www.moltbook.com/m/aibtc
    )
bash
bun run onboarding/onboarding.ts doctor
运行入职诊断并返回可执行的后续步骤。
检查内容包括：
  • 钱包存在性及锁定状态
  • AIBTC注册验证（
    /api/verify/<stxAddress>
    ）
  • 心跳端点可达性（
    /api/heartbeat?address=<btcAddress>
    ）
  • 可选社区步骤目标（
    https://www.moltbook.com/m/aibtc
    ）
bash
bun run onboarding/onboarding.ts doctor

install-packs

install-packs

Preview or install curated skill packs.
Packs:
  • core
    : wallet, settings, signing, query, credentials
  • builder
    : x402, bns
  • finance
    : bitflow, defi (mainnet write-capable)
  • all
    : core + builder + finance
Preview only:
bash
bun run onboarding/onboarding.ts install-packs --pack core
Execute install:
bash
bun run onboarding/onboarding.ts install-packs --pack builder --run
预览或安装精选技能包。
技能包包括：
  • core
    ：钱包、设置、签名、查询、凭证
  • builder
    ：x402、bns
  • finance
    ：bitflow、defi（支持主网写入）
  • all
    ：core + builder + finance
仅预览：
bash
bun run onboarding/onboarding.ts install-packs --pack core
执行安装：
bash
bun run onboarding/onboarding.ts install-packs --pack builder --run

run

run

Execute the first-hour onboarding flow with optional registration and heartbeat check-in.
bash
bun run onboarding/onboarding.ts run \
  --wallet-password <password> \
  --pack core \
  --install \
  --register \
  --check-in
Options:
  • --wallet-password
    (optional) — auto-unlock wallet when needed (less secure: process args)
  • --wallet-password-env
    (optional) — environment variable name that stores wallet password (default: 
    AIBTC_WALLET_PASSWORD
    )
  • --register
    (flag) — attempt AIBTC registration if not registered
  • --check-in
    (flag) — submit heartbeat check-in after diagnostics
  • --pack
    (optional) — 
    core | builder | finance | all
    (default: 
    core
    , invalid values error)
  • --install
    (flag) — install selected pack(s)
  • --skip-community
    (flag) — skip optional Moltbook 
    /aibtc
    recommendation
执行首小时入职流程，可选包含注册和心跳签到步骤。
bash
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
    推荐步骤

Safety + Best Practices

安全与最佳实践

  • Wallet unlock is explicit and never inferred.
  • Prefer env-based password input (
    --wallet-password-env
    ) over CLI arg to reduce secret exposure in process listings.
  • Finance pack is optional and never auto-enabled by default.
  • Community step is non-blocking (safe skip if unavailable).
  • Output is JSON with step-by-step status to support autonomous loops.
  • 钱包解锁为显式操作，绝不会自动推断。
  • 优先使用基于环境变量的密码输入方式（
    --wallet-password-env
    ）而非CLI参数，以减少进程列表中的密钥暴露风险。
  • Finance技能包为可选配置，默认不会自动启用。
  • 社区步骤为非阻塞式（若不可用可安全跳过）。
  • 输出为JSON格式，包含分步状态，支持自主循环执行。

Suggested First Run

推荐首次运行流程

bash
undefined
bash
undefined

1) Inspect current state

1) 检查当前状态

bun run onboarding/onboarding.ts doctor
bun run onboarding/onboarding.ts doctor

2) Install safe defaults

2) 安装安全默认配置

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

3) Complete bootstrap

3) 完成引导流程

bun run onboarding/onboarding.ts run --wallet-password <password> --register --check-in
undefined
bun run onboarding/onboarding.ts run --wallet-password <password> --register --check-in
undefined