OpenClawのインストールとonboard設定の過程を示す画面

概要

OpenClawとは

OpenClawは、開発者が自律的に動作するAIエージェントを構築できるようにするNode.jsベースのオープンソースフレームワークです。

Claude、GPTなど様々なモデルと連携できます。

ファイルの読み取り、コマンドの実行、外部サービスの呼び出しといった作業をツールとして接続し、自動化できます。

公式サイト: OpenClaw

主な特徴

  • マルチモーダル入力, テキスト、画像、ファイルなど複数の形式の入力を処理します。
  • ツール統合, ファイルシステムアクセス、Web検索、API呼び出しといった機能をツールとして追加し拡張します。
  • セキュリティ重視の設計, サンドボックス、アクセス制御、ホワイトリストといった仕組みを提供します。
  • 拡張可能な構造, プラグイン方式で機能を追加しやすくなっています。

インストール

OpenClawはインストールスクリプトを提供します。

Node.jsなどの必須ユーティリティも一緒にインストールします。

インストールドキュメント: https://docs.openclaw.ai/install

基本インストールモード

基本インストールでは、インストール直後に**onboard(対話型初期設定)**に進みます。

設定が終わると実行段階に進みます。

1# macOS / Linux / WSL2
2curl -fsSL https://openclaw.ai/install.sh | bash
3
4# Windows (PowerShell)
5iwr -useb https://openclaw.ai/install.ps1 | iex
手動インストールのみが必要な場合

onboardなしでインストールのみ行いたい場合は、以下のオプションを使用します。

1# macOS / Linux / WSL2
2curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
3
4# Windows (PowerShell)
5& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

インストール後は、以下の順序で進めます。

1# 設定する
2openclaw onboard
3
4# 実行する
5openclaw gateway start

基本インストール画面

インストールスクリプトを実行した基本インストール画面

初期設定(onboard)

基本インストールモードを進めると、インストール後にonboardに進みます。

設定は対話型UIで進みます。

設定ファイルはデフォルトで~/.openclaw/openclaw.jsonに記録されます。

onboardを途中で中断しても、再度実行すれば続きから編集できます。

必要であれば初期化して再設定することもできます。

1. セキュリティ警告への同意

onboardの最初のステップであるセキュリティ警告への同意画面

⚠️ **セキュリティ警告 — 必ずお読みください**

OpenClawは趣味のプロジェクトであり、まだベータ段階です。
予期しない問題や未完成の機能が存在する可能性があります。
このボットは、ツールが有効化されている場合ファイルの読み取りや作業の実行を行うことがあります。
不適切なプロンプトはボットを騙して安全でない動作を実行させる可能性があります。
基本的なセキュリティおよびアクセス制御に不慣れな場合は、OpenClawの実行はお勧めしません。
ツールを有効化したりインターネットに公開したりする前に、経験のある人の助けを借りてください。

重要: OpenClawはツールが有効化されると、ファイルの読み取りやコマンドの実行が可能になります。

外部に公開されると非常に危険になる可能性があるため、デフォルト設定のまま公開チャンネルに接続しない方が安全です。

例えば、チャットボットにファイルを読んでほしいと頼むと、そのまま出力してしまうことがあります。

チャットボットにファイルを要求すると、内容をそのまま出力する例の画面

2. インストールモードの選択

onboardでインストールモードを選ぶ画面

OpenClawのインストールとonboard設定の過程を示す画面

Manualモードは、ゲートウェイとワークスペースを手動で指定する際に使用します。

ゲートウェイの選択(通常はローカルマシン)

Manualモードでゲートウェイを直接指定する画面

ワークスペースパスの指定

デフォルトパスは~/.openclaw/workspace

ワークスペースパスを指定する画面

3. モデルおよび認証プロバイダーの選択

使用するモデルと認証プロバイダーを選ぶ画面

必要なプロバイダーを有効化すればよいです。
選択すると認証手続きを案内してくれます。

Claude(Anthropic)の例

一部のエージェントは自動でインストールされることもあります。

手動インストールが必要な場合もあります。

Claudeエージェントをインストールする画面

トークンの確認

1claude setup-token

claude setup-tokenで発行したトークンを確認する画面

モデルの選択は、通常デフォルト値のままでも構いません。

必要であればいつでも変更できます。

使用するモデルを選択する画面

ChatGPTのようなクラウドモデルは、APIキー方式の場合、使用量に応じた課金になることがあります。
ただし、サブスクリプション型のアカウントを使用している場合でも、APIキーなしで連携できる方法があるので確認してみる価値があります。

  • ChatGPT: OpenAI Codex (ChatGPT OAuth)
  • Claude: Anthropic token (setup-tokenを貼り付け)
  • Gemini: Google Gemini CLI OAuth

4. チャンネルの選択

接続するメッセンジャーチャンネルを選ぶ画面

OpenClawのインストールとonboard設定の過程を示す画面

使いたいメッセンジャーチャンネルを選択します。
Telegramは無料なので選ばれることが多いです。

Telegramボットトークンの生成と入力

Telegramボットは管理者コンソールではなく、@BotFatherと会話して生成・管理します。

Telegramの@BotFatherと会話してボットを生成する画面

OpenClawのインストールとonboard設定の過程を示す画面

OpenClawのインストールとonboard設定の過程を示す画面

5. スキルの選択

使用するスキルを選ぶ画面

OpenClawのインストールとonboard設定の過程を示す画面

OpenClawは付加機能をスキル、プラグインといった形で提供します。
基本的には必要なスキルだけをオンにして始めればよいです。

繰り返し行わせる作業は、後でスキルとして作って追加できます。

高度な機能に必要な設定例

以下のような作業が必要な場合にのみ有効化する方が安全です。

  • Googleマップでの場所検索
  • 画像生成
  • Notionデータの検索
  • 音声をテキストに変換(STT)
  • テキストを音声に変換(TTS)

Google Places

場所検索に必要なGoogle APIキーの設定です。

例: 「ソウル江南区で評価の高いおすすめのレストランを教えて」

場所検索用のGoogle Places APIキーを設定する画面

画像生成(Gemini, Nano Banana)

Geminiベースの画像生成機能を使用する際に設定します。

Gemini(Nano Banana)画像生成スキルを設定する画面

Notion

Notionページのデータを参照する際に使用します。

Notion連携スキルを設定する画面

画像生成(OpenAI)

OpenAI画像生成スキルを設定する画面

Whisper(STT)

音声ファイルをテキストに変換します。

Telegramで音声メッセージを送ると、これをテキストに変換して処理できます。

音声をテキストに変換するWhisper(STT)の設定画面

ElevenLabs(TTS)

テキストを音声に変換する際に使用します。

テキストを音声に変換するElevenLabs(TTS)の設定画面

6. Hookの設定

使用するHookを選ぶ画面

項目別の参考
boot-md

  • gateway起動時にBOOT.mdを自動実行し、初期指示をロードします。

bootstrap-extra-files

  • globまたはpathパターンでworkspaceの初期ファイルを自動的に注入します。
  • 個人的にはこのオプションだけを除いて有効化することをお勧めします。
  • パスを誤って指定すると、workspaceが汚染される可能性があります。

command-logger

  • すべてのコマンドイベントを中央の監査ログファイルに記録します。

session-memory

  • /new実行時にセッションコンテキストを自動的にメモリに保存します。

7. ボットの実行

onboard設定を終えてボットを実行する画面

💡

macOSで実行許可が必要な場合

macOSで実行許可を求める画面

TUIで実行するかWeb UIで実行するかを選択します。

Web UIの方が便利そうに見えますが、チャンネルベースのアシスタントを使う予定であればTUIでも十分です。

実行画面

ゲートウェイが実行された画面

8. Telegramユーザー認証

Telegramボットにメッセージを送ってユーザー認証を開始する画面

ボットを作成した後、メッセージを送るとユーザー認証が進みます。
誰でもボットを通じてOpenClawにアクセスできてはいけないため、認証が必要です。

認証コードはTelegramメッセージとして送られてきます。

案内されたコマンドをコピーしてターミナルで手動実行すればよいです。

Telegramで受け取った認証コードをターミナルで入力する画面

9. 自分の呼び名とボット名を決める

ユーザーの呼び名とボット名を決める画面

💡 ボットがユーザーを呼ぶ名前と、ユーザーがボットを呼ぶ名前を決めます。
設定後は、通常のChatGPTのように会話しながら使うことができます。

10. 例

設定を終えたボットと実際に会話する例の画面

OpenClawのインストールとonboard設定の過程を示す画面

エラーと解決策

nodeの要求バージョンの変更

原因: 22.12以上を使用する必要があるが、20.11を使用中

1❯ openclaw help
2openclaw requires Node >=22.12.0.
3Detected: node 20.11.1 (exec: /Users/plzhans/.nvm/versions/node/v20.11.1/bin/node).

解決策

  • グローバル領域にインストールしたが、グローバルのnodeバージョンが20.11のまま
  • グローバル領域を基準とした解決策
 1# バージョン確認
 2❯ node -v
 3
 4# 実行中のプロセスを確認
 5ps -ef | grep openclaw
 6
 7# 参考までに、プロセスを止めてもサービスやランチャーとして登録されていれば自動的に再起動します
 8# サービスやランチャーとして登録されている場合は、ランチャーを停止する必要があります
 9# mac基準: 実行中のopenclawを探す
10launchctl list | grep openclaw
11
12# 実行中のopenclawを停止
13launchctl unload ~/Library/LaunchAgents/ai.openclaw.gateway.plist
14
15
16# 新しいバージョンをインストールし、デフォルトバージョンを変更
17nvm install 22
18nvm use 22
19nvm alias default 22

関連記事