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

不用碰設定檔！用 Web UI 完成所有 OpenClaw 設定

5 min read

很多教學一開始就叫你去改 JSON，嚇跑了一堆人。這篇告訴你：有個畫面可以點。

本篇學習目標

  • 學會開啟 Web UI 並完成認證
  • 理解表單模式和 Raw JSON 模式的差異
  • 用 UI 完成多 workspace 路由設定
  • 知道 Web UI 各功能區在哪裡

打開 Web UI

第一步：確認 Gateway 在跑

openclaw gateway

第二步：打開瀏覽器

http://127.0.0.1:18789/

如果你設定了 basePath（例如 /openclaw）：

http://127.0.0.1:18789/openclaw

第三步：處理認證

畫面顯示 解法
pairing required 終端機跑 openclaw devices list，再 openclaw devices approve <requestId>
要求 Token 貼上 Onboarding 時的 token

💡 介面語言可以在 Access 區的語言選單改成繁體中文。

Web UI 的設定方式：表單 vs Raw JSON

進入 Config 頁，你有兩種選擇：

表單模式：有格式好看的輸入欄位，適合初學者或改少量設定。

Raw JSON 模式：直接編輯 JSON 設定檔，精準、快速，適合進階使用者或一次改很多東西。

兩種模式改的是同一份 ~/.openclaw/openclaw.json，隨時可以切換。

最常用的設定：讓不同 Telegram 群組用不同助理

情境 A：同一個 Bot，不同群組 → 不同 workspace

切換到 Raw JSON，把這個結構加進去：

{
  "agents": {
    "list": [
      { "id": "main",      "name": "主站",  "workspace": "~/.openclaw/workspace-main",      "default": true },
      { "id": "project-a", "name": "專案 A", "workspace": "~/.openclaw/workspace-project-a" },
      { "id": "project-b", "name": "專案 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": "你的Bot Token",
      "dmPolicy": "pairing",
      "groups": { "*": { "requireMention": true } }
    }
  }
}

怎麼找群組 ID？

  • 方法一：在群組發訊息，跑 openclaw logs --follow 看 chat.id
  • 方法二：把訊息轉發給 @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 會：

  1. 驗證設定格式（有錯就提示，不會寫入）
  2. 套用設定，通常自動熱重載

⚠️ 出現「baseHash 衝突」？設定被其他地方改過了——重新載入 Config 再改一次，再存。

Web UI 還能做什麼？

功能區 能做的事
Chat 直接在瀏覽器裡跟助理對話
Sessions 檢視、管理對話 sessions
Cron 新增 / 編輯 / 手動執行排程
Skills 啟停、安裝技能
Channels 查看各通道狀態
Debug / Logs 即時查看 log、手動 RPC

快速對照表

我想做... 在 Web UI 怎麼找
不同 Telegram 群組 → 不同 workspace Config → Raw JSON → agents + bindings
不同 Bot 帳號 → 不同 workspace Config → channels.telegram.accounts + bindings
改 Bot Token Config → channels.telegram.botToken
管理排程 Cron 標籤
查看即時 log Debug / Logs 標籤

記住核心概念：所有路由和 workspace 對應，都是靠 agents + bindings 決定的，Web UI 只是讓你不用手動改 JSON 的介面。

相關延伸閱讀