コマンド概要
openclaw agent コマンドを使うと、コマンドラインから直接AIに単発リクエストを送信してレスポンスを取得できます。チャンネルを経由する必要がないため、クイックテスト、スクリプト連携、自動化ワークフローに最適です。
基本的な使い方
openclaw agent "こんにちは、自己紹介をお願いします"
出力：
こんにちは！OpenClaw AIアシスタントです。質問への回答、コード作成、
テキスト翻訳などのお手伝いができます。何かお手伝いできることはありますか？
モデルの指定
# 設定で定義済みのモデルエイリアスを使用
openclaw agent --model gpt-4o "量子コンピューティングの基本原理を説明してください"
# プロバイダーとモデル名を指定
openclaw agent --provider openai --model gpt-4o-mini "ソートアルゴリズムを書いてください"
システムプロンプトの指定
openclaw agent \
--system "あなたはプロのPythonプログラマーです。Pythonのみで回答してください" \
"二分木の中順走査を実装してください"
標準入力からの読み取り
# パイプ入力
echo "英語に翻訳：今日はいい天気です" | openclaw agent
# ファイルから読み取り
cat error.log | openclaw agent "このログのエラー原因を分析してください"
# ヒアドキュメント
openclaw agent <<EOF
以下のコードをレビューしてください：
def add(a, b):
return a - b
EOF
ストリーミング出力
# ストリーミング出力を有効化（リアルタイムで生成内容を表示）
openclaw agent --stream "AIに関する短い文章を書いてください"
出力フォーマット
# プレーンテキスト（デフォルト）
openclaw agent "こんにちは"
# JSON形式
openclaw agent --format json "こんにちは"
JSON出力：
{
"content": "こんにちは！何かお手伝いできることはありますか？",
"model": "gpt-4o-mini",
"usage": {
"promptTokens": 12,
"completionTokens": 15,
"totalTokens": 27
},
"latency": 850
}
モデルパラメータの調整
openclaw agent \
--temperature 0.2 \
--max-tokens 1000 \
--top-p 0.9 \
"プロジェクト名を5つ提案してください"
ツールの使用
AIにツールの呼び出しを許可します。
openclaw agent --tools web_search "今日の東京の天気はどうですか？"
openclaw agent --tools code_exec "fibonacci(30)の値を計算してください"
# 複数のツール
openclaw agent --tools web_search,code_exec "Pythonの最新バージョンを検索してテストコードを実行してください"
マルチターン会話
agent は主に単発呼び出し用ですが、簡易的なマルチターン会話にも対応しています。
# セッションIDでコンテキストを維持
openclaw agent --session my-test "私の名前は田中です"
openclaw agent --session my-test "私の名前は何ですか？"
# 出力: あなたの名前は田中です。
スクリプト連携の例
シェルスクリプトでの使用
#!/bin/bash
# Git commit メッセージの自動生成
DIFF=$(git diff --cached)
MESSAGE=$(echo "$DIFF" | openclaw agent --model gpt-4o-mini \
--system "git diffから簡潔なcommit messageを生成してください。messageのみを出力し、他の内容は含めないでください" \
--format text)
git commit -m "$MESSAGE"
バッチ処理
#!/bin/bash
# ファイルの一括翻訳
for file in docs/*.md; do
openclaw agent --model gpt-4o-mini \
--system "以下のMarkdownコンテンツを英語に翻訳してください。フォーマットは維持してください" \
< "$file" > "translated/$(basename $file)"
done
jq との連携
# JSONの特定フィールドを抽出
openclaw agent --format json "ランダムなユーザーデータを3件生成してください" | jq '.content'
終了コード
0：成功1：一般エラー2：認証エラー3：モデル利用不可4：レート制限
openclaw agent "テスト" || echo "呼び出し失敗、終了コード: $?"
タイムアウト設定
openclaw agent --timeout 30 "複雑な質問..."
デバッグモード
openclaw agent --debug "こんにちは"
リクエストとレスポンスの詳細情報が出力されます。
[DEBUG] Provider: openai
[DEBUG] Model: gpt-4o-mini
[DEBUG] Request tokens: 12
[DEBUG] Response time: 850ms
[DEBUG] Response tokens: 15
こんにちは！何かお手伝いできることはありますか？
まとめ
openclaw agent は OpenClaw CLI で最も柔軟なコマンドの一つであり、AI の機能を直接コマンドラインに持ち込みます。他の Unix ツールと同様にパイプ、スクリプト、自動化フローと組み合わせて使用できます。