3 分鐘快速開始

0) 前置準備

• Node.js >= 22
• npm 可用
• Telegram 帳號
• 一組模型 API Key（sk-...）

先檢查：

node --version
npm --version

1) 安裝 OpenClaw

npm install -g openclaw@latest
openclaw --version

2) 初始化並啟動

openclaw onboard --install-daemon
openclaw status
openclaw health

目標是看到 Gateway: running。

3) 建立 Telegram Bot

1. 打開 Telegram，搜尋 @BotFather
2. 發送 /newbot
3. 按提示建立機器人名稱與使用者名稱
4. 複製回傳的 Bot Token

4) 取得使用者 ID（白名單）

1. 搜尋 @userinfobot
2. 點 Start
3. 記下回覆中的數字 id

5) 填回 OpenClaw 設定

openclaw onboard
openclaw gateway restart
openclaw status

將 Bot Token 與你的使用者 ID 填入 allowlist。

6) 驗收

• 對機器人發送一條測試訊息
• 10~20 秒內收到回覆
• 連續測試 3 次都成功

7) 常見問題

• 401：Key 錯誤或模型權限不足
• 不回覆：Token/allowlist/Gateway 狀態異常
• 太慢：先換較輕量模型

需要更完整點擊步驟可看：/zh-cn/docs/quickstart/