Cổng nhắn tin

Trò chuyện với Hermes từ Telegram, Discord, Slack, WhatsApp, Signal, SMS, Email, Home Assistant, Mattermost, Matrix, DingTalk, Feishu/Lark, WeCom, Weixin, BlueBubbles (iMessage), QQ, Yuanbao, Microsoft Teams, LINE, ntfy hoặc trình duyệt của bạn. Cổng là một quy trình nền duy nhất kết nối với tất cả các nền tảng được định cấu hình của bạn, xử lý các phiên, chạy các công việc định kỳ và gửi tin nhắn thoại.

Để biết bộ tính năng giọng nói đầy đủ — bao gồm chế độ micrô CLI, câu trả lời bằng giọng nói trong tin nhắn và cuộc trò chuyện trên kênh thoại Discord — hãy xem Voice Mode và Use Voice Mode with Hermes.

So sánh nền tảng

Nền tảng	Giọng nói	Hình ảnh	Tập tin	Chủ đề	Phản ứng	Đánh máy	Truyền phát
Telegram	✅	✅	✅	✅	—	✅	✅
Discord	✅	✅	✅	✅	✅	✅	✅
Chần chừ	✅	✅	✅	✅	✅	✅	✅
Trò chuyện trên Google	—	✅	✅	✅	—	✅	—
WhatsApp	—	✅	✅	—	—	✅	✅
Tín hiệu	—	✅	✅	—	—	✅	✅
SMS	—	—	—	—	—	—	—
Email	—	✅	✅	✅	—	—	—
Trợ lý tại nhà	—	—	—	—	—	—	—
Quan trọng nhất	✅	✅	✅	✅	—	✅	✅
Ma trận	✅	✅	✅	✅	✅	✅	✅
DingTalk	—	✅	✅	—	✅	—	✅
Feishu/Lark	✅	✅	✅	✅	✅	✅	✅
WeCom	✅	✅	✅	—	—	✅	✅
Gọi lại WeCom	—	—	—	—	—	—	—
Weixin	✅	✅	✅	—	—	✅	✅
BlueBubble	—	✅	✅	—	✅	✅	—
QQ	✅	✅	✅	—	—	✅	—
Nguyên Bảo	✅	✅	✅	—	—	✅	✅
Nhóm Microsoft	—	✅	—	✅	—	✅	—
DÒNG	—	✅	✅	—	—	✅	—
ntfy	—	—	—	—	—	—	—

Giọng nói = Trả lời bằng âm thanh TTS và/hoặc chép lại tin nhắn thoại. Hình ảnh = gửi/nhận hình ảnh. Tệp = gửi/nhận tệp đính kèm. Chủ đề = cuộc trò chuyện theo chuỗi. Phản ứng = biểu tượng cảm xúc trên tin nhắn. Đang gõ = chỉ báo đang gõ trong khi xử lý. Truyền phát = cập nhật tin nhắn liên tục thông qua chỉnh sửa.

Kiến trúc

mermaid flowchart TB subgraph Gateway["Hermes Gateway"] subgraph Adapters["Platform adapters"] tg[Telegram] dc[Discord] wa[WhatsApp] sl[Slack] gc[Google Chat] sig[Signal] sms[SMS] em[Email] ha[Home Assistant] mm[Mattermost] mx[Matrix] dt[DingTalk] fs[Feishu/Lark] wc[WeCom] wcb[WeCom Callback] wx[Weixin] bb[BlueBubbles] qq[QQ] yb[Yuanbao] ms[Microsoft Teams] API["API Server<br/>(OpenAI-compatible)"] wh[Webhooks] endstore["Session store
per chat"] agent["AIAgent
run_agent.py"] cron["Cron scheduler
ticks every 60s"] end`tg --> store dc --> store wa --> store sl --> store gc --> store sig --> store sms --> store em --> store ha --> store mm --> store mx --> store dt --> store fs --> store wc --> store wcb --> store wx --> store bb --> store qq --> store yb --> store ms --> store API --> store wh --> store store --> agent cron --> store

` ``Mỗi bộ điều hợp nền tảng nhận tin nhắn, định tuyến chúng qua kho lưu trữ phiên trên mỗi cuộc trò chuyện và gửi chúng đến AIAgent để xử lý. Cổng cũng chạy bộ lập lịch cron, đánh dấu 60 giây một lần để thực hiện mọi công việc đến hạn.

Thiết lập nhanh

Cách dễ nhất để định cấu hình nền tảng nhắn tin là trình hướng dẫn tương tác:

Hermes gateway setup        # Interactive setup for all messaging platforms

`
``Phần này hướng dẫn bạn cách định cấu hình từng nền tảng bằng lựa chọn phím mũi tên, hiển thị nền tảng nào đã được định cấu hình và đề xuất khởi động/khởi động lại cổng khi hoàn tất.

## Lệnh cổng

`bash
Hermes gateway              # Run in foreground
Hermes gateway setup        # Configure messaging platforms interactively
Hermes gateway install      # Install as a user service (Linux) / launchd service (macOS)
sudo Hermes gateway install --system   # Linux only: install a boot-time system service
Hermes gateway start        # Start the default service
Hermes gateway stop         # Stop the default service
Hermes gateway status       # Check default service status
Hermes gateway status --system         # Linux only: inspect the system service explicitly

`

## Lệnh trò chuyện (Nhắn tin bên trong)

| Lệnh | Mô tả |
|----------|-------------|
| 

/new
` hoặc 

/reset
` | Bắt đầu một cuộc trò chuyện mới |
| 

/model [provider:model]
` | Hiển thị hoặc thay đổi mô hình (hỗ trợ cú pháp 
`provider:model

) |
| 

/personality [name]
` | Đặt tính cách |
| 

/retry
` | Thử lại tin nhắn cuối cùng |
| 

/undo
` | Xóa trao đổi cuối cùng |
| 

/status
` | Hiển thị thông tin phiên |
| 

/whoami
` | Hiển thị quyền truy cập lệnh gạch chéo của bạn trên phạm vi này (quản trị viên/người dùng/không hạn chế) |
| 

/stop
` | Dừng tác nhân đang chạy |
| 

/approve
` | Phê duyệt lệnh nguy hiểm đang chờ xử lý |
| 

/deny
` | Từ chối lệnh nguy hiểm đang chờ xử lý |
| 

/sethome
` | Đặt cuộc trò chuyện này làm kênh chính |
| 

/compress
` | Nén ngữ cảnh hội thoại theo cách thủ công |
| 

/title [name]
` | Đặt hoặc hiển thị tiêu đề phiên |
| 

/resume [name]
` | Tiếp tục phiên được đặt tên trước đó |
| 

/usage
` | Hiển thị mức sử dụng mã thông báo cho phiên này |
| 

/insights [days]
` | Hiển thị thông tin chi tiết và phân tích về cách sử dụng |
| 

/reasoning [level\|show\|hide]
` | Thay đổi nỗ lực lập luận hoặc chuyển đổi hiển thị lý luận |
| 

/voice [on\|off\|tts\|join\|leave\|status]
` | Kiểm soát phản hồi bằng giọng nói trong tin nhắn và hoạt động của kênh thoại Discord |
| 

/rollback [number]
` | Liệt kê hoặc khôi phục các điểm kiểm tra hệ thống tập tin |
| 

/background <prompt
` | Chạy lời nhắc trong phiên nền riêng biệt |
| 

/reload-MCP
` | Tải lại máy chủ MCP từ config |
| 

/update
` | Cập nhật Hermes Agent lên phiên bản mới nhất |
| 

/help
` | Hiển thị các lệnh có sẵn |
| 

/<skill-name
` | Gọi bất kỳ kỹ năng nào đã cài đặt |

## Quản lý phiên

### Sự kiên trì của phiên

Các phiên vẫn tồn tại trên các tin nhắn cho đến khi chúng được đặt lại. Nhân viên ghi nhớ bối cảnh cuộc trò chuyện của bạn.

### Đặt lại chính sách

Đặt lại phiên dựa trên các chính sách có thể định cấu hình:| Chính sách | Mặc định | Mô tả |
|--------|----------|-------------|
| Hàng ngày | 4:00 sáng | Đặt lại vào một giờ cụ thể mỗi ngày |
| Nhàn rỗi | 1440 phút | Đặt lại sau N phút không hoạt động |
| Cả hai | (kết hợp) | Cái nào kích hoạt trước |

Định cấu hình ghi đè trên mỗi nền tảng trong 

~/.Hermes/gateway.JSON

:

`JSON
{
  "reset_by_platform": {
    "Telegram": { "mode": "idle", "idle_minutes": 240 },
    "Discord": { "mode": "idle", "idle_minutes": 60 }
  }
}

`

## Bảo mật`**Theo mặc định, cổng từ chối tất cả người dùng không nằm trong danh sách cho phép hoặc được ghép nối qua DM.** Đây là chế độ mặc định an toàn cho bot có quyền truy cập terminal.

`bash

# Restrict to specific users (recommended):
Telegram_ALLOWED_USERS=123456789,987654321
Discord_ALLOWED_USERS=123456789012345678
Signal_ALLOWED_USERS=+155****4567,+155****6543
SMS_ALLOWED_USERS=+155****4567,+155****6543
EMAIL_ALLOWED_USERS=tRusted@example.com,colleague@work.com
Mattermost_ALLOWED_USERS=3uo8dkh1p7g1mfk49ear5fzs5c
Matrix_ALLOWED_USERS=@alice:Matrix.org
DingTalk_ALLOWED_USERS=user-id-1
Feishu_ALLOWED_USERS=ou_xxxxxxxx,ou_yyyyyyyy
WeCom_ALLOWED_USERS=user-id-1,user-id-2
WeCom_CALLBACK_ALLOWED_USERS=user-id-1,user-id-2
TEAMS_ALLOWED_USERS=aad-object-id-1,aad-object-id-2

# Or allow
GATEWAY_ALLOWED_USERS=123456789,987654321

# Or explicitly allow all users (NOT recommended for bots with terminal access):
GATEWAY_ALLOW_ALL_USERS=true

`

### Ghép nối DM (Thay thế cho danh sách cho phép)

Thay vì định cấu hình ID người dùng theo cách thủ công, những người dùng không xác định sẽ nhận được mã ghép nối một lần khi họ DM bot:

``` bash

# The user sees: "Pairing code: XKGH5N7P"
# You approve them with:
Hermes pairing approve Telegram XKGH5N7P

# Other pairing commands:
Hermes pairing list          # View pending + approved users
Hermes pairing revoke Telegram 123456789  # Remove access

`
``Mã ghép nối sẽ hết hạn sau 1 giờ, có giới hạn tốc độ và sử dụng tính ngẫu nhiên của mật mã.

### Quản trị viên và Người dùng thông thường

Danh sách cho phép trả lời "người này có thể tiếp cận bot không?" **Phần chia quản trị viên / người dùng** trả lời "bây giờ họ đã tham gia, họ được phép làm gì?"

Mỗi người dùng được phép thuộc một trong hai cấp trên mỗi phạm vi (DM so với nhóm/kênh):
- **Quản trị viên** — toàn quyền truy cập. Có thể chạy mọi lệnh gạch chéo đã đăng ký (tích hợp + plugin) và sử dụng mọi khả năng kiểm soát.
- **Người dùng thông thường** — quyền truy cập bị hạn chế. Có thể trò chuyện với tác nhân một cách bình thường, nhưng chỉ có thể chạy các lệnh gạch chéo mà bạn kích hoạt rõ ràng. Tầng luôn được phép là 

/help
` và 

/whoami

.

Các tầng được định cấu hình cho mỗi nền tảng và mỗi phạm vi. Trạng thái quản trị viên DM không ngụ ý trạng thái quản trị viên nhóm/kênh — mỗi phạm vi có danh sách quản trị viên riêng.

**Cổng tầng hôm nay là gì:** lệnh gạch chéo. Phần phân tách chạy qua sổ đăng ký lệnh trực tiếp, do đó, nó bao gồm các lệnh được tích hợp sẵn và đã đăng ký plugin mà không cần nối dây theo từng tính năng. Trò chuyện đơn giản không bị ảnh hưởng — những người không phải quản trị viên vẫn có thể nói chuyện với nhân viên hỗ trợ.

**Những gì có thể được kiểm soát trong tương lai:** nhiều bề mặt khả năng hơn (truy cập công cụ, chuyển đổi mô hình, các hoạt động đắt tiền) sẽ có cùng sự phân biệt quản trị viên / người dùng khi chúng tôi thêm chúng. Việc định cấu hình phần phân chia ngay bây giờ có nghĩa là những hạn chế trong tương lai đó sẽ được giải quyết một cách rõ ràng mà bạn không cần phải xác định lại ai là quản trị viên.

#### Cấu hình

``` yaml
gateway:
  platforms:
    Discord:
      extra:
        allow_from: ["111", "222", "333"]
        allow_admin_from: ["111"]                    # admins → all slash commands
        user_allowed_commands: [status, model]       # what non-admins may run

        # Optional: separate group/channel scope
        group_allow_admin_from: ["111"]
        group_user_allowed_commands: [status]

`
``**Khả năng tương thích ngược:** nếu 
`allow_admin_from
` không được đặt cho một phạm vi thì việc phân chia cấp độ sẽ bị vô hiệu hóa đối với phạm vi đó và mọi người dùng được phép đều có toàn quyền truy cập. Các lượt cài đặt hiện tại tiếp tục hoạt động mà không có thay đổi nào — hãy chọn tham gia khi bạn muốn có sự khác biệt.

#### Kiểm tra quyền truy cập của bạn

Sử dụng 

/whoami
` từ bất kỳ nền tảng nào để xem phạm vi hoạt động, cấp độ của bạn (quản trị viên / người dùng / không bị hạn chế) và lệnh gạch chéo nào bạn có thể chạy. Xem các trang [Telegram](/docs/user-guide/messaging/Telegram#slash-command-access-control) và [Discord](/docs/user-guide/messaging/Discord#slash-command-access-control) để biết các ví dụ dành riêng cho nền tảng.

## Làm gián đoạn tác nhân

Gửi bất kỳ tin nhắn nào trong khi tác nhân đang làm việc để làm gián đoạn nó. Các hành vi chính:
- **Các lệnh đầu cuối đang thực hiện sẽ bị hủy ngay lập tức** (SIGTERM, sau đó là SIGKILL sau 1 giây)
- **Cuộc gọi công cụ bị hủy** — chỉ lệnh hiện đang thực hiện chạy, phần còn lại bị bỏ qua
- **Nhiều tin nhắn được kết hợp** — các tin nhắn được gửi trong thời gian bị gián đoạn sẽ được nối vào một lời nhắc
- **Lệnh 

/stop

** — ngắt mà không xếp hàng tin nhắn tiếp theo

### Hàng đợi, ngắt và điều khiển (chế độ đầu vào bận)

Theo mặc định, việc nhắn tin cho một tổng đài viên đang bận sẽ làm gián đoạn nó. Hai chế độ khác có sẵn:
- 
`queue

 - các tin nhắn tiếp theo chờ và chạy ở lượt tiếp theo sau khi tác vụ hiện tại kết thúc.
- 
`steer

 - các thông báo tiếp theo được đưa vào lần chạy hiện tại thông qua 

/steer

, đến đại lý sau lệnh gọi công cụ tiếp theo. Không bị gián đoạn, không có lượt mới. Quay trở lại hành vi 
`queue
` nếu tác nhân chưa bắt đầu.

``` yaml
display:
  busy_input_mode: steer   # or queue, or interrupt (default)
  busy_ack_enabled: true   # set to false to suppress the ⚡/⏳/⏩ chat reply entirely

`
``Lần đầu tiên bạn nhắn tin cho một đại lý bận trên bất kỳ nền tảng nào, Hermes sẽ thêm lời nhắc một dòng vào gói bận giải thích về nút xoay (

"💡 First-time tip — …"

). Lời nhắc sẽ kích hoạt một lần cho mỗi lần cài đặt — cờ bên dưới 
`onboarding.seen.busy_input_prompt
` sẽ chốt lời nhắc đó. Xóa phím đó để xem lại mẹo.

Nếu bạn thấy tình trạng bận rộn ồn ào — đặc biệt khi nhập bằng giọng nói hoặc tin nhắn gửi nhanh — hãy đặt 
`display.busy_ack_enabled: false

. Thông tin đầu vào của bạn vẫn được xếp hàng/điều khiển/ngắt như bình thường, chỉ có câu trả lời trò chuyện là ở chế độ im lặng.

## Thông báo tiến độ công cụ

Kiểm soát lượng hoạt động của công cụ được hiển thị trong 

~/.Hermes/config.yaml

:

`YAML
display:
  tool_progress: all    # off | new | all | verbose
  tool_progress_command: false  # set to true to enable /verbose in messaging

`
``Khi được bật, bot sẽ gửi thông báo trạng thái khi hoạt động:

`text
💻 
`ls -la

...
🔍 web_search...
📄 web_extract...
🐍 execute_code...

`

## Phiên nền

Chạy lời nhắc trong một phiên nền riêng biệt để nhân viên hỗ trợ hoạt động độc lập trong khi cuộc trò chuyện chính của bạn vẫn phản hồi:

`
/background Check all servers in the cluster and report any that are down

`
``Hermes xác nhận ngay:

`
🔄 Background task started: "Check all servers in the cluster..."
   Task ID: bg_143022_a1b2c3

`

### Cách thức hoạt động

Mỗi lời nhắc 

/background
` tạo ra một **phiên bản tác nhân riêng biệt** chạy không đồng bộ:
- **Phiên riêng biệt** — tác nhân nền có phiên riêng với lịch sử hội thoại riêng. Nó không biết ngữ cảnh trò chuyện hiện tại của bạn và chỉ nhận được lời nhắc bạn cung cấp.

- **Cấu hình tương tự** — kế thừa mô hình, nhà cung cấp, bộ công cụ, cài đặt lý luận và định tuyến của nhà cung cấp từ thiết lập cổng hiện tại.
- **Không chặn** — cuộc trò chuyện chính của bạn vẫn hoàn toàn tương tác. Gửi tin nhắn, chạy các lệnh khác hoặc bắt đầu nhiều tác vụ nền hơn trong khi nó hoạt động.
- **Gửi kết quả** — khi tác vụ kết thúc, kết quả sẽ được gửi trở lại **cùng một cuộc trò chuyện hoặc kênh** nơi bạn đã đưa ra lệnh, có tiền tố là " ✅ Hoàn thành tác vụ trong nền". Nếu không thành công, bạn sẽ thấy thông báo "❌ Background task failed" kèm theo lỗi.

### Thông báo quá trình nền

Khi tác nhân chạy phiên nền sử dụng 
`terminal(background=true)
` để bắt đầu các quy trình chạy dài (máy chủ, bản dựng, v.v.), cổng có thể đẩy các cập nhật trạng thái vào cuộc trò chuyện của bạn. Kiểm soát điều này với 
`display.background_process_notifications
` trong 

~/.Hermes/config.yaml

:

``` yaml
display:
  background_process_notifications: all    # all | result | error | off

`

| Chế độ | Những gì bạn nhận được |
|------|-------------------|
| 
`all
` | Cập nhật đầu ra đang chạy **và** thông báo hoàn thành cuối cùng (mặc định) |
| 
`result
` | Chỉ thông báo hoàn thành cuối cùng (bất kể mã thoát) |
| 
`error
` | Chỉ có thông báo cuối cùng khi mã thoát khác 0 |
| 
`off
` | Không có thông báo theo dõi quá trình nào cả |

Bạn cũng có thể thiết lập điều này thông qua biến môi trường:

`bash
Hermes_BACKGROUND_NOTIFICATIONS=result

`

### Trường hợp sử dụng
- **Giám sát máy chủ** — "/background Kiểm tra tình trạng của tất cả các dịch vụ và thông báo cho tôi nếu có sự cố"

- **Bản dựng dài** — "/background Xây dựng và triển khai môi trường chạy thử" trong khi bạn tiếp tục trò chuyện
- **Nhiệm vụ nghiên cứu** — "/background Nghiên cứu giá của đối thủ cạnh tranh và tóm tắt trong bảng"
- **Thao tác tệp** — "/background Sắp xếp ảnh trong ~/Tải xuống theo ngày vào các thư mục"

:::tip
Các tác vụ nền trên nền tảng nhắn tin có thể thực hiện nhanh chóng — bạn không cần phải đợi hoặc kiểm tra chúng. Kết quả sẽ tự động đến trong cùng một cuộc trò chuyện khi nhiệm vụ kết thúc.
:::

##Quản lý dịch vụ

### Linux (hệ thống)

``` bash
Hermes gateway install               # Install as user service
Hermes gateway start                 # Start the service
Hermes gateway stop                  # Stop the service
Hermes gateway status                # Check status
journalctl --user -u Hermes-gateway -f  # View logs

# Enable lingering (keeps running after logout)
sudo loginctl enable-linger $USER

# Or install a boot-time system service that still runs as your user
sudo Hermes gateway install --system
sudo Hermes gateway start --system
sudo Hermes gateway status --system
journalctl -u Hermes-gateway -f

`
``Sử dụng dịch vụ người dùng trên máy tính xách tay và hộp phát triển. Sử dụng dịch vụ hệ thống trên VPS hoặc máy chủ không đầu sẽ quay trở lại khi khởi động mà không cần dựa vào systemd nán lại.

Tránh cài đặt cả thiết bị cổng hệ thống và người dùng cùng một lúc trừ khi bạn thực sự có ý định đó. Hermes sẽ cảnh báo nếu phát hiện cả hai vì hành vi bắt đầu/dừng/trạng thái trở nên mơ hồ.

:::info[Multiple installations]
Nếu bạn chạy nhiều bản cài đặt Hermes trên cùng một máy (với các thư mục 
`Hermes_HOME
` khác nhau), mỗi bản cài đặt sẽ có tên dịch vụ systemd riêng. 

~/.Hermes
` mặc định sử dụng 
`Hermes-gateway

; các cài đặt khác sử dụng 
`Hermes-gateway-<hash

. Các lệnh 
`Hermes gateway
` sẽ tự động nhắm mục tiêu dịch vụ chính xác cho 
`Hermes_HOME
` hiện tại của bạn.

:::

### macOS (launchd)

``` bash
Hermes gateway install               # Install as launchd agent
Hermes gateway start                 # Start the service
Hermes gateway stop                  # Stop the service
Hermes gateway status                # Check status
tail -f ~/.Hermes/logs/gateway.log   # View logs

`
``Plist được tạo tồn tại ở 

~/Library/LaunchAgents/ai.Hermes.gateway.plist

. Nó bao gồm ba biến môi trường:
- **PATH** — PATH shell đầy đủ của bạn khi cài đặt, với venv 
`bin/
` và 
`node_modules/.bin
` được thêm vào trước. Điều này đảm bảo các công cụ do người dùng cài đặt (Node.js, ffmpeg, v.v.) có sẵn cho các quy trình con cổng như cầu WhatsApp.

- **VIRTUAL_ENV** — trỏ đến virtualenv Python để các công cụ có thể phân giải các gói một cách chính xác.
- **Hermes_HOME** — xác định phạm vi cổng vào quá trình cài đặt Hermes của bạn.

:::tip[PATH changes after install]
các lệnh khởi chạy là tĩnh — nếu bạn cài đặt các công cụ mới (ví dụ: phiên bản Node.js mới qua nvm hoặc ffmpeg qua Homebrew) sau khi thiết lập cổng, hãy chạy lại 
`Hermes gateway install
` để ghi lại PATH đã cập nhật. Cổng sẽ phát hiện số nguyên cũ và tự động tải lại.
:::

:::info[Multiple installations]
Giống như dịch vụ systemd của Linux, mỗi thư mục 
`Hermes_HOME
` đều có nhãn launchd riêng. 

~/.Hermes
` mặc định sử dụng 
`ai.Hermes.gateway

; các cài đặt khác sử dụng 
`ai.Hermes.gateway-<suffix

.
:::

## Bộ công cụ dành riêng cho nền tảng

Mỗi nền tảng có bộ công cụ riêng:| Nền tảng | Bộ công cụ | Khả năng |
|----------|----------|--------------|
| CLI |

Hermes-CLI
` | Toàn quyền truy cập |
| Telegram |

Hermes-Telegram
` | Công cụ đầy đủ bao gồm cả terminal |
| Discord |

Hermes-Discord
` | Công cụ đầy đủ bao gồm cả terminal |
| WhatsApp |

Hermes-WhatsApp
` | Công cụ đầy đủ bao gồm cả terminal |
| Chần chừ |

Hermes-Slack
` | Công cụ đầy đủ bao gồm cả terminal |
| Trò chuyện trên Google |

Hermes-Google_chat
` | Công cụ đầy đủ bao gồm cả terminal |
| Tín hiệu |

Hermes-Signal
` | Công cụ đầy đủ bao gồm cả terminal |
| SMS |

Hermes-sms
` | Công cụ đầy đủ bao gồm cả terminal |
| Email |

Hermes-email
` | Công cụ đầy đủ bao gồm cả terminal |
| Trợ lý tại nhà |

Hermes-homeassistant
` | Đầy đủ công cụ + điều khiển thiết bị HA (ha_list_entities, ha_get_state, ha_call_service, ha_list_services) |
| Quan trọng nhất |

Hermes-Mattermost
` | Công cụ đầy đủ bao gồm cả terminal |
| Ma trận |

Hermes-Matrix
` | Công cụ đầy đủ bao gồm cả terminal |
| DingTalk |

Hermes-DingTalk
` | Công cụ đầy đủ bao gồm cả terminal |
| Feishu/Lark |

Hermes-Feishu
` | Công cụ đầy đủ bao gồm cả terminal |
| WeCom |

Hermes-WeCom
` | Công cụ đầy đủ bao gồm cả terminal |
| Gọi lại WeCom |

Hermes-WeCom-callback
` | Công cụ đầy đủ bao gồm cả terminal |
| Weixin |

Hermes-weixin
` | Công cụ đầy đủ bao gồm cả terminal |
| BlueBubble |

Hermes-BlueBubbles
` | Công cụ đầy đủ bao gồm cả terminal |
| QQBot |

Hermes-qqbot
` | Công cụ đầy đủ bao gồm cả terminal |
| Nguyên Bảo |

Hermes-yuanbao
` | Công cụ đầy đủ bao gồm cả terminal |
| Nhóm Microsoft |

Hermes-teams
` | Công cụ đầy đủ bao gồm cả terminal |
| Máy chủ API |

Hermes-API-server
` | Công cụ đầy đủ (giảm 
`clarify

, 
`send_message

, 
`text_to_speech
` — quyền truy cập theo chương trình không có người dùng tương tác) |
| Webhooks |

Hermes-webhook
` | Công cụ đầy đủ bao gồm cả terminal |

## Vận hành cổng đa nền tảng

Một cổng thường chạy nhiều bộ điều hợp cùng một lúc (Telegram + Discord + Slack, v.v.). Các phần bên dưới bao gồm các hoạt động ngày thứ 2 trải rộng trên tất cả các nền tảng.

### Lệnh 

/platform
``Sau khi cổng đang chạy, hãy sử dụng lệnh gạch chéo 

/platform
` từ bất kỳ phiên CLI hoặc cuộc trò chuyện nào được kết nối để kiểm tra và điều khiển các bộ điều hợp riêng lẻ mà không cần khởi động lại toàn bộ cổng:

`
/platform list                  # show all adapters and their state
/platform pause <name          # stop dispatching new messages to one adapter
/platform resume <name         # re-enable a paused adapter

`

/platform list
` cho biết mỗi bộ chuyển đổi là 
`running

, 
`paused
` (thủ công) hay 
`paused-by-breaker
` (xem bên dưới). Việc tạm dừng giúp bộ điều hợp được tải và các vòng lặp trong nền của nó vẫn hoạt động — các tin nhắn đến sẽ bị rơi xuống sàn nhưng bản thân kết nối vẫn mở nên việc tiếp tục diễn ra ngay lập tức.

Xem thêm lệnh tóm tắt trạng thái rộng hơn [XPROTECTX114XPROTECTX](../../reference/slash-commands.md#info).`###Cầu dao tự động

Mỗi bộ chuyển đổi được bọc trong một bộ ngắt mạch. Các lỗi có thể thử lại lặp đi lặp lại (lỗi mạng, phản hồi giới hạn tốc độ, phản hồi ngược dòng 5xx, ngắt kết nối websocket) khiến bộ ngắt ngắt — bộ điều hợp tự động tạm dừng, thông báo của nhà điều hành được gửi đến kênh chính của một nền tảng trực tiếp khác khi một nền tảng được định cấu hình và một dòng nhật ký có cấu trúc được phát ra.

Bộ ngắt **không** tự động tiếp tục - nó vẫn mở cho đến khi bạn chạy 

/platform resume <name
` theo cách thủ công. Điều này là có chủ ý: nếu một nền tảng bị ngừng hoạt động liên tục, bạn không muốn kết nối lại cổng bị hỏng.

### Nơi tìm khi nền tảng bị tạm dừng

Khi bộ chuyển đổi bị tạm dừng, hãy kiểm tra:
1. **Nhật ký cổng** (

~/.Hermes/logs/gateway.log
` hoặc nhật ký đơn vị systemd / launchd). Tìm kiếm tên nền tảng và 
`circuit breaker

, 
`paused
` hoặc 
`disabled

. Sự kiện chuyến đi bao gồm số lần lỗi và lỗi cuối cùng.
2. Đầu ra **

/platform list

** — hiển thị trạng thái hiện tại và lý do cuối cùng.
3. **Trang trạng thái của nhà cung cấp** (Trạng thái API bot Telegram, trạng thái Discord, v.v.). Cầu dao bị vấp vì nền tảng không tốt; đừng cố gắng tiếp tục cho đến khi nó trở lại.

Khi thượng nguồn hoạt động tốt, 

/platform resume <name
` sẽ xóa cầu dao và cắm lại bộ chuyển đổi.

### Khởi động lại thông báo

Khi cổng khởi động lại (hoặc tắt trong các phiên đang hoạt động), cổng này có thể gửi thông báo một lần "nhân viên hỗ trợ đã quay lại"/"nhân viên hỗ trợ đã bị gián đoạn" tới kênh chính của mỗi nền tảng. Điều này được kiểm soát trên mỗi nền tảng bởi cờ 
`gateway_restart_notification
` trong 
`gateway-config.yaml

, mặc định là 
`true

:

``` yaml
gateway:
  platforms:
    Telegram:
      home_chat_id: "123456789"
      gateway_restart_notification: false   # opt out for this platform
    Discord:
      home_chat_id: "987654321"

      # gateway_restart_notification omitted → defaults to true

`
``Tắt nó trên các nền tảng ồn ào hoặc có mức độ ưu tiên thấp trong khi vẫn bật nó cho cuộc trò chuyện chính của bạn. Thông báo được gửi một lần mỗi lần khởi động lại, bất kể có bao nhiêu phiên trong chuyến bay.

### Phiên tiếp tục khởi động lại trên cổngKhi cổng tắt khi đang thực hiện lệnh gọi hoặc tạo công cụ, các phiên bị ảnh hưởng sẽ được gắn cờ là 
`restart_interrupted

. Trong lần khởi động tiếp theo, cổng sẽ lên lịch tự động tiếp tục cho từng người dùng — người dùng sẽ nhận được một thông báo ngắn trong cuộc trò chuyện ("Gửi bất kỳ tin nhắn nào sau khi khởi động lại và tôi sẽ cố gắng tiếp tục từ nơi bạn đã dừng lại.") và phiên bắt đầu từ lượt cam kết cuối cùng khi họ trả lời.

Hành vi này được bật theo mặc định và được ghi lại khi bắt đầu cổng:

`
Scheduled auto-resume for N restart-interrupted session(s)

`
``Không cần cấu hình. Nếu bạn không muốn nhận thông báo trước, hãy đặt 
`gateway_restart_notification: false
` trên nền tảng.

### Dọn dẹp bong bóng tiến trình (chọn tham gia)

Các thông báo về tiến trình của công cụ, nhịp tim "vẫn đang hoạt động..." và bong bóng gọi lại trạng thái có thể được xóa tự động sau khi có phản hồi cuối cùng. Kích hoạt trên mỗi nền tảng thông qua 
`display.platforms.<platform.cleanup_progress

:

``` yaml
display:
  platforms:
    Telegram:
      cleanup_progress: true
    Discord:
      cleanup_progress: true

`
``Mặc định là 
`false

. Chỉ những nền tảng có bộ điều hợp triển khai 
`delete_message
` mới tôn trọng cài đặt này (hiện tại là Telegram và Discord). Các lần chạy không thành công **bỏ qua** việc dọn dẹp để các bong bóng vẫn còn ở dạng vụn bánh mì.

## Các bước tiếp theo
- [Telegram Setup](Telegram.md)

- [Discord Setup](Discord.md)
- [Slack Setup](Slack.md)
- [Google Chat Setup](Google_chat.md)
- [WhatsApp Setup](WhatsApp.md)
- [Signal Setup](Signal.md)
- [SMS Setup (Twilio)](sms.md)
- [Email Setup](email.md)
- [Home Assistant Integration](homeassistant.md)
- [Mattermost Setup](Mattermost.md)
- [Matrix Setup](Matrix.md)
- [DingTalk Setup](DingTalk.md)
- [Feishu/Lark Setup](Feishu.md)
- [WeCom Setup](WeCom.md)
- [WeCom Callback Setup](WeCom-callback.md)
- [Weixin Setup (WeChat)](weixin.md)
- [BlueBubbles Setup (iMessage)](BlueBubbles.md)
- [QQBot Setup](qqbot.md)
- [Yuanbao Setup](yuanbao.md)
- [Microsoft Teams Setup](teams.md)
- [Teams Meetings pipeline](teams-meetings.md)
- [Open WebUI + API Server](open-webui.md)
- [Webhooks](webhooks.md)