OpenClaw v2026.3.13 CLIコマンドリファレンス
OpenClaw v2026.3.13はAIアシスタント/ゲートウェイのCLIツールです。コマンドはグローバルオプション、基本、ゲートウェイ、チャンネル、モデル、エージェント、ブラウザ、セキュリティ、プラグイン、ユーティリティのカテゴリに分類されています。以下に詳細な解説を記載します。
一、グローバルオプション(全コマンド共通)
| オプション | 説明 |
|---|---|
-h, --help |
コマンドヘルプを表示 |
-V, --version |
バージョン情報を表示 |
--dev |
開発モードで実行(状態は~/.openclaw-devに分離)、デフォルトポートは19001 |
--profile <name> |
指定された名前のプロファイルを使用(状態は~/.openclaw-<name>に保存) |
--log-level <level> |
ログレベルを設定:silent/fatal/error/warn/info/debug/trace |
--no-color |
カラー出力を無効化 |
--json |
JSON形式で出力(対応コマンドのみ) |
--non-interactive |
非対話モードで実行(プロンプトを表示しない) |
二、基本コマンド(インストール/設定/診断)
1. インストール/アップグレード/アンインストール
# グローバルインストール
npm install -g openclaw
# アップグレード
npm update -g openclaw
# アンインストール
npm uninstall -g openclaw
# 最新版を直接実行
npx openclaw@latest
2. 初期化と設定
-
openclaw onboard:対話型設定ウィザード(モデル/チャンネル/ゲートウェイの設定) -
openclaw configure:再設定(--resetオプションで初期化可能) -
openclaw config:非対話型設定管理 -
config get <path>:設定値の読み取り -
config set <path> <value>:設定値の変更 -
config unset <path>:設定値の削除 -
config validate:設定の妥当性検証
3. 診断と修復
-
openclaw doctor:システムチェックと自動修復 -
--deep:システムサービスの深層スキャン -
--yes:修復プロンプトを自動で承認 -
openclaw status:ゲートウェイ/チャンネル/セッションの状態確認 -
--all:完全な診断情報 -
--deep:チャンネルの詳細検出 -
--usage:モデル使用量の表示 -
openclaw health:ゲートウェイのヘルスチェック -
openclaw logs:ゲートウェイログの閲覧 -
--follow:リアルタイムでのログ追跡 -
--lines <n>:表示行数の指定(デフォルト200行)
4. リセット/アンインストール
-
openclaw reset:設定/状態のリセット -
--scope <config|config+creds+sessions|full>:リセット範囲の指定 -
--yes:実行の自動確認 -
openclaw uninstall:ゲートウェイサービスとデータの完全削除 -
--all:すべてのデータを削除
三、ゲートウェイコマンド(コアサービス)
1. ゲートウェイの実行と管理
-
openclaw gateway run:ゲートウェイの起動 -
--port <port>:ポート番号の指定(デフォルト18789) -
--bind <loopback|lan|tailnet|auto>:バインドアドレスの設定 -
--token <token>:ゲートウェイ認証トークンの指定 -
openclaw gateway service:システムサービスの管理 -
gateway install:システムサービスとしてインストール -
gateway start/stop/restart:サービスの開始/停止/再起動 -
gateway status:サービスの状態確認
2. ゲートウェイRPC呼び出し
openclaw gateway call <method> --params <json>:ゲートウェイRPCメソッドの呼び出しopenclaw gateway probe:ゲートウェイ接続性の検証
四、チャンネルコマンド(IM統合)
対応プラットフォーム:whatsapp|telegram|discord|slack|signal|imessage|msteams
1. チャンネル管理
openclaw channels list:すべてのチャンネルの一覧表示openclaw channels add --channel <name> --account <id> --token <token>:チャンネルの追加openclaw channels remove --channel <name> --account <id> --delete:チャンネルの削除openclaw channels status --probe:チャンネルのヘルスチェックopenclaw channels logs --channel <name>:チャンネルログの閲覧
2. ログイン/ログアウト
openclaw channels login --channel whatsapp:WhatsApp Webへのログインopenclaw channels logout --channel <name>:チャンネルからのログアウト
五、モデルコマンド
-
openclaw models list:利用可能なモデルの一覧表示 -
openclaw models status:モデル認証状態の確認 -
--probe:認証状態のリアルタイム検証 -
openclaw models set <model-id>:デフォルトモデルの設定 -
openclaw config set providers.<provider>.apikey <key>:APIキーの設定
六、エージェントとメッセージング
1. エージェント管理
openclaw agents add <name> --workspace <dir>:新しいエージェントの作成openclaw agents list --bindings:エージェントとバインディングの一覧表示openclaw agents bind --agent <id> --bind <channel[:account]>:チャンネルへのバインドopenclaw agents delete <id>:エージェントの削除
2. メッセージ送信
openclaw message send --target <id> --message "text":メッセージの送信openclaw message poll --channel discord --question "?" --option A --option B:投票の作成
七、ブラウザ自動化(v2026.3.13新機能)
openclaw browser start --profile openclaw:ホスト型ブラウザの起動openclaw browser open <url>:指定URLのページを開くopenclaw browser click <ref>:要素のクリックopenclaw browser type <ref> <text>:テキストの入力openclaw browser screenshot --full-page:フルページスクリーンショットの撮影openclaw browser snapshot:ページ構造のスナップショット(AI利用可能)
八、セキュリティと監査
-
openclaw security audit:セキュリティ監査の実行 -
--deep:ゲートウェイの深層スキャン -
--fix:セキュリティ問題の自動修復 -
openclaw secrets configure:シークレットキーの管理 -
openclaw pairing approve <channel>:デバイスペアリングの承認 -
openclaw devices list:ペアリング済みデバイスの管理
九、プラグインとスキル
1. プラグイン管理
openclaw plugins list:インストール済みプラグインの一覧表示openclaw plugins install <id>:プラグインのインストールopenclaw plugins enable/disable <id>:プラグインの有効化/無効化
2. スキル管理
openclaw skills list:利用可能なスキルの一覧表示openclaw skills install <name>:スキルのインストール(npx clawhubを使用)openclaw skills check:スキル依存関係のチェック
十、ユーティリティ
-
openclaw dashboard:Webコンソールの起動 -
openclaw tui:ターミナルUI対話モード -
openclaw exec <command>:シェルコマンドの実行(サンドボックス環境) -
--host sandbox/gateway/node:実行環境の指定 -
--timeout <sec>:タイムアウト時間の設定(デフォルト1800秒) -
openclaw sessions:対話セッションの管理 -
openclaw update:CLIのアップデートチェックと適用
十一、よく使用するコマンドのクイックリファレンス
# クイック設定
openclaw onboard
# ゲートウェイ起動
openclaw gateway run
# 状態確認
openclaw status --all --deep
# ログ確認
openclaw logs --follow
# ヘルスチェック
openclaw doctor --deep --yes
# メッセージ送信
openclaw message send --target telegram:123456 --message "こんにちは"
# ブラウザ自動化
openclaw browser start --profile openclaw
openclaw browser open https://example.com
十二、完全なアンインストール
# ステップ1:実行中のサービスを停止
openclaw daemon stop
# ステップ2:systemdサービスが設定されている場合は無効化して削除
systemctl --user stop openclaw-gateway 2>/dev/null
systemctl --user disable openclaw-gateway 2>/dev/null
rm -f ~/.config/systemd/user/openclaw-gateway.service
systemctl --user daemon-reload
# ステップ3:グローバルnpmパッケージをアンインストール
npm uninstall -g openclaw
# ステップ4:設定とデータディレクトリを削除(⚠️注意:すべてのデータとログが削除されます)
rm -rf ~/.openclaw
# ステップ5:npmキャッシュの残骸をクリーンアップ
npm cache clean --force
# ステップ6:アンインストールが完了したことを確認
which openclaw # 'command not found'と表示されるはず
ls ~/.openclaw 2>&1 # 'No such file or directory'と表示されるはず
systemctl --user status openclaw-gateway 2>&1 # 'Unit not found'と表示されるはず