openclaw

OpenClaw メンテナンススキル

OpenClaw は、WhatsApp、Telegram、Discord、Slack、iMessage、Signal など、15 以上のチャネルで AI エージェントを同時にルーティングする、セルフホスト可能なオープンソース（MIT）のゲートウェイです。macOS、Linux、Windows で動作します。

参考ファイル

参照	対象範囲
channels.md	チャネルごとのセットアップ（WhatsApp、Telegram、Discord など）
channel_troubleshooting.md	チャネルごとの障害の特徴と解決手順
tools.md	ツール一覧（プロファイル、グループ、すべての組み込みツール）
exec.md	Exec ツール：パラメーター、設定、PATH、セキュリティ、プロセスツール
exec_approvals.md	Exec の承認：許可リスト、安全なバイナリ、承認フロー
browser.md	ブラウザープラグイン：プロファイル、CDP、Chrome MCP、スナップショット、SSRF、Control API
web_tools.md	Web ツール：Brave、Perplexity、Gemini の検索プロバイダー
pdf_tool.md	PDF ツール：ネイティブ／フォールバックモード、設定、ページのフィルタリング
elevated.md	権限昇格モード：/elevated ディレクティブ、サンドボックスの突破
lobster.md	Lobster：承認機能付きの型付きワークフローランタイム
llm_task.md	LLM Task：構造化出力用の JSON 専用 LLM ステップ
openprose.md	OpenProse：マルチエージェントプログラムランタイム
plugins.md	プラグイン：機能モデル、公式リスト、設定、フック、SDK、作成
skills.md	スキル：保存場所、設定、ClawHub、ウォッチャー、トークンへの影響
providers.md	モデルプロバイダーのセットアップ
multi_agent.md	マルチエージェントルーティング
nodes.md	ノード（iOS／Android／macOS／ヘッドレス）
security.md	セキュリティ強化
secrets.md	シークレット管理（SecretRef、ボールト）
sandboxing.md	サンドボックス化（Docker による分離）
config_reference.md	設定フィールドの完全リファレンス
gateway_ops.md	ゲートウェイの運用
remote_access.md	リモートアクセス、SSH、Tailscale、Web ダッシュボード
sessions.md	セッション管理、DM の分離、ライフサイクル、圧縮
hooks.md	フック：内部イベントフック、HTTP Webhook、作成、CLI
automation.md	Cron ジョブ、Webhook、Gmail Pub/Sub、バックグラウンドタスク、定常指示
acp_agents.md	ACP エージェント：外部 AI ランタイムの起動（Codex、Claude、Gemini、14 以上のハーネス）
install.md	インストール、更新、ロールバック、移行、アンインストール
web_ui.md	Web インターフェース：Dashboard、Control UI、WebChat
slash_commands.md	チャットのスラッシュコマンド（/new、/model、/acp など）
platforms.md	プラットフォーム別ガイド（macOS、iOS、Android、Linux、Windows）
diffs_firecrawl.md	Diffs プラグイン＋Firecrawl のアンチボット用フォールバック
subagents.md	サブエージェント：ネストした起動、スレッドのバインド、通知、ツールポリシー
memory.md	メモリーシステム、ベクトル検索、ハイブリッド BM25、圧縮、QMD バックエンド
architecture.md	ゲートウェイアーキテクチャ、ワイヤープロトコル、ペアリング、不変条件
agent_runtime.md	エージェントランタイム、ブートストラップファイル、エージェントループ、コンテキストエンジン、フック、タイムアウト
streaming.md	ストリーミング＋チャンク化：ブロックストリーミング、結合、プレビューモード
queue.md	コマンドキュー：モード（steer/followup/collect）、同時実行、セッションごとの制御
model_failover.md	モデルのフェイルオーバー、OAuth、認証プロファイル、クールダウン、課金の無効化
clawhub.md	ClawHub：公開スキルレジストリ、CLI コマンド、公開／インストール
thinking.md	思考レベル、詳細度ディレクティブ、推論の可視性
polls.md	投票：Telegram、WhatsApp、Discord、MS Teams
voice.md	Talk Mode（音声操作）＋Voice Wake（ウェイクワード）
presence_discovery.md	プレゼンスシステム、検出（Bonjour／Tailscale）、トランスポート
gateway_internals.md	ネットワークモデル、ゲートウェイロック、ヘルスチェック、doctor、ロギング、バックグラウンド Exec
heartbeat.md	ハートビート：設定、配信、可視性、HEARTBEAT.md、エージェントごとの設定
bonjour.md	Bonjour／mDNS：TXT キー、広域 DNS-SD、デバッグ、障害モード
pairing.md	ゲートウェイのペアリング：ノードの承認、CLI、API、自動承認、ストレージ
tui.md	TUI：キーボードショートカット、スラッシュコマンド、ピッカー、ローカルシェル、配信
media.md	メディア：カメラ撮影、画像、音声／ボイスメモ、文字起こし
channel_routing.md	チャネルルーティング、セッションキー、エージェントの選択、Mattermost、BlueBubbles

クイックリファレンス

主要なパス

パス	用途
~/.openclaw/openclaw.json	メイン設定（JSON5）
~/.openclaw/.env	グローバル環境変数のフォールバック
~/.openclaw/workspace	デフォルトのエージェントワークスペース
~/.openclaw/agents/<id>/	エージェントごとの状態とセッション
~/.openclaw/skills/	管理対象／ローカルのスキル
~/.openclaw/agents/<id>/qmd/	QMD メモリーバックエンドの状態
~/.openclaw/agents/<id>/agent/auth-profiles.json	認証プロファイルと OAuth トークン
OPENCLAW_CONFIG_PATH	設定の場所を上書き
OPENCLAW_STATE_DIR	状態ディレクトリを上書き
OPENCLAW_HOME	ホームディレクトリを上書き

基本的なコマンド

openclaw status                    # Overall status
openclaw gateway status            # Gateway daemon status
openclaw gateway status --deep     # Deep scan including system services
openclaw doctor                    # Diagnose config/service issues
openclaw doctor --fix              # Auto-fix safe issues
openclaw logs --follow             # Tail gateway logs
openclaw channels status --probe   # Channel health check
openclaw security audit            # Security posture check
openclaw security audit --fix      # Auto-fix security issues
openclaw update                    # Self-update
openclaw dashboard                 # Open Control UI in browser
openclaw tui                       # Terminal UI (interactive REPL)
openclaw agent                     # Direct agent interaction via CLI
openclaw health                    # Health check
openclaw usage                     # Usage tracking
openclaw config validate           # Validate config file
openclaw config file               # Print active config path
openclaw sessions cleanup          # Session disk cleanup
openclaw agents bindings           # Agent-channel bindings
openclaw agents bind               # Bind agent to account
openclaw agents unbind             # Unbind agent
openclaw update --dry-run          # Preview update
openclaw system presence           # View connected clients/nodes
openclaw system heartbeat last     # Last heartbeat info
openclaw system heartbeat now      # Trigger heartbeat immediately
openclaw memory search <query>     # CLI memory search
openclaw docs <query>              # Search OpenClaw docs
openclaw tasks list                # List background/detached task runs
openclaw tasks show <id>           # Show specific task details
openclaw tasks cancel <id>         # Cancel a running task
openclaw tasks audit               # Identify problematic task runs
openclaw agent --message "..."     # Run single agent turn (scripted/testing)
openclaw nodes pending             # List pending pairing requests
openclaw nodes approve <id>        # Approve node pairing
openclaw nodes status              # Show all paired nodes
openclaw health --json             # Full health snapshot (JSON)
openclaw message send --media <p>  # Send media message

デフォルトのゲートウェイ

• バインド先：127.0.0.1:18789（ループバック）
• ダッシュボード：http://127.0.0.1:18789/
• プロトコル：WebSocket（JSON テキストフレーム）

コアワークフロー

問題の診断

必ず次のコマンドを順に実行してください。

1. openclaw status — 概要をすばやく確認
2. openclaw gateway status — デーモンは実行中ですか？ RPC プローブは正常ですか？
3. openclaw logs --follow — エラーを監視
4. openclaw doctor — 設定／サービスの診断
5. openclaw channels status --probe — チャネルごとの状態を確認

ゲートウェイの起動／再起動

# Foreground with verbose logging
openclaw gateway --port 18789 --verbose

# Force-kill existing listener then start
openclaw gateway --force

# Service management (launchd on macOS, systemd on Linux)
openclaw gateway install
openclaw gateway start
openclaw gateway stop
openclaw gateway restart

設定

次のいずれかの方法で設定を編集できます。

# Interactive wizard
openclaw onboard                    # Full setup
openclaw configure                  # Config wizard

# CLI one-liners
openclaw config get <path>          # Read value
openclaw config set <path> <value>  # Set value (JSON5 or raw string)
openclaw config unset <path>        # Remove value

# Direct edit
# Edit ~/.openclaw/openclaw.json (JSON5 format)
# Gateway hot-reloads on save (if gateway.reload.mode != "off")

最小限の設定例：

{
  agents: { defaults: { workspace: "~/.openclaw/workspace" } },
  channels: { whatsapp: { allowFrom: ["+15555550123"] } },
}

チャネルのセットアップ

チャネルごとの詳細なセットアップについては、references/channels.md を参照してください。 チャネルごとのトラブルシューティング（障害の兆候、セットアップ手順）については、references/channel_troubleshooting.md を参照してください。 新しいチャネル（Matrix、Nostr、MS Teams など）を追加するプラグインについては、references/plugins.md を参照してください。

チャネルをすばやく追加するには：

# Interactive wizard
openclaw channels add

# Non-interactive
openclaw channels add --channel telegram --account default --name "My Bot" --token $BOT_TOKEN
openclaw channels login --channel whatsapp     # QR pairing for WhatsApp
openclaw channels status --probe               # Verify

モデルプロバイダーのセットアップ

プロバイダーの詳細なセットアップについては、references/providers.md を参照してください。

# Set default model
openclaw models set anthropic/claude-sonnet-4-5

# List available models
openclaw models list --all

# Check auth/token status
openclaw models status --probe

# Add auth interactively
openclaw models auth add

設定例：

{
  agents: {
    defaults: {
      model: {
        primary: "anthropic/claude-sonnet-4-5",
        fallbacks: ["openai/gpt-5.2"],
      },
    },
  },
}

マルチエージェントルーティング

マルチエージェント設定の詳細については、references/multi_agent.md を参照してください。

openclaw agents add <id>                # Create agent
openclaw agents list --bindings         # Show agent-channel bindings
openclaw agents delete <id>             # Remove agent

ノード（iOS／Android／macOS／ヘッドレス）

ノードの詳細なセットアップについては、references/nodes.md を参照してください。

openclaw nodes status                   # List connected nodes
openclaw nodes describe --node <id>     # Node capabilities
openclaw devices list                   # Pending device approvals
openclaw devices approve <requestId>    # Approve a device
openclaw node run --host <host> --port 18789  # Start headless node host

セキュリティ

セキュリティ強化の詳細については、references/security.md を参照してください。 シークレット管理（SecretRef、ボールト連携）については、references/secrets.md を参照してください。 サンドボックス化（ツールの Docker 分離）については、references/sandboxing.md を参照してください。 設定フィールドの完全なリファレンスについては、references/config_reference.md を参照してください。 リモートアクセス（SSH、Tailscale、VPN）については、references/remote_access.md を参照してください。

openclaw security audit                 # Check posture
openclaw security audit --deep          # Live gateway probe
openclaw security audit --fix           # Auto-fix safe issues
openclaw secrets reload                 # Re-resolve secret refs
openclaw secrets audit                  # Scan for plaintext leaks

更新／アンインストール

インストール、更新、ロールバック、移行の詳細なガイドについては、references/install.md を参照してください。

# Install (recommended)
curl -fsSL https://openclaw.ai/install.sh | bash

# Update
openclaw update                    # Self-update command
# Or: npm install -g openclaw@latest
openclaw doctor                    # Run after update to apply migrations

# Uninstall
openclaw uninstall

ツールリファレンス

各ツールの詳細なドキュメントについては、references/tools.mdを参照してください。

特定のツールについては、以下を参照してください。

• references/exec.md — Exec ツールの詳細
• references/exec_approvals.md — Exec の承認と許可リスト
• references/browser.md — ブラウザー自動化の詳細
• references/web_tools.md — 複数のプロバイダーを使った Web 検索／取得
• references/lobster.md — Lobster ワークフローランタイム
• references/llm_task.md — 構造化 JSON 出力用の LLM Task
• references/openprose.md — OpenProse のマルチエージェントプログラム
• references/plugins.md — プラグインシステム（インストール、作成、配布）
• references/skills.md — Skills システム（読み込み、設定、ClawHub）

ACP エージェント（Codex、Claude Code、Gemini CLI など）については、references/acp_agents.mdを参照してください。 Diffs プラグインと Firecrawl のアンチボットフォールバックについては、references/diffs_firecrawl.mdを参照してください。 チャットのスラッシュコマンド（/new、/model、/acp など）については、references/slash_commands.mdを参照してください。 思考レベル（/think、/verbose、/reasoning）については、references/thinking.mdを参照してください。 投票（Telegram、WhatsApp、Discord、MS Teams）については、references/polls.mdを参照してください。 トークモードと音声ウェイクについては、references/voice.mdを参照してください。 Gateway のアーキテクチャとワイヤープロトコルについては、references/architecture.mdを参照してください。 エージェントのランタイムとループの詳細については、references/agent_runtime.mdを参照してください。 コマンドキューシステムについては、references/queue.mdを参照してください。 モデルのフェイルオーバーと OAuth については、references/model_failover.mdを参照してください。 ClawHub のスキルレジストリについては、references/clawhub.mdを参照してください。 プレゼンスと検出については、references/presence_discovery.mdを参照してください。 ストリーミングとチャンク分割については、references/streaming.mdを参照してください。 Gateway の内部機能（ネットワークモデル、ロック、ヘルス、doctor、ロギング）については、references/gateway_internals.mdを参照してください。 ハートビートシステムについては、references/heartbeat.mdを参照してください。 Bonjour/mDNS による検出の詳細については、references/bonjour.mdを参照してください。 Gateway ノードのペアリングについては、references/pairing.mdを参照してください。 ターミナル UI（TUI）については、references/tui.mdを参照してください。 メディア（カメラ、画像、音声）については、references/media.mdを参照してください。 チャネルのルーティングとセッションキーについては、references/channel_routing.mdを参照してください。

ツールプロファイル：minimal、coding、messaging、full（デフォルト）。

ツールグループ（許可／拒否に使用）：

• group:runtime — exec、bash、process
• group:fs — read、write、edit、apply_patch
• group:sessions — sessions_list/history/send/spawn、session_status
• group:memory — memory_search、memory_get
• group:web — web_search、web_fetch
• group:ui — browser、canvas
• group:automation — cron、gateway
• group:messaging — message
• group:nodes — nodes
• group:openclaw — OpenClaw のすべての組み込みツール（プロバイダープラグインを除く）

よくある失敗の兆候

エラー	原因	対処方法
refusing to bind gateway ... without auth	ループバック以外へのバインドでトークンが設定されていない	gateway.auth.token または gateway.auth.password を設定します
another gateway instance is already listening / EADDRINUSE	ポートの競合	openclaw gateway --force を実行するか、ポートを変更します
Gateway start blocked: set gateway.mode=local	ローカルモードが有効になっていない	gateway.mode="local" を設定します
unauthorized / reconnect loop	トークンまたはパスワードが一致しない	OPENCLAW_GATEWAY_TOKEN または設定の認証情報を確認します
device identity required	デバイス認証がない	クライアントが connect.challenge フローを完了することを確認します
ボットから返信がない	ペアリング／許可リスト／メンションによる制限	openclaw pairing list、DM ポリシー、メンションパターンを確認します
Embedding provider authentication failed (401)	.env にプレースホルダーの API キー（例：your-jina-api-key-here）が設定されている	~/.openclaw/.env の API キーを実際の値に置き換え、Gateway を再起動します
openclaw flows list / ClawFlow references	ClawFlow は非推奨です	代わりに openclaw tasks list/show/cancel/audit を使用します
config change requires gateway restart (plugins.*)	プラグインの設定変更はホットリロードできません	openclaw gateway restart を完全に実行するか、launchctl kickstart -k を実行します
Bootstrap failed: 5: Input/output error	LaunchAgent plist が古い状態または停止した状態です	openclaw gateway install を実行し、その後 launchctl kickstart -k gui/$(id -u)/ai.openclaw.gateway を実行します
Missing env var "X" referenced at config path: ...	.env がないか、変数が定義されていない	~/.openclaw/.env に変数を追加し、Gateway を再起動します

環境変数

変数	用途
OPENCLAW_GATEWAY_TOKEN	Gateway 認証トークン
OPENCLAW_GATEWAY_PASSWORD	Gateway 認証パスワード
OPENCLAW_GATEWAY_PORT	Gateway ポートの上書き
OPENCLAW_CONFIG_PATH	設定ファイルパスの上書き
OPENCLAW_STATE_DIR	状態ディレクトリの上書き
OPENCLAW_HOME	ホームディレクトリの上書き
OPENCLAW_LOAD_SHELL_ENV	シェル環境変数をインポート（1 に設定）
OPENCLAW_VERBOSE	詳細なログ出力
OPENCLAW_LOG_FILE	ログファイルのパス
OPENCLAW_LOG_LEVEL	ログレベルの制御
OPENCLAW_SHELL	exec/acp/tui ランタイムで OpenClaw によって設定されます
BRAVE_API_KEY	web_search ツール用
FIRECRAWL_API_KEY	Firecrawl のアンチボット機能のフォールバック用
ELEVENLABS_API_KEY	Talk Mode の TTS 用
ELEVENLABS_VOICE_ID	Talk Mode のデフォルト音声
CLAWHUB_TOKEN	CI／自動化用の ClawHub API トークン
CLAWHUB_WORKDIR	ClawHub の作業ディレクトリの上書き
OLLAMA_API_KEY	Ollama 埋め込みプロバイダー用
OPENCLAW_SKIP_CRON	cron スケジューラーを無効化（1 に設定）
OPENCLAW_HIDE_BANNER	バナー出力を抑制
OPENCLAW_SUPPRESS_NOTES	情報メモを抑制