OpenClaw 🦞

「脱皮せよ！ 脱皮せよ！」 — 宇宙のロブスター、おそらく

OpenClaw

あらゆる OS + WhatsApp/Telegram/Discord/iMessage gateway for AI agents（Pi）。
プラグインで Mattermost などを追加できます。 メッセージを送信すると、エージェントの応答が返ってきます — ポケットから。

GitHub · リリース · ドキュメント · OpenClaw アシスタントのセットアップ

OpenClaw は、WhatsApp（WhatsApp Web / Baileys 経由）、Telegram（Bot API / grammY）、Discord（Bot API / channels.discord.js）、iMessage（imsg CLI）を Pi などのコーディングエージェントに接続します。プラグインで Mattermost（Bot API + WebSocket）などを追加できます。 OpenClaw は OpenClaw アシスタントも駆動します。

ここから開始

Gateway が同じコンピュータで実行されている場合、そのリンクはブラウザの Control UI をすぐに開きます。 失敗した場合は、まず Gateway を起動してください：openclaw gateway。

ダッシュボード（ブラウザ Control UI）

ダッシュボードは、チャット、設定、ノード、セッションなどのためのブラウザ Control UI です。 ローカルのデフォルト：http://127.0.0.1:18789/ リモートアクセス：Web サーフェス および Tailscale

動作原理

WhatsApp / Telegram / Discord / iMessage（+ プラグイン）
        │
        ▼
  ┌───────────────────────────┐
  │          Gateway          │  ws://127.0.0.1:18789（ループバックのみ）
  │     （単一ソース）         │
  │                           │  http://<gateway-host>:18793
  │                           │    /__openclaw__/canvas/（Canvas ホスト）
  └───────────┬───────────────┘
              │
              ├─ Pi エージェント（RPC）
              ├─ CLI（openclaw …）
              ├─ Chat UI（SwiftUI）
              ├─ macOS アプリ（OpenClaw.app）
              ├─ iOS ノード（Gateway WS + ペアリング経由）
              └─ Android ノード（Gateway WS + ペアリング経由）

ほとんどの操作は Gateway（openclaw gateway）を経由します。これは、チャネル接続と WebSocket コントロールプレーンを所有する単一の長時間実行プロセスです。

ネットワークモデル

  • ホストごとに 1 つの Gateway（推奨）：WhatsApp Web セッションを所有できる唯一のプロセスです。レスキューボットまたは厳格な分離が必要な場合は、分離されたプロファイルとポートで複数のゲートウェイを実行してください。複数のゲートウェイ を参照してください。
  • ループバック優先：Gateway WS はデフォルトで ws://127.0.0.1:18789 になります。
    • ウィザードは現在、デフォルトで gateway トークンを生成します（ループバックの場合でも）。
    • Tailnet アクセスの場合は、openclaw gateway --bind tailnet --token ... を実行します（非ループバックバインドにはトークンが必要です）。
  • ノード：Gateway WebSocket に接続します（必要に応じて LAN/tailnet/SSH）。レガシー TCP ブリッジは非推奨 / 削除されました。
  • Canvas ホスト：canvasHost.port（デフォルト 18793）上の HTTP ファイルサーバーで、ノード WebView 用に /__openclaw__/canvas/ を提供します。Gateway 設定（canvasHost）を参照してください。
  • リモート使用：SSH トンネルまたは tailnet/VPN。リモートアクセス および Discovery を参照してください。

機能（ハイレベル）

  • 📱 WhatsApp 統合 — WhatsApp Web プロトコル用に Baileys を使用
  • ✈️ Telegram Bot — grammY 経由の DM + グループ
  • 🎮 Discord Bot — channels.discord.js 経由の DM + ギルドチャネル
  • 🧩 Mattermost Bot（プラグイン） — Bot トークン + WebSocket イベント
  • 💬 iMessage — ローカル imsg CLI 統合（macOS）
  • 🤖 エージェントブリッジ — Pi（RPC モード）、ツールストリーミング付き
  • ⏱️ ストリーミング + チャンク — ブロックストリーミング + Telegram ドラフトストリーミング詳細（/concepts/streaming）
  • 🧠 マルチエージェントルーティング — プロバイダーアカウント / ピアを分離されたエージェント（ワークスペース + エージェントごとのセッション）にルーティング
  • 🔐 サブスクリプション認証 — OAuth 経由の Anthropic（Claude Pro/Max）+ OpenAI（ChatGPT/Codex）
  • 💬 セッション — ダイレクトチャットは共有 main（デフォルト）に折りたたまれます。グループは分離されています
  • 👥 グループチャットサポート — デフォルトではメンション型。所有者は /activation always|mention を切り替えられます
  • 📎 メディアサポート — 画像、音声、ドキュメントの送受信
  • 🎤 ボイスノート — オプションの文字起こしフック
  • 🖥️ WebChat + macOS アプリ — 運用とボイスウェイク用のローカル UI + メニューバーコンパニオン
  • 📱 iOS ノード — ノードとしてペアリングし、Canvas サーフェスを公開
  • 📱 Android ノード — ノードとしてペアリングし、Canvas + Chat + Camera を公開

注：レガシー Claude/Codex/Gemini/Opencode パスは削除されました。Pi のみがコーディングエージェントパスです。

クイックスタート

ランタイム要件：Node ≥ 22。

# 推奨：グローバルインストール（npm/pnpm）
npm install -g openclaw@latest
# または：pnpm add -g openclaw@latest

# オンボーディング + サービスのインストール（launchd/systemd ユーザーサービス）
openclaw onboard --install-daemon

# WhatsApp Web のペアリング（QR を表示）
openclaw channels login

# オンボーディング後、Gateway はサービス経由で実行されます。手動実行も可能です：
openclaw gateway --port 18789

後で npm と git インストール間の切り替えは簡単です：別のフレーバーをインストールして openclaw doctor を実行し、gateway サービスのエントリポイントを更新します。

ソースから（開発）：

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build # 初回実行時に UI 依存関係を自動インストール
pnpm build
openclaw onboard --install-daemon

グローバルインストールがまだない場合は、リポジトリから pnpm openclaw ... を経由してオンボーディングステップを実行してください。

マルチインスタンスクイックスタート（オプション）：

OPENCLAW_CONFIG_PATH=~/.openclaw/a.json \
OPENCLAW_STATE_DIR=~/.openclaw-a \
openclaw gateway --port 19001

テストメッセージを送信（実行中の Gateway が必要）：

openclaw message send --target +15555550123 --message "Hello from OpenClaw"

設定（オプション）

設定は ~/.openclaw/openclaw.json にあります。

  • 何もしない場合、OpenClaw は送信者ごとのセッションで RPC モードのバンドルされた Pi バイナリを使用します。
  • ロックダウンしたい場合は、channels.whatsapp.allowFrom および（グループの場合）メンションルールから始めてください。

例：

{
  channels: {
    whatsapp: {
      allowFrom: ["+15555550123"],
      groups: { "*": { requireMention: true } }
    }
  },
  messages: { groupChat: { mentionPatterns: ["@openclaw"] } }
}

ドキュメント

名前の由来

OpenClaw = CLAW + TARDIS — なぜなら、すべての宇宙ロブスターには時空マシンが必要だからです。

「私たちは皆、自分のプロンプトで遊んでいるだけです。」 — AI、おそらくトークンでハイになっている

クレジット

  • Peter Steinberger（@steipete）— 創設者、ロブスターウィスパラー
  • Mario Zechner（@badlogicc）— Pi 創設者、セキュリティペンテスター
  • Clawd — より良い名前を要求した宇宙ロブスター

コアコントリビューター

  • Maxim Vovshin（@Hyaxia、[email protected]）— Blogwatcher スキル
  • Nacho Iacovino（@nachoiacovino、[email protected]）— ロケーション解析（Telegram + WhatsApp）

ライセンス

MIT — 海のロブスターのように自由 🦞

「私たちは皆、自分のプロンプトで遊んでいるだけです。」 — AI、おそらくトークンでハイになっている

← ドキュメントに戻る