API リファレンス

OpenClaw Gateway は REST API を提供し、外部プログラムがエージェントと対話できるようにします。API はデフォルトで http://127.0.0.1:18789 でリッスンします。

セキュリティ警告

Gateway API はローカルマシンでのみ使用してください。18789 ポートを絶対に公開ネットワークに露出しないでください。リモートアクセスが必要な場合は SSH トンネルまたは VPN を使用してください。

認証

すべての API リクエストでは Header に認証トークンを含める必要があります：

curl -H "Authorization: Bearer YOUR_GATEWAY_TOKEN" \
  http://127.0.0.1:18789/api/v1/health

すべてのエラーレスポンスは統一形式に準拠：

{
  "error": "error_code",
  "message": "人間が読めるエラー説明",
  "status": 400,
  "details": {}
}