Nói vào nhóm Lark, →
Claude Code làm trên máy bạn

Khoảng 10 phút, làm một lần. Claude Code không làm hộ được phần này — nó nằm trong tài khoản Lark của bạn.

1. Tạo app + bật Bot

   open.larksuite.com (bản .cn: open.feishu.cn) → Developer Console → Create Custom App → Add features → Bot.

2. Bật đủ 3 scope ở Permissions & Scopes

   • im:message — nhận tin
   • im:message:send_as_bot — gửi tin thay bot
   • im:resource — tải/gửi file, ảnh, audio. Thiếu đúng dòng này thì chữ vẫn chạy nhưng giọng nói hỏng câm — nghe không được, đọc trả lời cũng không gửi đi được.

3. Bật event ở Events & Callbacks

   Chọn chế độ Long Connection (khỏi cần URL công khai, khỏi cần ngrok), rồi subscribe event im.message.receive_v1.

4. PUBLISH version — bẫy số một

   Version Management & Release → Create version → Publish. Bản nháp chưa publish thì event và scope chưa có hiệu lực: bạn nhắn vào nhóm mà whoami.mjs im lặng không in gì, và không có cách nào đoán ra nếu không biết trước.

5. Lấy App ID + App Secret

   Mục Credentials & Basic Info. App ID có dạng cli_… — lát nữa điền vào ô ở mục 04. App Secret chỉ dùng để đăng nhập lark-cli, không ghi vào repo, không ghi vào .env.

6. Tạo nhóm điều khiển + thêm Bot vào nhóm

   Tạo 1 nhóm Lark riêng (chỉ mình bạn cũng được) → Add members → thêm Bot của app vừa tạo. Đây là nhóm duy nhất TÔM lắng nghe. Quên bước thêm bot là mọi thứ khác đúng mà vẫn không chạy.

7. Đăng nhập lark-cli bằng chính app này

   Cài npm i -g @larksuite/cli rồi đăng nhập app (chọn brand lark cho larksuite.com, feishu cho .cn). Kiểm bằng:

   lark-cli profile list      # phải thấy app của bạn "active": true

Chưa điền ô nào — khối lệnh đang ở dạng mẫu.

1. Bạn bấm micronói vào nhóm điều khiển
2. lark-cli consumelong connection kéo event về máy, không cần URL công khai
3. Tải audio + ffmpegđây là chỗ cần im:resource
4. faster-whisperserver thường trú; GPU lỗi thì tự lùi CPU
5. claude -pClaude Code headless chạy trong BRAIN_ROOT
6. edge-tts → opusgắn trả lời vào đúng tin bạn vừa gửi

Tin gõ chữ đi cùng đường nhưng bỏ qua bước nghe và bước đọc — trả lời bằng chữ. Tin thoại thì trả lời bằng giọng.

node check-itto.mjs              # gói đủ mảnh chưa
node scripts/check-setup.mjs     # môi trường + Lark + .env sẵn sàng chưa

check-setup.mjs soát đúng 10 mắt xích. Còn một dòng đỏ là chưa bật bridge:

• .env tồn tại — chưa có thì chạy lại install.ps1
• OWNER_OPEN_ID đã điền — lấy bằng whoami.mjs
• CONTROL_CHAT_ID đã điền — lấy bằng whoami.mjs
• Node ≥ 18
• Python venv tồn tại đúng đường dẫn PYTHON_BIN
• venv có đủ faster-whisper + edge-tts + dotenv
• ffmpeg trên PATH
• lark-cli có mặt
• lark-cli có profile active: true — tức là đã đăng nhập app của bạn
• claude có mặt

1. Bật — bằng tay bạn

   powershell -ExecutionPolicy Bypass -File scripts/start.ps1

   Chờ tới khi cửa sổ hiện đủ hai dòng: ✅ Bridge sẵn sàng. và ✅ whisper STT sẵn sàng. Lần đầu Whisper phải tải model — small mất vài chục giây, medium mất 1–2 phút. Đừng nói gì trước khi thấy dòng thứ hai.

2. Nói thử một câu

   Vào nhóm điều khiển, bấm micro và nói — hoặc gõ chữ cũng được. Trả lời sẽ gắn vào đúng tin của bạn. Lệnh nhanh gõ trong nhóm: /ping (bridge còn sống không) · /voice on|off · /reset (phiên Claude mới) · /forget (xoá sạch nhớ đệm) · /mem · /id · /help.

3. Shortcut Desktop — nhớ dùng đường ổ C:

   Shortcut trỏ tới đường mạng \\máy\thư-mục\… sẽ bị Windows chặn ngầm khi double-click: không báo lỗi, không mở gì, bạn tưởng hỏng file. Trỏ vào đường nội bộ ổ C:.

   $ps1 = "C:\<đường-dẫn-repo>\scripts\start.ps1"
   $lnk = "$([Environment]::GetFolderPath('Desktop'))\TOM Voice.lnk"
   $w = New-Object -ComObject WScript.Shell
   $s = $w.CreateShortcut($lnk)
   $s.TargetPath = "$env:SystemRoot\System32\WindowsPowerShell\v1.0\powershell.exe"
   $s.Arguments  = "-ExecutionPolicy Bypass -NoProfile -File `"$ps1`""
   $s.WorkingDirectory = (Split-Path $ps1)
   $s.IconLocation = "shell32.dll,138"
   $s.Save()

4. Chạy ngầm 24/7 — tuỳ chọn, và hãy nghĩ kỹ

   Đăng ký watchdog.mjs vào Windows Scheduled Task (xem docs/04-chay-va-24-7.md): 3 phút kiểm một lần, bridge chết hoặc tim ngừng đập thì tự bật lại. Điền LARK_WEBHOOK vào .env để nó báo về Lark mỗi lần khởi động lại.

   Nhưng: 24/7 + bypassPermissions nghĩa là có một AI toàn quyền chạy lệnh trên máy bạn không giám sát, kể cả lúc bạn ngủ. Bật chế độ này chỉ khi bạn thật sự cần và hiểu mình đang đánh đổi cái gì.