EXFOLIATE! EXFOLIATE!
OpenClaw は、あなたのデバイスで実行するパーソナル AI アシスタントです。すでに使用しているチャネルで回答します。macOS/iOS/Android で話したり聞いたりでき、制御できるライブ Canvas をレンダリングできます。Gateway は単なるコントロールプレーンです — 製品はアシスタントです。
ローカルで高速、常時実行されるパーソナルな単一ユーザーアシスタントが欲しければ、これがそれです。
対応チャネルには以下が含まれます:WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、iMessage、BlueBubbles、IRC、Microsoft Teams、Matrix、Feishu、LINE、Mattermost、Nextcloud Talk、Nostr、Synology Chat、Tlon、Twitch、Zalo、Zalo Personal、WeChat、QQ、WebChat。
ウェブサイト · ドキュメント · ビジョン · DeepWiki · はじめに · アップデート · ショーケース · FAQ · オンボーディング · Nix · Docker · Discord
新しくインストール?ここから始めてください:はじめに
推奨セットアップ:ターミナルで openclaw onboard を実行してください。
OpenClaw Onboard は、ゲートウェイ、ワークスペース、チャネル、スキルのセットアップをステップバイステップでガイドします。推奨される CLI セットアップパスであり、macOS、Linux、Windows(WSL2 経由;強く推奨)で動作します。
npm、pnpm、または bun で動作します。
|
|
|
|
|
|
|
サブスクリプション(OAuth):
- OpenAI(ChatGPT/Codex)
モデルに関する注記:多くのプロバイダーとモデルがサポートされていますが、信頼して既に使用しているプロバイダーの最新フラッグシップモデルを推奨します。オンボーディングを参照してください。
ランタイム:Node 24(推奨)または Node 22.14+。
npm install -g openclaw@latest
# or: pnpm add -g openclaw@latest
openclaw onboard --install-daemonOpenClaw Onboard は Gateway デーモン(launchd/systemd ユーザーサービス)をインストールして、常に実行されるようにします。
ランタイム:Node 24(推奨)または Node 22.14 以上。
初心者向けの完全ガイド(認証、ペアリング、チャネル):はじめに
openclaw onboard --install-daemon
openclaw gateway --port 18789 --verbose
# Send a message
openclaw message send --target +1234567890 --message "Hello from OpenClaw"
# Talk to the assistant (optionally deliver back to any connected channel: WhatsApp/Telegram/Slack/Discord/Google Chat/Signal/iMessage/BlueBubbles/IRC/Microsoft Teams/Matrix/Feishu/LINE/Mattermost/Nextcloud Talk/Nostr/Synology Chat/Tlon/Twitch/Zalo/Zalo Personal/WeChat/QQ/WebChat)
openclaw agent --message "Ship checklist" --thinking highアップグレードする場合は?更新ガイド(openclaw doctor を実行してください)。
モデル設定 + CLI:モデル。認証プロファイルのローテーション + フェイルオーバー:モデルフェイルオーバー。
OpenClaw は実際のメッセージング基盤に接続します。受信 DM を信頼されないインプットとして扱ってください。
完全なセキュリティガイド:セキュリティ
Telegram/WhatsApp/Signal/iMessage/Microsoft Teams/Discord/Google Chat/Slack でのデフォルト動作:
- DM ペアリング(
dmPolicy="pairing"/channels.discord.dmPolicy="pairing"/channels.slack.dmPolicy="pairing";レガシー:channels.discord.dm.policy、channels.slack.dm.policy):未知の送信者は短いペアリングコードを受け取り、ボットはそのメッセージを処理しません。 - 以下で承認してください:
openclaw pairing approve <channel> <code>(その後、送信者はローカルアロウリストストアに追加されます)。 - 公開受信 DM には明示的なオプトインが必要です:
dmPolicy="open"を設定し、チャネルアロウリスト(allowFrom/channels.discord.allowFrom/channels.slack.allowFrom;レガシー:channels.discord.dm.allowFrom、channels.slack.dm.allowFrom)に"*"を含めます。
openclaw doctor を実行して、リスク / 誤設定の DM ポリシーを表示します。
- ローカルファースト Gateway — セッション、チャネル、ツール、イベントの単一制御プレーン。
- マルチチャネルインボックス — WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、BlueBubbles(iMessage)、iMessage(レガシー)、IRC、Microsoft Teams、Matrix、Feishu、LINE、Mattermost、Nextcloud Talk、Nostr、Synology Chat、Tlon、Twitch、Zalo、Zalo Personal、WeChat、QQ、WebChat、macOS、iOS/Android。
- マルチエージェントルーティング — 受信チャネル / アカウント / ピアを分離されたエージェント(ワークスペース + エージェント別セッション)にルーティング。
- Voice Wake + Talk Mode — macOS/iOS でのウェイクワードと Android での連続音声(ElevenLabs + システム TTS フォールバック)。
- Live Canvas — A2UI を備えたエージェント駆動ビジュアルワークスペース。
- 第一級ツール — ブラウザ、キャンバス、ノード、cron、セッション、Discord/Slack アクション。
- コンパニオンアプリ — macOS メニューバーアプリ + iOS/Android ノード。
- オンボーディング + スキル — バンドル / マネージド / ワークスペーススキル付きのオンボーディング駆動セットアップ。
- デフォルト:ツールは
mainセッション用ホスト上で実行されるため、それがあなただけの場合、エージェントはフルアクセスを持ちます。 - グループ / チャネル安全性:
agents.defaults.sandbox.mode: "non-main"を設定して、非mainセッションをサンドボックス内で実行します。Docker はデフォルトのサンドボックスバックエンド。SSH と OpenShell バックエンドも利用可能です。 - 典型的なサンドボックスデフォルト:
bash、process、read、write、edit、sessions_list、sessions_history、sessions_send、sessions_spawnを許可。browser、canvas、nodes、cron、discord、gatewayを拒否。 - リモートで何かを公開する前に、セキュリティ、サンドボックス、設定をお読みください。
- チャットコマンド:
/status、/new、/reset、/compact、/think <level>、/verbose on|off、/trace on|off、/usage off|tokens|full、/restart、/activation mention|always - セッションツール:
sessions_list、sessions_history、sessions_send - スキルレジストリ:ClawHub
- アーキテクチャの概要:アーキテクチャ
- 初めての方へ:始める、オンボーディング、更新
- チャネル設定:チャネルインデックス、WhatsApp、Telegram、Discord、Slack
- アプリ+ノード:macOS、iOS、Android、ノード
- 設定とセキュリティ:設定、セキュリティ、サンドボックス
- リモート+ウェブ:Gateway、リモートアクセス、Tailscale、ウェブサーフェス
- ツール+自動化:ツール、Skills、Cronジョブ、Webhook、Gmail Pub/Sub
- 内部:アーキテクチャ、Agent、セッションモデル、Gateway プロトコル
- トラブルシューティング:チャネルトラブルシューティング、ログ、ドキュメントホーム
Gateway だけでも優れた体験を提供します。すべてのアプリはオプションであり、追加機能を提供します。
コンパニオンアプリをビルド/実行する予定がある場合は、以下のプラットフォームランブックに従ってください。
- Gateway と健全性のメニューバーコントロール。
- ボイスウェイク+プッシュツートークオーバーレイ。
- WebChat + デバッグツール。
- SSH 経由のリモート Gateway コントロール。
注:macOS の権限を再ビルド間で保持するには、署名付きビルドが必要です(macOS Permissions を参照)。
- Gateway WebSocket 経由でノードとしてペアリングします(デバイスペアリング)。
- 音声トリガー転送+ Canvas サーフェス。
openclaw nodes …経由で制御されます。
ランブック:iOS 接続。
- デバイスペアリング経由で WS ノードとしてペアリングします(
openclaw devices ...)。 - Connect/Chat/Voice タブに加えて、Canvas、Camera、Screen capture、Android デバイスコマンドファミリーを公開します。
- ランブック:Android 接続。
ソースのチェックアウトには pnpm を使用してください。リポジトリは pnpm ワークスペースであり、バンドルされたプラグインは開発時に extensions/* から読み込まれるため、パッケージローカルの依存関係と編集内容が直接使用されます。リポジトリルートで単純な npm install を実行することはサポートされていません。
開発ループの場合:
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
# 初回のみ実行(またはローカルの OpenClaw 設定/ワークスペースをリセットした後)
pnpm openclaw setup
# オプション:初回起動前に Control UI をプリビルド
pnpm ui:build
# 開発ループ(ソース/設定の変更時に自動再読み込み)
pnpm gateway:watchチェックアウトからビルドされた dist/ が必要な場合(Node、パッケージング、リリース検証)は、次を実行してください:
pnpm build
pnpm ui:buildpnpm openclaw setup は pnpm gateway:watch に必要なローカルの設定/ワークスペースを書き込みます。再実行しても安全ですが、通常は初回セットアップ後またはローカルの状態をリセットした後にのみ必要です。pnpm gateway:watch は dist/control-ui を再ビルドしないため、ui/ の変更後に pnpm ui:build を再実行するか、Control UI を反復処理する際に pnpm ui:dev を使用してください。このチェックアウトをオンボーディングを直接実行させたい場合は、pnpm openclaw onboard --install-daemon を使用してください。
注:pnpm openclaw ... は TypeScript を直接実行します(tsx 経由)。pnpm build は Node / パッケージされた openclaw バイナリ経由での実行用に dist/ を生成します。一方、pnpm gateway:watch は開発ループ中にオンデマンドでランタイムを再ビルドします。
- 安定版:タグ付きリリース(
vYYYY.M.DまたはvYYYY.M.D-<patch>)、npm dist-taglatest。 - ベータ版:プレリリースタグ(
vYYYY.M.D-beta.N)、npm dist-tagbeta(macOS アプリが欠落している場合があります)。 - 開発版:
mainの移動ヘッド、npm dist-tagdev(公開時)。
チャネルを切り替える(git + npm):openclaw update --channel stable|beta|dev。
詳細:開発チャネル。
- ワークスペースルート:
~/.openclaw/workspace(agents.defaults.workspaceで設定可能)。 - 注入されるプロンプトファイル:
AGENTS.md、SOUL.md、TOOLS.md。 - スキル:
~/.openclaw/workspace/skills/<skill>/SKILL.md。
最小限の ~/.openclaw/openclaw.json(モデル + デフォルト):
{
agent: {
model: "<provider>/<model-id>",
},
}