openclaw-cli

OpenClaw CLI

openclaw コマンドラインインターフェースの操作に関する完全なリファレンスです。

使用する場面

OpenClaw ゲートウェイ、エージェント、チャンネル、スキル、フック、自動化を管理するときに使用します。

基本コマンド

セットアップとオンボーディング

初期セットアップ：

# Quick onboarding with daemon install
openclaw onboard --install-daemon

# Setup workspace and config
openclaw setup --workspace ~/.openclaw/workspace

# Interactive configuration
openclaw configure

ヘルスチェック：

openclaw doctor

ゲートウェイ管理

ゲートウェイを実行：

# Interactive mode
openclaw gateway

# With specific port
openclaw gateway --port 18789

# With tailscale
openclaw gateway --tailscale serve

ゲートウェイサービス：

# Install as system service
openclaw gateway install

# Control service
openclaw gateway start
openclaw gateway stop
openclaw gateway restart
openclaw gateway status

ゲートウェイのヘルスチェック：

openclaw status
openclaw status --deep     # Probe channels
openclaw health

エージェント管理

エージェント一覧：

openclaw agents list
openclaw agents list --bindings    # Show routing

エージェントを追加：

# Interactive wizard
openclaw agents add <name>

# Non-interactive
openclaw agents add dev \
  --workspace ~/.openclaw/workspace-dev \
  --model claude-sonnet-4.5 \
  --non-interactive

エージェントを削除：

openclaw agents delete <id>

アイデンティティを設定：

# From IDENTITY.md
openclaw agents set-identity --agent main --from-identity

# Explicit values
openclaw agents set-identity --agent main \
  --name "MyAgent" \
  --emoji "🤖" \
  --avatar avatars/bot.png

スキル管理

スキル一覧：

openclaw skills list
openclaw skills list --eligible    # Only ready skills
openclaw skills list --json        # JSON output

スキル情報：

openclaw skills info <skill-name>

利用可否を確認：

openclaw skills check

フック管理

フック一覧：

openclaw hooks list
openclaw hooks list --eligible
openclaw hooks list --verbose      # Show missing requirements

フック情報：

openclaw hooks info <hook-name>

有効化／無効化：

openclaw hooks enable session-memory
openclaw hooks disable command-logger

フックをインストール：

# From npm
openclaw hooks install @openclaw/my-hooks

# Local directory
openclaw hooks install ./my-hooks

# Link (development)
openclaw hooks install -l ./my-hooks

フックを更新：

openclaw hooks update <id>
openclaw hooks update --all

チャンネル管理

チャンネル一覧：

openclaw channels list

チャンネルのステータス：

openclaw channels status
openclaw channels status --probe

チャンネルを追加：

# Interactive
openclaw channels add

# Telegram bot
openclaw channels add --channel telegram \
  --account alerts \
  --name "Alerts Bot" \
  --token $TELEGRAM_BOT_TOKEN

# Discord
openclaw channels add --channel discord \
  --account work \
  --token $DISCORD_BOT_TOKEN

チャンネルを削除：

openclaw channels remove --channel telegram --account alerts
openclaw channels remove --channel discord --account work --delete

WhatsApp にログイン：

openclaw channels login --channel whatsapp

チャンネルログ：

openclaw channels logs
openclaw channels logs --channel whatsapp --lines 100

モデルと認証

ステータス：

openclaw models status
openclaw models status --probe               # Live check
openclaw models status --probe-provider anthropic

モデル一覧：

openclaw models list
openclaw models list --all
openclaw models list --provider anthropic

デフォルトを設定：

openclaw models set claude-sonnet-4.5
openclaw models set-image claude-sonnet-4.5

認証をセットアップ：

# Anthropic (recommended)
claude setup-token
openclaw models auth setup-token --provider anthropic

# Or paste token
openclaw models auth paste-token --provider anthropic

フォールバック：

openclaw models fallbacks list
openclaw models fallbacks add claude-opus-4.6
openclaw models fallbacks remove claude-haiku-4.5
openclaw models fallbacks clear

モデルをスキャン：

openclaw models scan
openclaw models scan --set-default

メッセージング

メッセージを送信：

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

# Discord channel
openclaw message send \
  --channel discord \
  --target channel:123456 \
  --message "Deployment complete"

投票を送信：

openclaw message poll \
  --channel discord \
  --target channel:123 \
  --poll-question "Lunch?" \
  --poll-option "Pizza" \
  --poll-option "Sushi"

その他のメッセージ操作：

openclaw message read --target +15555550123
openclaw message react --target <id> --emoji "👍"
openclaw message edit --target <id> --message "Updated"
openclaw message delete --target <id>

ブラウザー制御

ステータスと制御：

openclaw browser status
openclaw browser start
openclaw browser stop
openclaw browser tabs

移動：

openclaw browser open https://example.com
openclaw browser navigate https://example.com --target-id <id>

操作：

openclaw browser click "#submit-button"
openclaw browser type "#email" "[email protected]"
openclaw browser press Enter

キャプチャ：

openclaw browser screenshot
openclaw browser screenshot --full-page
openclaw browser snapshot --format ai

プロファイル：

openclaw browser profiles
openclaw browser create-profile --name dev
openclaw browser delete-profile --name old

ノードとデバイス

ノード一覧：

openclaw nodes list
openclaw nodes status --connected

ノード操作：

# Describe node
openclaw nodes describe --node <id>

# Run command on node
openclaw nodes run --node <id> --cwd /path -- ls -la

# Notify (macOS)
openclaw nodes notify --node <id> \
  --title "Build Complete" \
  --body "Success" \
  --sound default

カメラ：

openclaw nodes camera list --node <id>
openclaw nodes camera snap --node <id> --facing front
openclaw nodes camera clip --node <id> --duration 10s

キャンバス：

openclaw nodes canvas snapshot --node <id>
openclaw nodes canvas present --node <id> --target index.html
openclaw nodes canvas hide --node <id>

画面録画：

openclaw nodes screen record --node <id> --duration 30s

システムコマンド

システムイベント：

openclaw system event --text "Deployment complete" --mode now

ハートビート：

openclaw system heartbeat last
openclaw system heartbeat enable
openclaw system heartbeat disable

プレゼンス：

openclaw system presence

Cron ジョブ

ジョブ一覧：

openclaw cron list
openclaw cron list --all
openclaw cron status

ジョブを追加：

# System event every hour
openclaw cron add \
  --name "hourly-check" \
  --every "1h" \
  --system-event "Hourly check"

# Message at specific time
openclaw cron add \
  --name "morning-reminder" \
  --at "09:00" \
  --message "Good morning!"

ジョブを管理：

openclaw cron enable <id>
openclaw cron disable <id>
openclaw cron rm <id>
openclaw cron run <id>

ジョブの実行履歴：

openclaw cron runs --id <id> --limit 10

設定

設定の取得／設定：

# Get value
openclaw config get agents.defaults.model.primary

# Set value
openclaw config set agents.defaults.model.primary "claude-sonnet-4.5"

# Unset value
openclaw config unset some.config.path

メモリー操作

メモリーのステータス：

openclaw memory status

メモリーをインデックス化：

openclaw memory index

メモリーを検索：

openclaw memory search "GraphQL implementation patterns"

ログ

ログを末尾から表示：

openclaw logs
openclaw logs --follow
openclaw logs --limit 200
openclaw logs --json

サンドボックス

サンドボックス一覧：

openclaw sandbox list

サンドボックスを再作成：

openclaw sandbox recreate

セキュリティ

セキュリティ監査：

openclaw security audit
openclaw security audit --deep
openclaw security audit --fix

プラグイン

プラグイン一覧：

openclaw plugins list
openclaw plugins list --json

プラグイン情報：

openclaw plugins info <plugin-id>

プラグインをインストール：

openclaw plugins install <path-or-spec>

有効化／無効化：

openclaw plugins enable <id>
openclaw plugins disable <id>

プラグインのヘルスチェック：

openclaw plugins doctor

更新とメンテナンス

OpenClaw を更新：

openclaw update

設定をリセット：

openclaw reset --scope config
openclaw reset --scope config+creds+sessions
openclaw reset --scope full

アンインストール：

openclaw uninstall --service
openclaw uninstall --state
openclaw uninstall --workspace
openclaw uninstall --all

グローバルフラグ

すべての場所で使用可能：

--dev               # Use ~/.openclaw-dev for isolation
--profile <name>    # Use ~/.openclaw-<name>
--no-color         # Disable ANSI colors
--json             # Machine-readable output
-V, --version      # Show version

よく使うワークフロー

初回セットアップ

# 1. Onboard with daemon
openclaw onboard --install-daemon

# 2. Pair WhatsApp (or other channel)
openclaw channels login

# 3. Start gateway
openclaw gateway

# 4. Test with message
openclaw message send --target +1234567890 --message "Test"

マルチエージェントのセットアップ

# 1. Add agent
openclaw agents add work --workspace ~/.openclaw/workspace-work

# 2. Set identity
openclaw agents set-identity --agent work --from-identity

# 3. Add binding (in openclaw.json)
# bindings: [{ agentId: "work", match: { channel: "discord" } }]

# 4. List to verify
openclaw agents list --bindings

フックの自動化

# 1. Enable session memory hook
openclaw hooks enable session-memory

# 2. Enable command logger
openclaw hooks enable command-logger

# 3. Verify
openclaw hooks check

# 4. Restart gateway
openclaw gateway restart

チャンネルのセットアップ

# 1. Add Telegram bot
openclaw channels add --channel telegram \
  --account alerts \
  --token $TELEGRAM_BOT_TOKEN

# 2. Verify
openclaw channels status

# 3. Send test message
openclaw message send --channel telegram \
  --target <chat-id> \
  --message "Bot online"

モデルの設定

# 1. Setup auth
claude setup-token

# 2. Set default model
openclaw models set claude-sonnet-4.5

# 3. Add fallbacks
openclaw models fallbacks add claude-opus-4.6
openclaw models fallbacks add claude-haiku-4.5

# 4. Verify
openclaw models status

デバッグ

ゲートウェイのステータスを確認：

openclaw status --deep
openclaw doctor
openclaw health

ログを表示：

openclaw logs --follow
openclaw channels logs --lines 200

チャンネルをテスト：

openclaw channels status --probe

スキル／フックを確認：

openclaw skills check
openclaw hooks check
openclaw plugins doctor

ヒント

1. スクリプトでは --json を使用します - すべてのコマンドが JSON 出力に対応しています
2. プロファイルで分離します - --profile を使うと、メイン設定に影響を与えずにテストできます
3. Doctor で問題を修正します - 問題を検出するために、定期的に openclaw doctor を実行します
4. ログの保存場所 - ファイルログは ~/.openclaw/logs/ にあります
5. 設定の保存場所 - ~/.openclaw/openclaw.json
6. ワークスペース - ~/.openclaw/workspace（またはカスタムパス）

リソース

• OpenClaw ドキュメント
• CLI リファレンス
• マルチエージェントルーティング
• フックシステム
• スキルシステム