OpenClaw CLIコマンド完全ガイド

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'と表示されるはず

タグ: OpenClaw CLI AIアシスタント ゲートウェイ チャンネル統合

6月23日 18:25 投稿