Адміністративний HTTP RPC Plugin

• POST /api/v1/admin/rpc
• той самий слухач, що й Gateway: http://<gateway-host>:<port>/api/v1/admin/rpc

​

Перед увімкненням

• Викликачу довірено керувати Gateway.
• Викликач не може використовувати клієнт WebSocket RPC.
• Маршрут доступний лише через loopback, tailnet або приватний автентифікований ingress.
• Ви переглянули дозволені методи, і вони відповідають автоматизації, яку ви плануєте запускати.

​

Увімкнення

openclaw plugins enable admin-http-rpc
openclaw gateway restart

{
  plugins: {
    entries: {
      "admin-http-rpc": { enabled: true },
    },
  },
}

openclaw plugins disable admin-http-rpc
openclaw gateway restart

​

Перевірка маршруту

curl -sS http://<gateway-host>:<port>/api/v1/admin/rpc \
  -H 'Authorization: Bearer <gateway-token>' \
  -H 'Content-Type: application/json' \
  -d '{"method":"health","params":{}}'

{
  "id": "generated-request-id",
  "ok": true,
  "payload": {
    "status": "ok"
  }
}

​

Автентифікація

• автентифікація зі спільним секретом (gateway.auth.mode="token" або "password"): Authorization: Bearer <token-or-password>
• довірена HTTP-автентифікація з ідентичністю (gateway.auth.mode="trusted-proxy"): маршрутизуйте через налаштований identity-aware proxy і дозвольте йому вставити потрібні заголовки ідентичності
• відкритий доступ через приватний ingress (gateway.auth.mode="none"): заголовок автентифікації не потрібен

​

Модель безпеки

• Увімкнення Plugin навмисно надає доступ до дозволених адміністративних методів RPC за адресою /api/v1/admin/rpc.
• Plugin оголошує зарезервований контракт маніфесту contracts.gatewayMethodDispatch: ["authenticated-request"], щоб його HTTP-маршрут, автентифікований Gateway, міг диспетчеризувати методи площини керування в процесі.
• Bearer-автентифікація зі спільним секретом підтверджує володіння операторським секретом gateway.
• Для автентифікації token і password вужчі заголовки x-openclaw-scopes ігноруються, а звичайні повні операторські значення за замовчуванням відновлюються.
• Довірені HTTP-режими з ідентичністю враховують x-openclaw-scopes, коли він наявний.
• gateway.auth.mode="none" означає, що цей маршрут не автентифікований, якщо Plugin увімкнено. Використовуйте це лише за приватним ingress, якому ви повністю довіряєте.
• Запити диспетчеризуються через ті самі обробники методів Gateway і перевірки scope, що й WebSocket RPC, після успішної автентифікації маршруту Plugin.
• Тримайте цей маршрут на loopback, tailnet або приватному довіреному ingress. Не відкривайте його напряму для публічного інтернету.
• Контракти маніфесту Plugin не є sandbox. Вони запобігають випадковому використанню зарезервованих допоміжних засобів SDK; довірені Plugin усе одно виконуються в процесі Gateway.

​

Запит

POST /api/v1/admin/rpc
Authorization: Bearer <gateway-token>
Content-Type: application/json

{
  "id": "optional-request-id",
  "method": "health",
  "params": {}
}

• id (рядок, необов’язково): копіюється у відповідь. UUID генерується, якщо поле пропущено.
• method (рядок, обов’язково): назва дозволеного методу Gateway.
• params (будь-що, необов’язково): параметри, специфічні для методу.

​

Відповідь

{
  "id": "optional-request-id",
  "ok": true,
  "payload": {}
}

{
  "id": "optional-request-id",
  "ok": false,
  "error": {
    "code": "INVALID_REQUEST",
    "message": "bad params"
  }
}

​

Дозволені методи

• discovery: commands.list Повертає назви методів HTTP RPC, дозволені цим Plugin.
• gateway: health, status, logs.tail, usage.status, usage.cost, gateway.restart.request
• config: config.get, config.schema, config.schema.lookup, config.set, config.patch, config.apply
• channels: channels.status, channels.start, channels.stop, channels.logout
• web: web.login.start, web.login.wait
• models: models.list, models.authStatus
• agents: agents.list, agents.create, agents.update, agents.delete
• approvals: exec.approvals.get, exec.approvals.set, exec.approvals.node.get, exec.approvals.node.set
• cron: cron.status, cron.list, cron.get, cron.runs, cron.add, cron.update, cron.remove, cron.run
• devices: device.pair.list, device.pair.approve, device.pair.reject, device.pair.remove
• nodes: node.list, node.describe, node.pair.list, node.pair.approve, node.pair.reject, node.pair.remove, node.rename
• tasks: tasks.list, tasks.get, tasks.cancel
• diagnostics: doctor.memory.status, update.status

​

Порівняння з WebSocket

​

Усунення несправностей

​

Пов’язане

• Операторські scope
• Безпека Gateway
• Віддалений доступ
• Маніфест Plugin
• Підшляхи SDK