Chuyển đến nội dung chính

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
openclaw channels

Quản lý tài khoản kênh trò chuyện và trạng thái runtime của chúng trên Gateway. Tài liệu liên quan:

​
Lệnh thường dùng

openclaw channels list
openclaw channels list --all
openclaw channels status
openclaw channels capabilities
openclaw channels capabilities --channel discord --target channel:123
openclaw channels capabilities --channel discord --target channel:<voice-channel-id>
openclaw channels resolve --channel slack "#general" "@jane"
openclaw channels logs --channel all
channels list chỉ hiển thị các kênh trò chuyện: theo mặc định là các tài khoản đã cấu hình, với thẻ trạng thái installed, configured và enabled cho từng tài khoản. Truyền --all để cũng hiển thị các kênh đi kèm chưa có tài khoản được cấu hình và các kênh trong catalog có thể cài đặt nhưng chưa có trên đĩa. Nhà cung cấp xác thực (OAuth + khóa API) và ảnh chụp nhanh mức sử dụng/hạn mức của nhà cung cấp mô hình không còn được in ở đây; dùng openclaw models auth list cho hồ sơ xác thực nhà cung cấp và openclaw status hoặc openclaw models list cho mức sử dụng.

​
Trạng thái / khả năng / phân giải / nhật ký

  • channels status: --channel <name>, --probe, --timeout <ms>, --json
  • channels capabilities: --channel <name>, --account <id> (chỉ với --channel), --target <dest>, --timeout <ms>, --json
  • channels resolve: <entries...>, --channel <name>, --account <id>, --kind <auto|user|group>, --json
  • channels logs: --channel <name|all>, --lines <n>, --json
channels status --probe là đường dẫn trực tiếp: trên một gateway có thể truy cập, nó chạy các kiểm tra probeAccount theo từng tài khoản và auditAccount tùy chọn, nên đầu ra có thể bao gồm trạng thái truyền tải cùng kết quả thăm dò như works, probe failed, audit ok hoặc audit failed. Nếu gateway không thể truy cập, channels status quay về các bản tóm tắt chỉ dựa trên cấu hình thay vì đầu ra thăm dò trực tiếp. Không dùng openclaw sessions, Gateway sessions.list hoặc công cụ agent sessions_list làm tín hiệu tình trạng socket của kênh. Các bề mặt đó báo cáo các hàng hội thoại đã lưu, không phải trạng thái runtime của nhà cung cấp. Sau khi nhà cung cấp Discord khởi động lại, một tài khoản đã kết nối nhưng im lặng có thể vẫn khỏe mạnh dù không có hàng phiên Discord nào xuất hiện cho đến sự kiện hội thoại đến hoặc đi tiếp theo.

​
Thêm / xóa tài khoản

openclaw channels add --channel telegram --token <bot-token>
openclaw channels add --channel nostr --private-key "$NOSTR_PRIVATE_KEY"
openclaw channels remove --channel telegram --delete
openclaw channels add --help hiển thị các cờ theo từng kênh (token, khóa riêng tư, app token, đường dẫn signal-cli, v.v.).
channels remove chỉ hoạt động trên các Plugin kênh đã cài đặt/cấu hình. Dùng channels add trước cho các kênh catalog có thể cài đặt. Với các Plugin kênh có runtime hỗ trợ, channels remove cũng yêu cầu Gateway đang chạy dừng tài khoản đã chọn trước khi cập nhật cấu hình, nên việc vô hiệu hóa hoặc xóa tài khoản sẽ không để listener cũ tiếp tục hoạt động cho đến khi khởi động lại. Các bề mặt thêm không tương tác thường gặp gồm:
  • kênh bot-token: --token, --bot-token, --app-token, --token-file
  • trường truyền tải Signal/iMessage: --signal-number, --cli-path, --http-url, --http-host, --http-port, --db-path, --service, --region
  • trường Google Chat: --webhook-path, --webhook-url, --audience-type, --audience
  • trường Matrix: --homeserver, --user-id, --access-token, --password, --device-name, --initial-sync-limit
  • trường Nostr: --private-key, --relay-urls
  • trường Tlon: --ship, --url, --code, --group-channels, --dm-allowlist, --auto-discover-channels
  • --use-env cho xác thực tài khoản mặc định dựa trên env khi được hỗ trợ
Nếu một Plugin kênh cần được cài đặt trong khi chạy lệnh thêm điều khiển bằng cờ, OpenClaw dùng nguồn cài đặt mặc định của kênh đó mà không mở lời nhắc cài đặt Plugin tương tác. Khi bạn chạy openclaw channels add không có cờ, trình hướng dẫn tương tác có thể nhắc:
  • id tài khoản cho từng kênh đã chọn
  • tên hiển thị tùy chọn cho các tài khoản đó
  • Route these channel accounts to agents now?
Nếu bạn xác nhận liên kết ngay, trình hướng dẫn sẽ hỏi agent nào nên sở hữu từng tài khoản kênh đã cấu hình và ghi các liên kết định tuyến theo phạm vi tài khoản. Bạn cũng có thể quản lý các quy tắc định tuyến tương tự sau này bằng openclaw agents bindings, openclaw agents bind và openclaw agents unbind (xem agents). Khi bạn thêm một tài khoản không mặc định vào kênh vẫn đang dùng thiết lập cấp cao nhất cho một tài khoản, OpenClaw nâng cấp các giá trị cấp cao nhất theo phạm vi tài khoản vào bản đồ tài khoản của kênh trước khi ghi tài khoản mới. Hầu hết kênh đặt các giá trị đó vào channels.<channel>.accounts.default, nhưng các kênh đi kèm có thể giữ lại một tài khoản đã nâng cấp khớp sẵn có. Matrix là ví dụ hiện tại: nếu đã có một tài khoản có tên, hoặc defaultAccount trỏ đến một tài khoản có tên hiện có, quá trình nâng cấp sẽ giữ lại tài khoản đó thay vì tạo accounts.default mới. Hành vi định tuyến vẫn nhất quán:
  • Các liên kết chỉ theo kênh hiện có (không có accountId) tiếp tục khớp với tài khoản mặc định.
  • channels add không tự động tạo hoặc ghi lại liên kết ở chế độ không tương tác.
  • Thiết lập tương tác có thể tùy chọn thêm liên kết theo phạm vi tài khoản.
Nếu cấu hình của bạn đã ở trạng thái hỗn hợp (có tài khoản có tên và giá trị một tài khoản cấp cao nhất vẫn được đặt), hãy chạy openclaw doctor --fix để chuyển các giá trị theo phạm vi tài khoản vào tài khoản đã nâng cấp được chọn cho kênh đó. Hầu hết kênh nâng cấp vào accounts.default; Matrix có thể giữ lại một mục tiêu có tên/mặc định hiện có.

​
Đăng nhập và đăng xuất (tương tác)

openclaw channels login --channel whatsapp
openclaw channels logout --channel whatsapp
  • channels login hỗ trợ --verbose.
  • channels login và logout có thể suy ra kênh khi chỉ có một mục tiêu đăng nhập được hỗ trợ đã cấu hình.
  • channels logout ưu tiên đường dẫn Gateway trực tiếp khi có thể truy cập, để đăng xuất dừng mọi listener đang hoạt động trước khi xóa trạng thái xác thực kênh. Nếu không thể truy cập Gateway cục bộ, nó quay về dọn dẹp xác thực cục bộ.
  • Chạy channels login từ terminal trên máy chủ gateway. Agent exec chặn luồng đăng nhập tương tác này; nên dùng các công cụ đăng nhập agent gốc theo kênh, như whatsapp_login, từ trò chuyện khi có sẵn.

​
Khắc phục sự cố

  • Chạy openclaw status --deep để thăm dò rộng.
  • Dùng openclaw doctor để nhận các bản sửa có hướng dẫn.
  • openclaw channels list không còn in ảnh chụp nhanh mức sử dụng/hạn mức của nhà cung cấp mô hình. Với các thông tin đó, dùng openclaw status (tổng quan) hoặc openclaw models list (theo từng nhà cung cấp).
  • openclaw channels status quay về các bản tóm tắt chỉ dựa trên cấu hình khi gateway không thể truy cập. Nếu thông tin xác thực kênh được hỗ trợ được cấu hình qua SecretRef nhưng không khả dụng trong đường dẫn lệnh hiện tại, nó báo cáo tài khoản đó là đã cấu hình với ghi chú suy giảm thay vì hiển thị là chưa cấu hình.

​
Thăm dò khả năng

Lấy gợi ý khả năng của nhà cung cấp (intents/scopes khi có) cùng hỗ trợ tính năng tĩnh: 
openclaw channels capabilities
openclaw channels capabilities --channel discord --target channel:123
Ghi chú:
  • --channel là tùy chọn; bỏ qua để liệt kê mọi kênh (bao gồm cả extensions).
  • --account chỉ hợp lệ với --channel.
  • --target chấp nhận channel:<id> hoặc id kênh số thô và chỉ áp dụng cho Discord. Với kênh thoại Discord, kiểm tra quyền đánh dấu các quyền còn thiếu ViewChannel, Connect, Speak, SendMessages và ReadMessageHistory.
  • Các thăm dò tùy theo nhà cung cấp: Discord intents + quyền kênh tùy chọn; Slack bot + phạm vi người dùng; cờ Telegram bot + Webhook; phiên bản daemon Signal; app token Microsoft Teams + vai trò/phạm vi Graph (được chú thích khi biết). Các kênh không có thăm dò báo cáo Probe: unavailable.

​
Phân giải tên thành ID

Phân giải tên kênh/người dùng thành ID bằng thư mục của nhà cung cấp: 
openclaw channels resolve --channel slack "#general" "@jane"
openclaw channels resolve --channel discord "My Server/#support" "@someone"
openclaw channels resolve --channel matrix "Project Room"
Ghi chú:
  • Dùng --kind user|group|auto để ép kiểu mục tiêu.
  • Phân giải ưu tiên các kết quả khớp đang hoạt động khi nhiều mục có cùng tên.
  • channels resolve là chỉ đọc. Nếu một tài khoản đã chọn được cấu hình qua SecretRef nhưng thông tin xác thực đó không khả dụng trong đường dẫn lệnh hiện tại, lệnh trả về kết quả chưa phân giải ở trạng thái suy giảm kèm ghi chú thay vì hủy toàn bộ lượt chạy.
  • channels resolve không cài đặt Plugin kênh. Dùng channels add --channel <name> trước khi phân giải tên cho một kênh catalog có thể cài đặt.

​
Liên quan