Contents
1. OpenClaw とは？
OpenClaw は ローカルで動作するオープンソース AI アシスタント です。Claude、GPT 系列、あるいは独自モデルをプラグインとして組み込み、30 を超えるプラットフォーム（Slack、Telegram、GitHub、Google カレンダー等）へタスクの自動化・要約・通知を提供します。
- マルチモデル切替 API
同一スクリプト内でmodel="gpt‑4o-mini"→model="claude-3.5-sonnet"と簡単に切り替え可能。 - CLI 拡張
claw runに cron・systemd 用ラッパーが組み込まれ、定期実行が数行で完結。 - 予算・トークン管理 (harmonic_society)
月額予算やモデル別トークン使用量をリアルタイムで監視し、上限超過時は自動停止／アラートを発行。
※2026 年5月現在（GitHub の
v2.5.0リリースノート）
公式サイト https://openclaw.ai/ と GitHub リポジトリ https://github.com/openclaw/openclaw にて、最新安定版は v2.5.0（2026‑04‑28 公開）と記載されています。[1]
2. インストール手順
2.1 リポジトリの取得
|
1 2 3 |
git clone https://github.com/openclaw/openclaw.git cd openclaw |
openclawディレクトリには、サンプルコード、CLI ヘルパー、CI 設定がすべて格納されています。
2.2 Python 仮想環境の作成
|
1 2 3 |
python3 -m venv .venv # 推奨は Python 3.11 以上 source .venv/bin/activate # Windows の場合: .venv\Scripts\activate |
2.3 必要パッケージのインストール
|
1 2 3 4 |
pip install --upgrade pip pip install -r requirements.txt # OpenClaw 本体の依存 pip install harmonic_society==0.4.1 # 予算管理モジュール（2026‑05 時点） |
requirements.txt に記載されたバージョンはリポジトリが保証する互換性のある組み合わせです。
2.4 動作確認
|
1 2 3 |
claw --version # → claw 2.5.0 claw doctor # 環境診断（依存関係・API キーの有無をチェック） |
3. Python から OpenClaw エージェントを呼び出す
3.1 必要なインポートと認証情報取得
|
1 2 3 4 5 6 7 8 |
import os # ← 重要：環境変数取得に必須 from openclaw import Client from harmonic_society import BudgetManager # API キーは .env またはシステム環境変数からロード api_key = os.getenv("OPENCLAW_API_KEY") client = Client(api_key=api_key) |
3.2 予算管理オブジェクトの設定（任意 but 推奨）
|
1 2 3 4 5 6 7 |
budget = BudgetManager( limit_usd=200, # 月額上限 $200 alert_threshold=0.8, # 使用率 80% 超でメール通知 notification_email="finops@example.com" ) client.attach_budget_manager(budget) |
3.3 タスク実行例
|
1 2 3 4 5 6 7 8 9 10 11 12 |
# 1️⃣ Slack 未読メッセージの要約 → Telegram に転送 response = client.run( prompt=( "未読の Slack メッセージをすべて要約し、" "Telegram の #updates チャンネルへ Markdown 形式で送信してください。" ), model="claude-3.5-sonnet", output="telegram:#updates" ) print("✅ 成功:", response.summary) # 要約結果が標準出力に表示される |
client.run は内部でタスク分解とエージェントチェーンを自動的に実行するため、開発者は「何をしたいか」だけを書けば完了します。
4. 実務で使える自動化シナリオ
4.1 朝のブリーフィング（8:00 定時配信）
スクリプト samples/briefing.py
|
1 2 3 4 5 6 7 8 9 10 11 |
import os from openclaw import Client client = Client(api_key=os.getenv("OPENCLAW_API_KEY")) prompt = """ 社内ニュース、外部テックメディア、天気予報を要約し、Markdown で出力してください。 """ result = client.run(prompt=prompt, model="gpt-4o-mini") print(result.content) # 標準出力へ送るだけで CLI が受け取れる |
cron 登録例
|
1 2 3 4 5 |
0 8 * * * /home/ubuntu/openclaw/.venv/bin/claw run \ --script /home/ubuntu/openclaw/samples/briefing.py \ --output slack:#general \ >> /var/log/openclaw_brief.log 2>&1 |
ポイント：CLI と cron のみで「取得 → 要約 → 配信」のフローが自動化でき、運用コストが大幅に削減できます。
4.2 Slack 未読要約 ↔︎ Telegram 転送（毎時実行）
|
1 2 3 4 5 6 |
0 * * * * /home/ubuntu/openclaw/.venv/bin/claw run \ --prompt "未読の Slack メッセージをすべて要約し、Telegram の #updates に投稿してください。" \ --model claude-3.5-sonnet \ --output telegram:#updates \ >> /var/log/openclaw_slack2tg.log 2>&1 |
上記は 1 時間ごとに実行され、最新の未読情報がリアルタイムでチームに共有されます。
4.3 ジョブ結果の通知（成功/失敗フック）
|
1 2 3 4 5 6 7 8 |
0 9 * * * /home/ubuntu/openclaw/.venv/bin/claw run \ --script /home/ubuntu/openclaw/samples/briefing.py \ --output slack:#general \ --on-success "echo 'ブリーフィング完了' | mail -s 'OpenClaw Success' ops@example.com" \ --on-failure "curl -X POST -H 'Content-Type: application/json' \ --data '{\"text\":\"⚠️ OpenClaw ブリーフィング失敗\"}' \ https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXX" |
- 成功時：システムメールで通知
- 失敗時：Slack Webhook にエラーメッセージを即送信
この仕組みは運用監視の可観測性を高め、インシデント対応時間を短縮します。
5. ベストプラクティス
| 項目 | 推奨設定 |
|---|---|
| コード管理 | Git リポジトリで全スクリプトと claw.yml（ジョブ定義）をバージョン管理 |
| 予算管理 | harmonic_society.BudgetManager を必ず導入し、上限・アラートを設定 |
| 環境分離 | プロジェクトごとに Python 仮想環境 (venv) と .env ファイルで API キーを管理 |
| ログ出力 | claw run --log-level INFO > /var/log/openclaw_<job>.log 2>&1 を活用し、トラブル時は JSON ログを解析 |
| セキュリティ | API キーは Git にコミットせず、OS のシークレット管理（AWS Secrets Manager 等）と連携 |
6. 参考情報
[1] OpenClaw GitHub Releases – https://github.com/openclaw/openclaw/releases/tag/v2.5.0 (閲覧日: 2026‑05‑02)
[2] OpenClaw 公式ドキュメント – https://docs.openclaw.ai/ (2026 年版)
[3] harmonic_society パッケージ – https://pypi.org/project/harmonic-society/
本稿は 2026‑05‑02 時点で入手可能な公式情報を基に作成しています。バージョンや機能が将来変更される場合がありますので、導入前にリポジトリの README.md と CHANGELOG.md を必ず確認してください。