#openclaw#web-ui#configuration#setup#bindings

設定ファイルを触らなくてもいい: Web UI だけで OpenClaw を設定する

5 min read

最初から JSON を編集させるチュートリアルは、人を驚かせて追い返しがちです。ここで伝えたいのはひとつ。ちゃんとクリックできる UI があります。

このページで学べること

  • Web UI を開いて認証を済ませる
  • フォームモードと Raw JSON モードの違い
  • UI から複数 Workspace の振り分けを設定する
  • 主要機能がどこにあるか

Web UI を開く

手順 1: Gateway が動いていることを確認

openclaw gateway

手順 2: ブラウザを開く

http://127.0.0.1:18789/

basePath を設定している場合、たとえば /openclaw なら:

http://127.0.0.1:18789/openclaw

手順 3: 認証に対応する

表示 対処
pairing required openclaw devices list の後に openclaw devices approve <requestId>
token を求められる オンボーディング時の token を貼る

💡 UI の言語は Access セクションで変更できます。

Config の編集方法は 2 つ: フォームモード vs Raw JSON

Config ページには 2 つの編集スタイルがあります。

フォームモード: 見た目が分かりやすく、初心者や小さな変更向き。

Raw JSON モード: 直接設定を書くので、上級者や大きな変更向き。

どちらも同じ ~/.openclaw/openclaw.json を編集しています。

いちばんよくある設定: Telegram グループごとに別 Agent を使う

シナリオ A: 同じ Bot、違うグループ、違う Workspace

Raw JSON に切り替えて、次のような構成を入れます。

{
  "agents": {
    "list": [
      { "id": "main",      "name": "Main",      "workspace": "~/.openclaw/workspace-main",      "default": true },
      { "id": "project-a", "name": "Project A", "workspace": "~/.openclaw/workspace-project-a" },
      { "id": "project-b", "name": "Project B", "workspace": "~/.openclaw/workspace-project-b" }
    ]
  },
  "bindings": [
    { "agentId": "project-a", "match": { "channel": "telegram", "peer": { "kind": "group", "id": "-1001234567890" } } },
    { "agentId": "project-b", "match": { "channel": "telegram", "peer": { "kind": "group", "id": "-1009876543210" } } },
    { "agentId": "main",      "match": { "channel": "telegram" } }
  ],
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "your bot token",
      "dmPolicy": "pairing",
      "groups": { "*": { "requireMention": true } }
    }
  }
}

グループ ID の調べ方

  • 方法 1: グループでメッセージを送り、openclaw logs --follow で chat.id を確認
  • 方法 2: メッセージを @userinfobot に転送

シナリオ B: Bot アカウントごとに別 Workspace

{
  "agents": {
    "list": [
      { "id": "main",   "workspace": "~/.openclaw/workspace-main" },
      { "id": "alerts", "workspace": "~/.openclaw/workspace-alerts" }
    ]
  },
  "bindings": [
    { "agentId": "main",   "match": { "channel": "telegram", "accountId": "default" } },
    { "agentId": "alerts", "match": { "channel": "telegram", "accountId": "alerts" } }
  ],
  "channels": {
    "telegram": {
      "accounts": {
        "default": { "botToken": "123456:ABC...", "dmPolicy": "pairing" },
        "alerts":  { "botToken": "987654:XYZ...", "dmPolicy": "allowlist", "allowFrom": ["tg:123456789"] }
      }
    }
  }
}

保存を忘れない

Save / Apply を押すと OpenClaw は次の 2 つを行います。

  1. 設定の妥当性チェック
  2. 適用。多くの場合はホットリロード

⚠️ baseHash conflict が出たら、別の場所で Config が変更されています。再読み込みしてからもう一度編集してください。

Web UI で他にできること

セクション できること
Chat ブラウザから直接会話
Sessions セッション確認と管理
Cron 定期実行の追加、編集、即時実行
Skills Skill の有効化、無効化、インストール
Channels 各チャネルの状態確認
Debug / Logs ログ確認と手動 RPC

早見表

やりたいこと Web UI の場所
Telegram グループごとに別 Workspace Config → Raw JSON → agents + bindings
Bot アカウントごとに別 Workspace Config → channels.telegram.accounts + bindings
Bot Token の変更 Config → channels.telegram.botToken
スケジュール管理 Cron タブ
ライブログ確認 Debug / Logs タブ

覚えておくべきコアはこれです。Workspace の振り分けは常に agents と bindings で決まる。Web UI はそれを編集しやすくしてくれるだけです。

関連記事