OpenClaw セットアップ手順（macOS / Node.js v22+）

1. 前提条件

• macOS
• Node.js バージョン 22以上

2. セットアップ手順

ステップ1: Node.js のバージョンアップ

現在のバージョンを確認

node -v

v22 未満の場合、nodebrew でアップデート

nodebrew install-binary v22
nodebrew use v22

再度バージョンを確認

node -v

ステップ2: OpenClaw のインストール

npm install -g openclaw@latest

ステップ3: Slack アプリの作成とトークン取得

1. Slack アプリ作成ページ を開きます

2. 「Create New App」→「From an app manifest」を選択します

3. ワークスペースを選び、「JSON」タブに、後述の openclaw onboard 実行時に表示されるマニフェストを貼り付けてアプリを作成します

4. 以下の2つのトークンを取得します

   1. Bot Token（xoxb-...）

      • 「OAuth & Permissions」→「Install to Workspace」で取得

   2. App Token（xapp-...）

      • 「Basic Information」→「App-Level Tokens」
      • スコープに connections:write を追加して生成

ステップ4: OpenClaw の初期設定

openclaw onboard --install-daemon

ウィザードの質問に沿って設定を進めます。 Slack のトークン入力画面で、先ほど取得した 2つのトークンを貼り付けてください。

3. ゲートウェイの仕組みと役割

ゲートウェイは、OpenClaw の心臓部です。Slack などの外部サービスと AI モデルを仲介するサーバーとして、あなたの Mac 上で動作します。

初期設定で --install-daemon オプションを付けたため、ゲートウェイは Mac の起動時に自動的にバックグラウンドで起動します。

4. PC 再起動後の確認手順

Mac を再起動した後、ボットが反応しない場合は以下を確認します。

4.1 ゲートウェイの状態確認

openclaw health

Gateway: running と表示されれば正常です。 停止している場合は、以下で手動起動してください。

openclaw gateway

4.2 APIキーの環境変数を確認（重要）

ターミナルを再起動すると export コマンドで設定した環境変数はリセットされます。 APIキーエラーが再発する場合は、シェルの設定ファイル（~/.zshrc や ~/.bash_profile）に追記して恒久化してください。

export OPENAI_API_KEY="sk-あなたのAPIキー"

5. GUI ダッシュボード（Web UI）の利用

OpenClaw には、ブラウザで操作できる GUI ダッシュボードが用意されています。

表示方法

ターミナルで以下のコマンドを実行すると、自動的にブラウザでダッシュボードが開きます。

openclaw dashboard

または、ブラウザで直接アクセスします。

• URL: http://127.0.0.1:18789/

主な機能

• Config: モデルや API キーなどの設定を GUI で確認・編集
• Logs: ゲートウェイの動作ログをリアルタイムで確認
• Chat: ダッシュボードから直接ボットとチャット

6. Chrome 拡張機能の利用

Webページの内容を OpenClaw に読み込ませるための Chrome 拡張機能です。

手動インストール手順

6.1 GitHub からソースコードをダウンロード

# リポジトリをクローン
git clone https://github.com/openclaw/openclaw.git
 
# 拡張機能フォルダに移動
cd openclaw/assets/chrome-extension

6.2 Chrome に読み込む

1. Chrome で chrome://extensions を開きます
2. 右上の「デベロッパーモード」を有効にします
3. 「パッケージ化されていない拡張機能を読み込む」をクリックします
4. chrome-extension フォルダを選択します

6.3 使い方

1. 拡張機能のアイコンをツールバーにピン留めします
2. 操作したい Web ページを開いた状態で、拡張機能アイコンをクリックします
3. バッジが「ON」と表示されれば、ページが OpenClaw に接続されています

注意: バッジが「!」の場合は、ゲートウェイが起動していないか、接続に失敗しています。

7. 主要コマンドリファレンス

8. スキル（Skills）の管理

ClawHub（https://clawhub.com/）で公開されているスキルをインストールして、機能を拡張できます。

# ワークスペースに移動
cd ~/.openclaw/agents/main
 
# スキルをインストール
clawhub install web-search

9. トラブルシューティング

🚨 401 You do not have access... エラー

OpenAI APIキーの認証エラーです。新しい API キーを発行し、シェルの設定ファイル（~/.zshrc など）で環境変数を正しく設定してください。

🚨 command not found: hatch エラー

起動コマンドが hatch から gateway に変更されました。openclaw gateway を使用してください。

🚨 Gateway failed to start... エラー

ゲートウェイが既に動作中です。openclaw gateway stop で一度停止してから再起動してください。

10. Slack での基本的な使い方

• チャンネル: @ボット名 でメンションして指示を出します
• DM: ボットに直接メッセージを送ります