---
read_when:
    - การวินิจฉัยการเชื่อมต่อของช่องทางหรือสถานะการทำงานของ Gateway
    - ทำความเข้าใจคำสั่งและตัวเลือก CLI สำหรับการตรวจสอบสุขภาพ
summary: คำสั่งตรวจสอบสถานะการทำงานและการเฝ้าติดตามสถานะการทำงานของ Gateway
title: การตรวจสอบสถานภาพ
x-i18n:
    generated_at: "2026-05-02T10:15:55Z"
    model: gpt-5.5
    provider: openai
    source_hash: bf1e0073a09592c6502f697e615f44d0f1a960caf4599888a8b72f22098c1e91
    source_path: gateway/health.md
    workflow: 16
---

คู่มือสั้น ๆ สำหรับตรวจสอบการเชื่อมต่อของช่องทางโดยไม่ต้องเดา

## การตรวจสอบอย่างรวดเร็ว

- `openclaw status` — สรุปในเครื่อง: การเข้าถึง/โหมดของ Gateway, คำใบ้การอัปเดต, อายุการยืนยันตัวตนของช่องทางที่ลิงก์แล้ว, เซสชัน + กิจกรรมล่าสุด
- `openclaw status --all` — การวินิจฉัยในเครื่องแบบเต็ม (อ่านอย่างเดียว, มีสี, วางเพื่อดีบักได้อย่างปลอดภัย)
- `openclaw status --deep` — ขอให้ Gateway ที่กำลังทำงานอยู่ทำการตรวจสุขภาพสด (`health` พร้อม `probe:true`) รวมถึงการตรวจสอบช่องทางรายบัญชีเมื่อรองรับ
- `openclaw health` — ขอ snapshot สุขภาพจาก Gateway ที่กำลังทำงานอยู่ (เฉพาะ WS; ไม่มีซ็อกเก็ตช่องทางโดยตรงจาก CLI)
- `openclaw health --verbose` — บังคับการตรวจสุขภาพสดและพิมพ์รายละเอียดการเชื่อมต่อ Gateway
- `openclaw health --json` — เอาต์พุต snapshot สุขภาพที่อ่านได้ด้วยเครื่อง
- ส่ง `/status` เป็นข้อความเดี่ยวใน WhatsApp/WebChat เพื่อรับการตอบกลับสถานะโดยไม่เรียกใช้เอเจนต์
- บันทึก: tail `/tmp/openclaw/openclaw-*.log` และกรองหา `web-heartbeat`, `web-reconnect`, `web-auto-reply`, `web-inbound`

สำหรับ Discord และผู้ให้บริการแชตอื่น ๆ แถวเซสชันไม่ใช่สถานะการมีชีวิตของซ็อกเก็ต
`openclaw sessions`, Gateway `sessions.list`, และเครื่องมือ `sessions_list` ของเอเจนต์
อ่านสถานะการสนทนาที่จัดเก็บไว้ ผู้ให้บริการสามารถเชื่อมต่อใหม่และแสดงสถานะช่องทางที่ปกติ
ก่อนที่แถวเซสชันใหม่ใด ๆ จะถูกสร้างขึ้น ใช้คำสั่งสถานะช่องทางและ
สุขภาพด้านบนสำหรับการตรวจสอบการเชื่อมต่อสด

## การวินิจฉัยเชิงลึก

- ข้อมูลรับรองบนดิสก์: `ls -l ~/.openclaw/credentials/whatsapp/<accountId>/creds.json` (mtime ควรเป็นเวลาล่าสุด)
- ที่เก็บเซสชัน: `ls -l ~/.openclaw/agents/<agentId>/sessions/sessions.json` (เส้นทางสามารถถูกแทนที่ได้ในคอนฟิก) จำนวนและผู้รับล่าสุดจะแสดงผ่าน `status`
- โฟลว์ลิงก์ใหม่: `openclaw channels logout && openclaw channels login --verbose` เมื่อรหัสสถานะ 409–515 หรือ `loggedOut` ปรากฏในบันทึก (หมายเหตุ: โฟลว์ล็อกอิน QR จะรีสตาร์ตอัตโนมัติหนึ่งครั้งสำหรับสถานะ 515 หลังการจับคู่)
- การวินิจฉัยถูกเปิดใช้งานตามค่าเริ่มต้น Gateway จะบันทึกข้อเท็จจริงเชิงปฏิบัติการ เว้นแต่จะตั้งค่า `diagnostics.enabled: false` เหตุการณ์หน่วยความจำบันทึกจำนวนไบต์ RSS/heap, แรงกดดันตาม threshold และแรงกดดันจากการเติบโต คำเตือนการมีชีวิตบันทึกความหน่วงของ event-loop, การใช้งาน event-loop, อัตราส่วนคอร์ CPU และจำนวนเซสชันที่ใช้งานอยู่/รออยู่/เข้าคิว เมื่อกระบวนการกำลังทำงานแต่ถูกใช้งานจนเต็ม เหตุการณ์ payload ขนาดใหญ่เกินไปบันทึกสิ่งที่ถูกปฏิเสธ ตัดให้สั้น หรือแบ่งเป็นชิ้น พร้อมขนาดและขีดจำกัดเมื่อมีข้อมูล เหตุการณ์เหล่านี้ไม่บันทึกข้อความของแชต เนื้อหาไฟล์แนบ body ของ Webhook body ของคำขอหรือการตอบกลับดิบ โทเค็น คุกกี้ หรือค่าลับ Heartbeat เดียวกันจะเริ่มตัวบันทึกเสถียรภาพแบบมีขอบเขต ซึ่งเข้าถึงได้ผ่าน `openclaw gateway stability` หรือ RPC ของ Gateway `diagnostics.stability` การออกจาก Gateway แบบ fatal, timeout ตอนปิดระบบ และความล้มเหลวตอนเริ่มต้นหลังรีสตาร์ต จะคง snapshot ล่าสุดของตัวบันทึกไว้ใต้ `~/.openclaw/logs/stability/` เมื่อมีเหตุการณ์อยู่; ตรวจดู bundle ที่บันทึกใหม่ที่สุดด้วย `openclaw gateway stability --bundle latest`
- สำหรับรายงานบั๊ก ให้เรียกใช้ `openclaw gateway diagnostics export` และแนบไฟล์ zip ที่สร้างขึ้น การส่งออกจะรวมสรุป Markdown, bundle เสถียรภาพล่าสุด, metadata บันทึกที่ผ่านการทำให้ปลอดภัย, snapshot สถานะ/สุขภาพ Gateway ที่ผ่านการทำให้ปลอดภัย และรูปทรงคอนฟิก สิ่งนี้ถูกออกแบบมาเพื่อแชร์: ข้อความแชต, body ของ Webhook, เอาต์พุตเครื่องมือ, ข้อมูลรับรอง, คุกกี้, ตัวระบุบัญชี/ข้อความ และค่าลับจะถูกละเว้นหรือปกปิด ดู [การส่งออกการวินิจฉัย](/th/gateway/diagnostics)

## คอนฟิกตัวตรวจสอบสุขภาพ

- `gateway.channelHealthCheckMinutes`: ความถี่ที่ Gateway ตรวจสุขภาพช่องทาง ค่าเริ่มต้น: `5` ตั้งค่า `0` เพื่อปิดการรีสตาร์ตโดยตัวตรวจสอบสุขภาพทั่วทั้งระบบ
- `gateway.channelStaleEventThresholdMinutes`: ระยะเวลาที่ช่องทางที่เชื่อมต่อแล้วสามารถไม่มีการใช้งานได้ก่อนที่ตัวตรวจสอบสุขภาพจะถือว่าล้าสมัยและรีสตาร์ต ค่าเริ่มต้น: `30` ให้ค่านี้มากกว่าหรือเท่ากับ `gateway.channelHealthCheckMinutes`
- `gateway.channelMaxRestartsPerHour`: เพดานแบบเลื่อนช่วงหนึ่งชั่วโมงสำหรับการรีสตาร์ตโดยตัวตรวจสอบสุขภาพต่อช่องทาง/บัญชี ค่าเริ่มต้น: `10`
- `channels.<provider>.healthMonitor.enabled`: ปิดการรีสตาร์ตโดยตัวตรวจสอบสุขภาพสำหรับช่องทางเฉพาะ โดยยังคงเปิดการตรวจสอบทั่วทั้งระบบไว้
- `channels.<provider>.accounts.<accountId>.healthMonitor.enabled`: การแทนที่แบบหลายบัญชีที่มีลำดับความสำคัญเหนือการตั้งค่าระดับช่องทาง
- การแทนที่รายช่องทางเหล่านี้ใช้กับตัวตรวจสอบช่องทางในตัวที่เปิดให้ใช้ในปัจจุบัน: Discord, Google Chat, iMessage, Microsoft Teams, Signal, Slack, Telegram และ WhatsApp

## เมื่อมีบางอย่างล้มเหลว

- `logged out` หรือสถานะ 409–515 → ลิงก์ใหม่ด้วย `openclaw channels logout` แล้วตามด้วย `openclaw channels login`
- Gateway เข้าถึงไม่ได้ → เริ่มต้น: `openclaw gateway --port 18789` (ใช้ `--force` หากพอร์ตไม่ว่าง)
- ไม่มีข้อความขาเข้า → ยืนยันว่าโทรศัพท์ที่ลิงก์อยู่ออนไลน์ และผู้ส่งได้รับอนุญาต (`channels.whatsapp.allowFrom`); สำหรับแชตกลุ่ม ให้แน่ใจว่ากฎ allowlist + mention ตรงกัน (`channels.whatsapp.groups`, `agents.list[].groupChat.mentionPatterns`)

## คำสั่ง "health" เฉพาะทาง

`openclaw health` ขอ snapshot สุขภาพจาก Gateway ที่กำลังทำงานอยู่ (ไม่มีซ็อกเก็ตช่องทาง
โดยตรงจาก CLI) โดยค่าเริ่มต้น คำสั่งนี้สามารถคืน snapshot Gateway ที่แคชไว้ใหม่ได้ จากนั้น
Gateway จะรีเฟรชแคชนั้นในเบื้องหลัง `openclaw health --verbose` จะบังคับ
การตรวจสดแทน คำสั่งนี้รายงานข้อมูลรับรองที่ลิงก์แล้ว/อายุการยืนยันตัวตนเมื่อมีข้อมูล,
สรุปการตรวจรายช่องทาง, สรุปที่เก็บเซสชัน และระยะเวลาการตรวจ คำสั่งจะออกด้วยสถานะ
ไม่เป็นศูนย์หากเข้าถึง Gateway ไม่ได้ หรือการตรวจล้มเหลว/timeout

ตัวเลือก:

- `--json`: เอาต์พุต JSON ที่อ่านได้ด้วยเครื่อง
- `--timeout <ms>`: แทนที่ timeout การตรวจค่าเริ่มต้น 10 วินาที
- `--verbose`: บังคับการตรวจสดและพิมพ์รายละเอียดการเชื่อมต่อ Gateway
- `--debug`: ชื่อแฝงของ `--verbose`

snapshot สุขภาพประกอบด้วย: `ok` (บูลีน), `ts` (timestamp), `durationMs` (เวลาการตรวจ), สถานะรายช่องทาง, ความพร้อมใช้งานของเอเจนต์ และสรุปที่เก็บเซสชัน

## ที่เกี่ยวข้อง

- [Runbook ของ Gateway](/th/gateway)
- [การส่งออกการวินิจฉัย](/th/gateway/diagnostics)
- [การแก้ปัญหา Gateway](/th/gateway/troubleshooting)