senpi-entrypoint

Senpi エージェントのエントリーポイント

モジュール式スキルを通じて、Hyperliquid 上の Senpi 取引プラットフォームに AI エージェントをオンボーディングします。アカウントのセットアップ、スキルの検出、取引戦略を扱います。

プラットフォームの概要（ウォレット、戦略、ツールのカテゴリ、手数料）については、 references/about-senpi.mdを参照してください。

npx コマンドが失敗した場合は、 references/error-handling.mdで復旧手順を確認してください。

環境変数のデフォルト値

変数	プレースホルダー	デフォルト値
SENPI_MCP_ENDPOINT	{{SENPI_MCP_ENDPOINT}}	https://mcp.prod.senpi.ai
REFERRAL_CODE	{{REFERRAL_CODE}}	(空 — 任意)

プレースホルダーが文字どおりの {{...}} 文字列として現れる場合（置換されていない場合）は、上の表のデフォルト値を使用してください。

---

エージェントの動作

重要：出力するすべての言葉は、ユーザーに直接表示されます。 内部チャンネルはありません。すべての手順を黙って実行してください。説明や状況報告、推論は出力しないでください。出力してよいテキストは、ステップ 2 の最後のウェルカムメッセージのみです。

ツール呼び出しの間は、テキストを一切出力しないでください。単語ひとつも出力してはいけません。

禁止事項 — 次の内容は絶対に書かないでください。

• 「状態が空です／READY ではありません／FRESH です／ONBOARDING です……」、「状態は……です」など、内部状態に関する内容
• 「では……します」、「次に……します」、「確認します」、「取得します」、「読み込みます」
• 「トークンが設定されています……」、「ステップ 1 をスキップしています……」、「次のステップに進みます……」、「BOOTSTRAP.md に従って……」
• 「これで……が分かりました」、「すでに……を把握しています」、「今……を把握しています」
• 「よし……」、「すばらしい……」、「OK……」、「了解……」
• 内部ステップ、ファイルパス、状態値、ツール名、今後の手順への言及
• ツールの応答内容、見つかったもの、見つからなかったものに関する所見

何かを書こうとしていることに気付いたら、そこで止めてください。代わりに、次の手順を黙って実行してください。

---

応答前チェック（このスキルを呼び出すたびに実行）

このスキルでどのようなクエリに応答する場合も、応答前に references/skill-update-checker.md の「Pre-Response Invocation Check」セクションにある必須の呼び出しチェックを、呼び出しごとに 1 回だけ実行してください。その後のすべての応答コントラクトでは、取得した UPDATE_OUTPUT を再利用してください。 同じ呼び出し内で、このチェックを再度実行しないでください。

Arena の意図に関する必須ゲート： ユーザーのメッセージに「arena」、「agents arena」、「competition」、「prize pool」、「qualify」、「qualification」、「weekly cycle」、「weekly competition」のいずれかが含まれる場合は、回答を作成する前に read_senpi_guide(uri="senpi://guides/arena") を呼び出してください。Arena に関する質問では、ウェブ検索やリーダーボードのデータを使用しないでください。詳しいルーティングルールについては、references/post-onboarding.mdを参照してください。

---

初期チェック：認証済みの場合に限りステップ 1 をスキップ

ステップ 1 の前に、マシンで Senpi API キーがすでに利用可能か確認してください。

if [ -n "${SENPI_AUTH_TOKEN}" ]; then
  # Optional: verify MCP responds (e.g. call a read-only tool)
  # If verification fails, clear or ignore and continue to Step 1
  echo "SENPI_AUTH_TOKEN is set; skipping Step 1 only. You MUST still run Step 2, then Step 3, then Step 4."
  SKIP_ONBOARDING=true
else
  SKIP_ONBOARDING=false
fi

• SENPI_AUTH_TOKEN が設定されており、（任意で）MCP が応答する場合： ステップ 1：オンボーディングのみをスキップしてください。それでも必ずステップ 2：ウェルカム（ウェルカムメッセージを表示して 3 つの選択肢を提示）、続いてステップ 3：ガイド、ステップ 4：拡張を実行してください。「トークンが設定されている」ことを「オンボーディング完了 — 何もしない」と解釈してはいけません。
• SENPI_AUTH_TOKEN が未設定または空の場合： 通常どおりステップ 1：オンボーディングに進んでください。

初期チェックの後は、次のステップフローに従ってください：ステップ 1（スキップされない場合）→ ステップ 2（必ず実行） → ステップ 3 → ステップ 4。

---

ステップ 1：オンボーディング

このステップを実行するのは、 SENPI_AUTH_TOKEN が設定されていない場合のみです（つまり、SKIP_ONBOARDING が false の場合です）。初回確認でここをスキップした場合は、ステップ 2 に進んでください。

オンボーディングスキルをインストールします。

npx skills add https://github.com/Senpi-ai/senpi-skills --skill senpi-onboard -g -y

senpi-onboard スキルの指示を読み込み、それに従います。次のコンテキストを渡してください。

• SENPI_MCP_ENDPOINT: {{SENPI_MCP_ENDPOINT}}
• REFERRAL_CODE: {{REFERRAL_CODE}}

ゲート — 次に進む前に確認してください：

1. Senpi アカウントが存在する
2. API キーが生成されている
3. MCP サーバーが設定され、ツール呼び出しに応答する

---

ステップ 2：ウェルカム

このステップは必ず実行します： ステップ 1 の完了後、または初回確認で SENPI_AUTH_TOKEN が設定されていることが判明した場合は、直ちに実行します。

post-onboarding.md の Post-Onboarding Welcome セクションにあるウェルカムメッセージを送信します。残高や入金に関する文言は追加しないでください。まだ残高データがなく、ステップ 2.5 で取得して適切な入金案内を提示します。3 つの選択肢と Agents Arena の行を含むウェルカムテンプレート全体を提示し、ユーザーの応答を待ってください。

停止してください。ここで戦略カタログを表示してはいけません。 カタログを表示するのは、ユーザーが明示的に求めた場合のみです（同じオンボーディング後のリファレンスにある Strategy Catalog を参照）。カタログを表示する際は、必ず次の場所から動的に取得してください。

curl -s https://raw.githubusercontent.com/Senpi-ai/senpi-skills/refs/heads/main/catalog.json

スキル名をハードコードしたり、npx skills add --list を使用したりしてはいけません。

ゲート — 次に進む前に確認してください： ユーザーがウェルカムメッセージを確認し、進む方法を選択していること。

---

ステップ 2.5：入金状況の確認

このステップは必ず実行します。 ステップ 2 の後、ステップ 3 の前に、account_get_portfolio を呼び出してユーザーの現在の残高を取得してください。これは目立たないように実行し、ツール呼び出しについて説明しないでください。

• 合計残高（すべてのウォレットの合計）が >= $100 の場合：残高の概要をユーザーに提示し、資金があり取引を開始できることを伝えます。どのカタログスキルが利用可能か（例：min_budget <= balance のスキル）、またはどのスキルにはさらに資金が必要か（min_budget > balance）を任意で伝えてください。ステップ 3 に進みます。
• 合計残高が < $100 の場合：現在の残高と、Senpi エージェントウォレットのアドレス（~/.config/senpi/state.json → account.agentWalletAddress または wallet.address から読み取る）をユーザーに伝え、取引を開始するには少なくとも $100 USDC が必要であることを説明してください。対応チェーンとして Base、Arbitrum、Optimism、Polygon、Ethereum を伝えてください。入金後に利用可能になるカタログスキルを（同じ min_budget と残高の比較ロジックを使って）任意で伝えてください。そのままステップ 3 に進みます。
• MCP 呼び出しに失敗した場合：通知を行わずにスキップし、入金案内を提示せずにステップ 3 に進みます。

---

ステップ 3：ガイド（任意）

ユーザーに次のように尋ねます。

「Senpi での取引方法を学びたいですか？インタラクティブなガイドで、最初の取引をお手伝いできます。」

ユーザーが同意した場合は、Senpi の入門ガイドをインストールします。

npx skills add https://github.com/Senpi-ai/senpi-skills --skill senpi-getting-started-guide -g -y

ガイドスキルがまだ利用できない場合は、代わりに次の操作を提案してください。

• 「ポートフォリオを確認する」（account_get_portfolio ツールを使用）
• 「トップトレーダーを見つける」（discovery_get_top_traders ツールを使用）
• 「市場データを表示する」（market_get_prices ツールを使用）

---

ステップ 4：拡張（ユーザー主導）

ユーザーの関心に応じて、追加の取引スキルを必要に応じてインストールします。

npx skills add https://github.com/Senpi-ai/senpi-skills --skill <skill-name> -g -y

例：

npx skills add https://github.com/Senpi-ai/senpi-skills --skill hedgehog -g -y

オンボーディングは完了です。これでエージェントは Senpi の取引ツールキットを利用でき、必要に応じてスキルを追加でインストールできます。

---

ステップ 5：バックグラウンドのスキル更新チェッカーをインストール

このステップでのエージェントの動作については、references/skill-update-checker.md（§「Step 5 Agent Behaviour」）を参照してください。

ステップ 4 の完了後にこのステップを実行してください。これにより、配信を行わず、分離されたセッションでスキル更新チェッカーを実行する、毎日の OpenClaw cron ジョブが登録されます。エージェントはスクリプトを実行して返信せずに終了します。結果は次回のセッション開始時までキューに保存されます。

スクリプトの場所を確認

SENPI_ENTRYPOINT_SCRIPTS=$(node -e "
  const path = require('path'), os = require('os'), fs = require('fs');
  const p = path.join(os.homedir(), '.agents', 'skills', 'senpi-entrypoint', 'scripts');
  console.log(fs.existsSync(path.join(p, 'check-skill-updates.py')) ? p : '');
" 2>/dev/null)

SENPI_ENTRYPOINT_SCRIPTS が空の場合、スキルがグローバルにインストールされていません （npx skills add ... -g）。この手順は何も表示せずにスキップしてください。openclaw が PATH で利用できない場合も、この手順は何も表示せずにスキップしてください。

OpenClaw の cron をインストール（冪等）

if [ -n "$SENPI_ENTRYPOINT_SCRIPTS" ] && command -v openclaw >/dev/null 2>&1; then
  openclaw cron remove "senpi-skill-update-check" 2>/dev/null || true
  SCRIPT_PATH="$SENPI_ENTRYPOINT_SCRIPTS/check-skill-updates.py"
  openclaw cron add "senpi-skill-update-check" \
    --schedule "0 0 * * *" \
    --no-deliver \
    --message "Run this command with no output or reply: python3 \"$SCRIPT_PATH\" --cron. Then exit. Do not deliver or announce anything."
fi

ジョブは $OPENCLAW_STATE_DIR/cron/jobs.json に保存されます（OPENCLAW_STATE_DIR が設定されていない場合のデフォルトは ~/.openclaw/cron/jobs.json です）。毎日 00:00 UTC に 1 回実行されます。更新が見つかった場合、スクリプトは $SENPI_STATE_DIR/pending-skill-updates.json に書き込みます（SENPI_STATE_DIR が設定されていない場合のデフォルトは ~/.config/senpi/pending-skill-updates.json です）。次回の呼び出し時に、上記の 応答前チェック を通じて通知されます。

---

スキル更新通知をオンまたはオフにする

ユーザーから通知をオフまたは再度オンにするよう依頼された場合は、 references/skill-update-checker.md の手順に従ってください。

---

質問への回答

必須の応答契約（実行は任意ではありません）

要約または Q&A に回答する場合は、 references/about-senpi.md の（Summary Response Contract および Mandatory Invocation Procedure セクションに記載された）手順に従ってください。 上記の最上位の Pre-Response Check で生成された UPDATE_OUTPUT を使用してください。 この呼び出し中にまだ実行されていない場合を除き、ここで Pre-Response Invocation Check を再実行しないでください。 これらの手順を満たすまでは、回答が完了したとみなさないでください。

「Senpi とは何ですか？」／「Senpi を要約してください」／「スキルと機能を要約してください」／「スキルをインストールするには？」／「新着情報は？」

これは明示的に尋ねられた場合のみです。通常のオンボーディング手順にこの要約を自動で挿入しないでください。

質問された場合は、 references/about-senpi.md を読み込み、順序、詳しさ、コマンドの動作について Summary Response Contract セクションに従ってください。

「どのスキルをインストールすればよいですか？」／「［目標］には何を使えばよいですか？」

目標とスキルの対応表、予算に関するガイダンス、インストールコマンドについては、 references/skill-recommendations.md を参照してください。

---

参照ファイル

ファイル	目的
scripts/check-skill-updates.py	日次のバックグラウンドチェッカー（--cron を指定して cron 経由で実行）。Vercel skills CLI のロックファイルを読み込み、GitHub のツリー SHA と比較して、バージョン更新や新しいスキルを保留ファイルに書き込みます
references/skill-update-checker.md	起動時の出力処理、通知のオン／オフ、cron の管理
references/skill-recommendations.md	目標とスキルの対応表、予算に関するガイダンス、インストールコマンド
references/about-senpi.md	Senpi の要約情報源：Senpi の概要、機能、箇条書きによる全項目のカタログ、ユーザー向けのインストール手順、新着情報に関するガイダンス
references/error-handling.md	npx コマンドの失敗からの復旧手順