Loại bỏ BlueBubbles và lộ trình iMessage qua imsg

OpenClaw không còn cung cấp kênh BlueBubbles. Khả năng hỗ trợ iMessage hoạt động thông qua plugin imessage đi kèm: Gateway khởi chạy imsg dưới dạng tiến trình con, cục bộ hoặc thông qua trình bao bọc SSH, rồi giao tiếp bằng JSON-RPC qua stdin/stdout. Không máy chủ, không webhook, không cổng.

Nếu cấu hình của bạn vẫn chứa channels.bluebubbles, hãy di chuyển sang channels.imessage. URL tài liệu cũ /channels/bluebubbles chuyển hướng đến Chuyển từ BlueBubbles, trong đó có đầy đủ bảng chuyển đổi cấu hình và danh sách kiểm tra chuyển đổi.

Những thay đổi

• Lộ trình iMessage được hỗ trợ không có máy chủ HTTP BlueBubbles, tuyến webhook, mật khẩu REST hoặc môi trường chạy plugin BlueBubbles.
• OpenClaw đọc và theo dõi Tin nhắn thông qua imsg trên máy Mac đã đăng nhập vào Messages.app.
• Các chức năng gửi, nhận, lịch sử và nội dung đa phương tiện cơ bản sử dụng các giao diện imsg thông thường và quyền của macOS.
• Các thao tác nâng cao (trả lời theo luồng, phản ứng tapback, chỉnh sửa, thu hồi, hiệu ứng, thông báo đã đọc, chỉ báo đang nhập, quản lý nhóm) cần cầu nối API riêng tư: chạy imsg launch, thao tác này yêu cầu tắt SIP.
• Gateway trên Linux và Windows vẫn có thể sử dụng iMessage bằng cách trỏ channels.imessage.cliPath đến trình bao bọc SSH chạy imsg trên máy Mac đã đăng nhập.

Việc cần làm

1. Cài đặt và xác minh imsg trên máy Mac chạy Tin nhắn:

   brew install steipete/tap/imsgimsg --versionimsg chats --limit 3imsg rpc --help

2. Cấp quyền Truy cập toàn bộ ổ đĩa và Tự động hóa cho ngữ cảnh tiến trình chạy imsg và OpenClaw.

3. Chuyển đổi cấu hình cũ:

   {  channels: {    imessage: {      enabled: true,      cliPath: "/opt/homebrew/bin/imsg",      dmPolicy: "pairing",      allowFrom: ["+15555550123"],      groupPolicy: "allowlist",      groupAllowFrom: ["+15555550123"],      groups: {        "*": { requireMention: true },      },      includeAttachments: true,    },  },}

4. Khởi động lại Gateway và xác minh:

   openclaw channels status --probe

5. Kiểm tra tin nhắn trực tiếp, nhóm, tệp đính kèm và mọi thao tác API riêng tư mà bạn phụ thuộc vào trước khi xóa máy chủ BlueBubbles cũ.

Ghi chú di chuyển

• channels.bluebubbles.serverUrl và channels.bluebubbles.password không có mục tương đương trong iMessage; không có máy chủ nào để kết nối hoặc xác thực.
• allowFrom, groupAllowFrom, groups, includeAttachments, attachmentRoots, mediaMaxMb, textChunkLimit và actions.* giữ nguyên ý nghĩa trong channels.imessage.
• channels.imessage.includeAttachments vẫn bị tắt theo mặc định. Hãy đặt giá trị này một cách rõ ràng nếu bạn muốn ảnh, bản ghi âm, video hoặc tệp nhận được chuyển đến tác nhân.
• Với groupPolicy: "allowlist", hãy sao chép khối groups cũ, bao gồm mọi mục ký tự đại diện "*". Danh sách cho phép người gửi trong nhóm và sổ đăng ký nhóm là hai cổng kiểm soát riêng biệt; khối groups có các mục nhưng không có chat_id khớp (hoặc không có "*") sẽ loại bỏ tin nhắn trong thời gian chạy, còn khối groups trống sẽ ghi cảnh báo khi khởi động mặc dù bộ lọc người gửi vẫn cho phép tin nhắn đi qua.
• Các liên kết ACP có match.channel: "bluebubbles" phải được đổi thành "imessage".
• Khóa phiên BlueBubbles cũ không trở thành khóa phiên iMessage. Phê duyệt ghép nối dựa trên định danh người gửi, vì vậy các mục allowFrom đã sao chép vẫn hoạt động, nhưng lịch sử hội thoại dưới các khóa phiên BlueBubbles không được chuyển sang.

Xem thêm

• Chuyển từ BlueBubbles
• iMessage
• Tham chiếu cấu hình - iMessage