Section 3: VS Code・OpenClawをインストールする

💡 APIとは何か？ — なぜ必要なのか

AIエージェントは、行動する前に考える必要があります。

エージェントが状況を分析し、レポートを書き、判断を下すたびに、AIモデルを呼び出して思考処理を行います。APIはその呼び出しを行うチャンネルであり、エージェントを動かす燃料です。

チャットAI と API — 2つの別物：

	チャットAI（Claude / Gemini / ChatGPT）	API
何か	あなた専用のコンシェルジュ	エージェントの思考エンジン
誰が使うか	あなたが直接	エージェントが自動で
料金モデル	サブスク（定額）	従量課金（入力+出力トークン）
推奨	課金プラン推奨（推論の質が上がる）	まず$5クレジットから

なぜ両方使うのか？（ハイブリッド運用）

APIはインプット（入力）＋アウトプット（出力）のトークン数で料金が発生します。エージェントに送るすべての言葉、エージェントが返すすべての言葉がわずかなコストになります。

つまり、エージェントへの指示の質がコストに直結します。

チャットAI（Claude・Gemini・ChatGPT — 推論の質を上げるため課金プラン推奨）を使って：

エージェントに渡す前に、明確で簡潔な指示を先に作る
長いドキュメントを要約してからエージェントに渡す
タスクを事前に整理して、エージェントが「何をすべきか」で迷うトークンを省く

よく整理された200トークンの指示は、曖昧な2,000トークンのやりとりの何分の一かのコストで済みます。 チャットAIが戦略家。エージェントが実行者。 この組み合わせがAPI料金を抑えながら、高品質なアウトプットを実現します。

はじめる前に — APIコストについて正直にお伝えします

BALIA OSはエージェントを動かすためにAI APIキーが必要です。これはガイド代$48とは別のコストです。

必要なもの：

Anthropicアカウント（最低$5のプリペイドクレジット）
このガイドの全エージェントはClaude Sonnet 4.6を使用します

なぜ$5で始められるか： Claude Sonnet 4.6は100万トークンあたり$3（入力）/$15（出力）です。通常のエージェントセッションは数千トークン程度なので、$5で数十回のセッションを試すことができます。

Anthropic APIに無料枠はありません。 クレジットカード登録が必要です。クレジット追加：console.anthropic.com → Billing → Add credits（最低$5）

これがBALIA OSを動かすために必要な唯一の外部コストです。比較してみましょう：人間のアシスタントを1人雇うと月$2,000〜$5,000かかります。 AIチームなら$5のAPIクレジットで動き始めます。同じ仕事を、わずかなコストで。

インストールするもの

このセクションを終えると、以下の4つが揃います：

VS Code — エージェントファイルの編集とコマンド実行のワークスペース
Node.js — OpenClawの実行に必要
OpenClaw — BALIA OSを動かすAIエージェントフレームワーク
Anthropic APIキー — 各エージェントが思考に使うAIエンジン

このセクションの進め方： 以下のプロンプトをClaude・ChatGPT・Geminiにコピーして貼り付けてください。AIがインストール全体をガイドします。お使いのOSを聞いてきて、各ステップを順番に案内し、エラーが出た場合は一緒に解決してくれます。途中で詰まったら、そのままAIに状況を伝えるだけで大丈夫です。

▶ AIに貼り付けて始める

あなたはBALIA OS（OpenClaw上で動作するマルチエージェントAIオペレーティングシステム）の
インストールと初期設定を手伝っています。

ステップバイステップで案内してください。一度にひとつの質問だけをして、
私の回答を待ってから次に進んでください。
エラーが出た場合は、解決してから次のステップに進んでください。

以下の順番でインストールと設定を行います：

STEP 1 — OSの確認
「WindowsとMacのどちらをお使いですか？」と聞いてください。
以後のすべてのステップで、私のOSに合った手順を案内してください。

STEP 2 — VS Codeのインストール
code.visualstudio.com からVS Codeをインストールするよう案内してください。
- Windows：インストーラーをダウンロードして実行。「PATHへの追加」にチェックを入れること。
- Mac：ダウンロード・解凍・Applicationsフォルダにドラッグ後、
  Cmd+Shift+P → 「Shell Command: Install 'code' command in PATH」を実行。
インストール後、VS Codeのターミナルを開いて以下を実行するよう伝えてください：
  code --version
結果を聞いてください。エラーが出た場合は解決を手伝ってください。

STEP 3 — balia-osフォルダの作成
VS Codeのターミナルを使ってBALIA OSのメインフォルダを作成するよう案内してください。
- Windows：mkdir C:\Users\%USERNAME%\balia-os
           code C:\Users\%USERNAME%\balia-os
- Mac：    mkdir ~/balia-os
           code ~/balia-os
「ここがすべてのファイルを置く場所になります。
このパスはガイド全体を通じて使うので、メモしておいてください。」と伝えてください。
フォルダがVS Codeで開いたことを確認してから次に進んでください。

STEP 4 — Node.jsのインストール
nodejs.org からNode.js 22以上（LTSバージョン）をインストールするよう案内してください。
インストール後、以下を実行するよう伝えてください：
  node --version
結果を聞いてください。
- v22以上が表示された場合：次に進む。
- v22未満の場合：nvm（Mac/Linux）またはnvm-windows（Windows）を使って
  アップグレードするよう案内する。
- エラーの場合：トラブルシューティングを手伝う。

STEP 5 — OpenClawのインストール
VS Codeのターミナルで以下を実行するよう案内してください：
  npm install -g openclaw
確認：
  openclaw --version
よくあるエラーへの対応：
- MacでEACCESエラー：npm グローバルプレフィックスの修正を案内する
- 「openclaw not found」：ターミナルを閉じて再度開き、もう一度試すよう伝える

STEP 6 — Anthropic APIキーの取得
まず以下を説明してください：
「BALIA OSはデフォルトのAIエンジンとしてClaude（Anthropic）を使います。
今はClaudeだけ設定します。他のAIエンジンは後から用途に合わせて追加できます：
- Section 6で自分のカセットを構築するとき、そのカセットに最適なAIを選びます。
  たとえばYouTubeならGemini（動画を直接分析できる）、
  営業・アウトリーチ系ならGPT-4oが向いています。
  Google系サービスをよく使う場合はGemini一択といえるほど相性が良いです。
- BALIAスキルマーケットが公開された後は、他のユーザーが作ったカセットを
  購入・インストールすることもできます。その際に必要なAIキーも案内されます。
デフォルトではカセットは含まれていません。Section 6で自分のビジネスに
合ったカセットを一緒に構築します。」

その後、以下の手順を案内してください：
1. console.anthropic.com にアクセス
2. サインアップまたはログイン
3. API Keys → Create Key をクリック
4. 名前を「balia-os」にする
5. キーをコピー（sk-ant- で始まる）
「安全な場所に保存してください — 表示されるのは一度だけです。」と伝えてください。
キーを持っていることを確認してから次に進んでください。
キーをチャットに貼り付けるよう求めないでください。
STEP 7 — OpenClawの初期設定
VS Codeのターミナルで以下を実行するよう案内してください：
  openclaw setup
何が起きるかを説明してください：
- Anthropic APIキーを聞かれる — そこで貼り付ける
- ~/.opengoat/ のフォルダ構成が作成される
- OpenClaw gatewayが起動する
設定後、以下が表示されることを確認するよう伝えてください：
  「✓ Gateway running on port 18789」
このターミナルタブは開いたままにして、今後のコマンドは新しいタブで実行するよう伝えてください。

STEP 8 — 各エージェントのworkspaceフォルダ作成
「Section 2で作ったチーム設計ドキュメントを添付してください。
エージェントIDを自動で読み取ります。」と伝えてください。
添付されたチーム設計ドキュメントを読んでください。
6人のエージェント名/IDを抽出し（小文字・スペースなしに変換）、
以下のように一覧を表示して確認してください：
「6人のエージェントを確認しました：[id1]・[id2]・[id3]・[id4]・[id5]・[id6]
これで合っていますか？」
私の確認を待ってから、実際のIDをすべて埋めた状態でコマンドを案内してください：
- Windows：cd C:\Users\%USERNAME%\.opengoat
           mkdir workspace-[id1] workspace-[id2] workspace-[id3] workspace-[id4] workspace-[id5] workspace-[id6]
- Mac：    cd ~/.opengoat
           mkdir workspace-[id1] workspace-[id2] workspace-[id3] workspace-[id4] workspace-[id5] workspace-[id6]

STEP 9 — .envファイルの作成
balia-osフォルダの中に.envファイルを作成するよう案内してください。
VS Codeで：左パネルのbalia-osフォルダを右クリック →
新しいファイル → ファイル名を.envにする
以下のテンプレートを貼り付けるよう伝えてください：

# BALIA OS
BALIA_TOKEN=ここに購入トークンを貼り付け
AGENT_ID=ここにメインエージェントのIDを入力
BALIA_OS_PATH=~/balia-os

# Anthropic API
ANTHROPIC_API_KEY=sk-ant-あなたのキーをここに貼り付け

# エージェントモデル
CLAUDE_MODEL=claude-sonnet-4-6

# Discord Webhook — Section 4のDiscord設定時に入力
# 例: DISCORD_WEBHOOK_MAYA=https://discord.com/api/webhooks/123456789/xxxxxxxxxxxx
DISCORD_WEBHOOK_[AGENT1NAME]=
DISCORD_WEBHOOK_[AGENT2NAME]=
DISCORD_WEBHOOK_[AGENT3NAME]=
DISCORD_WEBHOOK_[AGENT4NAME]=
DISCORD_WEBHOOK_[AGENT5NAME]=
DISCORD_WEBHOOK_SECURITY=

BALIA_TOKENの入力方法を伝えてください：
「購入後に届いたメールを確認してください。
件名に「Your BALIA OS Access Token」と書かれたメールです。
そのメールを開いて、BALIA-から始まるトークンをコピーし、
BALIA_TOKEN= の後に貼り付けてください。
入力はこの1回だけです —
Section 6のインストーラーがこのファイルから自動で読み込みます。
チャットには貼り付けないでください。」

AGENT_IDの入力方法を伝えてください：
「これはあなたが一番よく話しかけるメインエージェントのIDです。
Section 2のチーム設計ドキュメントで決めたIDです。
小文字・スペースなしで入力してください。例：maya、alex、ceo
このIDはインストールスクリプトが使うので、
Section 2で決めたIDと完全に一致させてください。」

BALIA_OS_PATHの入力方法を伝えてください：
「STEP 3で作成したフォルダのパスです。
- Windowsの場合：~/balia-osをC:/Users/あなたの名前/balia-osに変更してください
- Macの場合：~/balia-osのままでOKです
Section 5でエージェントを起動するときにこのパスを使います。」

「今は空欄のままで大丈夫です — Section 4で実際のURLを取得します。
URLの形式は: https://discord.com/api/webhooks/数字/文字列
[AGENT1NAME]〜[AGENT5NAME]を実際のエージェント名の大文字表記に置き換えてください。
DISCORD_WEBHOOK_SECURITYは最後の行 — セキュリティエージェント用です。」と伝えてください。

セキュリティに関する注意を伝えてください：
「トークンをファイルに書くことが心配な方へ：
BALIA_TOKENはSection 6のインストール時に手動で入力することもできます。
その場合はこの行を空欄のまま進んでください。」

「このファイルは絶対に共有しないでください。GitHubにコミットしないでください。」
と伝えてください。


STEP 6b — APIキーを.envファイルに書き込む
以下を案内してください：
1. VS Codeで.envファイルを開く（balia-osフォルダの中にあります）
2. 「ANTHROPIC_API_KEY=sk-ant-あなたのキーをここに貼り付け」という行を探す
3. 「sk-ant-あなたのキーをここに貼り付け」の部分を実際のキーに置き換える
4. ファイルを保存する（WindowsはCtrl+S / MacはCmd+S）
確認：「APIキーが.envファイルに保存されました。
このファイルは絶対に共有しないでください。GitHubにコミットしないでください。」
キーをチャットに貼り付けるよう求めないでください。

STEP 10 — 最終チェック
以下のチェックリストを1項目ずつ一緒に確認してください：
□ code --version → バージョン番号が表示される
□ node --version → v22以上が表示される
□ openclaw --version → バージョン番号が表示される
□ ターミナルに「✓ Gateway running」が表示されている
□ balia-osフォルダがVS Codeで開いている
□ balia-osフォルダの中に.envファイルがある
□ .envにBALIA_TOKENが入力されている（またはSection 6で手動入力すると確認済み）
□ .envにAGENT_IDが入力されている
□ .envにBALIA_OS_PATHが入力されている

すべてチェックできたら、以下を伝えてください：
「インストール完了です。Section 4『エージェントファイルを作成する』に進みましょう。」

では始めましょう。最初の質問をしてください。

はじめる前に — APIコストについて正直にお伝えします ​

インストールするもの ​

▶ AIに貼り付けて始める

はじめる前に — APIコストについて正直にお伝えします

インストールするもの