OpenClaw 本地部署进阶：接入 Telegram 与网页搜索能力

创建并配对 Bot

1. 获取 Token：打开 Telegram，搜索 @BotFather，发送 /newbot 指令。按提示设置机器人名称和用户名（必须以 bot 结尾），系统会返回一串 Token。
2. 填入配置：将上述 JSON 中的 <YOUR_BOT_TOKEN> 替换为实际获取的 Token。
3. 启动配对：进入你创建的机器人会话，首次打开通常会显示未正式对接的状态，并提供一个 Pairing code（配对码）。
4. 执行命令：打开新的 PowerShell 窗口，运行以下命令进行授权：

openclaw pairing approve telegram <PAIRING_CODE>

执行成功后，界面会显示配对成功的提示。

注意：若版本升级至 3.12 及以上，配置逻辑略有不同。需先通过 @userinfobot 获取你的数字 ID（格式如 Id: 1987654321），然后在 openclaw onboard 流程中填写该 ID 作为 Telegram allowFrom 参数。

启用网页搜索工具

为了让 AI 具备联网检索信息的能力，需要在 tools 部分添加 Web 搜索与 Fetch 配置。

同样编辑 openclaw.json，在 tools 节点下补充以下内容：

"tools": {
  "web": {
    "search": {},
    "fetch": {
      "maxChars": 20000,
      "timeoutSeconds": 30,
      "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"
    }
  }
}

这里设置了单次抓取的最大字符数、超时时间以及模拟浏览器的 User-Agent，确保请求能被正常识别。

完整配置参考

以下是整合了上述所有修改后的 openclaw.json 完整示例。请根据实际环境调整其中的代理地址、Token 及模型路径等信息。

{
  "meta": {
    "lastTouchedVersion": "2026.2.19-2",
    "lastTouchedAt": "2026-02-21T06:04:19.113Z"
  },
  "wizard": {
    "lastRunAt": "2026-02-21T06:04:19.057Z",
    "lastRunVersion": "2026.2.19-2",
    "lastRunCommand": "onboard",
    "lastRunMode": "local"
  },
  "logging": { "level": "info" },
  "models": {
    "providers": {
      "ollama": {
        "baseUrl": "http://127.0.0.1:11434/v1",
        "apiKey": "ollama-local",
        "api": "openai-completions",
        "models": [
          {
            "id": "gpt-oss:20b",
            "name": "gpt-oss:20b",
            "reasoning": false,
            "input": ["text"],
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "contextWindow": 131072,
            "maxTokens": 16384
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": { "primary": "ollama/gpt-oss:20b" },
      "models": { "ollama/gpt-oss:20b": {} },
      "workspace": "C:\\Users\\Administrator\\.openclaw\\workspace",
      "compaction": { "mode": "safeguard" },
      "maxConcurrent": 4,
      "subagents": { "maxConcurrent": 8 }
    }
  },
  "tools": {
    "web": {
      "search": {},
      "fetch": {
        "maxChars": 20000,
        "timeoutSeconds": 30,
        "userAgent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36"
      }
    }
  },
  "messages": { "ackReactionScope": "group-mentions" },
  "commands": {
    "native": "auto",
    "nativeSkills": "auto",
    "restart": true
  },
  "hooks": {
    "internal": {
      "enabled": true,
      "entries": {
        "boot-md": { "enabled": true },
        "session-memory": { "enabled": true }
      }
    }
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "dmPolicy": "pairing",
      "botToken": "<YOUR_BOT_TOKEN>",
      "groupPolicy": "allowlist",
      "streamMode": "partial",
      "network": { "autoSelectFamily": true },
      "proxy": "http://127.0.0.1:7897",
      "actions": {
        "reactions": true,
        "sendMessage": true,
        "deleteMessage": true,
        "sticker": true
      }
    }
  },
  "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "loopback",
    "auth": {
      "mode": "token",
      "token": "<YOUR_GATEWAY_TOKEN>"
    },
    "tailscale": { "mode": "off", "resetOnExit": false },
    "remote": {
      "url": "ws://127.0.0.1:18789",
      "token": "<YOUR_REMOTE_TOKEN>"
    },
    "nodes": {
      "denyCommands": [
        "camera.snap",
        "camera.clip",
        "screen.record",
        "calendar.add",
        "contacts.add",
        "reminders.add"
      ]
    }
  },
  "skills": { "install": { "nodeManager": "npm" } },
  "plugins": {
    "entries": {
      "telegram": { "enabled": true }
    }
  }
}

配置完成后重启服务即可生效。如果遇到连接问题，优先检查代理设置是否正确，以及 Token 是否有效。