iMessage

Dùng Apple ID và người dùng macOS chuyên dụng để lưu lượng bot được cô lập khỏi hồ sơ Messages cá nhân của bạn.

Luồng điển hình:

1. Tạo/đăng nhập một người dùng macOS chuyên dụng.
2. Đăng nhập vào Messages bằng Apple ID của bot trong người dùng đó.
3. Cài đặt imsg trong người dùng đó.
4. Tạo wrapper SSH để OpenClaw có thể chạy imsg trong ngữ cảnh người dùng đó.
5. Trỏ channels.imessage.accounts.<id>.cliPath và .dbPath đến hồ sơ người dùng đó.

Lần chạy đầu tiên có thể yêu cầu phê duyệt GUI (Automation + Full Disk Access) trong phiên người dùng bot đó.

Cấu trúc liên kết phổ biến:

• gateway chạy trên Linux/VM
• iMessage + imsg chạy trên máy Mac trong tailnet của bạn
• wrapper cliPath dùng SSH để chạy imsg
• remoteHost bật tải tệp đính kèm qua SCP

Ví dụ:

{
channels: {
imessage: {
  enabled: true,
  cliPath: "~/.openclaw/scripts/imsg-ssh",
  remoteHost: "[email protected]",
  includeAttachments: true,
  dbPath: "/Users/bot/Library/Messages/chat.db",
},
},
}

#!/usr/bin/env bash
exec ssh -T [email protected] imsg "$@"

Dùng khóa SSH để cả SSH và SCP đều không tương tác. Đảm bảo khóa máy chủ được tin cậy trước (ví dụ ssh [email protected]) để known_hosts được điền.

iMessage hỗ trợ cấu hình theo từng tài khoản trong channels.imessage.accounts.

Mỗi tài khoản có thể ghi đè các trường như cliPath, dbPath, allowFrom, groupPolicy, mediaMaxMb, cài đặt lịch sử và danh sách cho phép gốc tệp đính kèm.

• thu nạp tệp đính kèm đầu vào là tùy chọn: channels.imessage.includeAttachments
• đường dẫn tệp đính kèm từ xa có thể được tải qua SCP khi remoteHost được đặt
• đường dẫn tệp đính kèm phải khớp với các gốc được phép:
  • channels.imessage.attachmentRoots (cục bộ)
  • channels.imessage.remoteAttachmentRoots (chế độ SCP từ xa)
  • mẫu gốc mặc định: /Users/*/Library/Messages/Attachments
• SCP dùng kiểm tra host-key nghiêm ngặt (StrictHostKeyChecking=yes)
• kích thước phương tiện gửi đi dùng channels.imessage.mediaMaxMb (mặc định 16 MB)

• giới hạn đoạn văn bản: channels.imessage.textChunkLimit (mặc định 4000)
• chế độ chia đoạn: channels.imessage.chunkMode
  • length (mặc định)
  • newline (tách ưu tiên đoạn văn)

Đích rõ ràng được ưu tiên:

• chat_id:123 (được khuyến nghị cho định tuyến ổn định)
• chat_guid:...
• chat_identifier:...

Đích handle cũng được hỗ trợ:

• imessage:+1555...
• sms:+1555...
• [email protected]

imsg chats --limit 20

Xác thực binary và hỗ trợ RPC:

imsg rpc --help
openclaw channels status --probe

Nếu probe báo RPC không được hỗ trợ, hãy cập nhật imsg.

Kiểm tra:

• channels.imessage.dmPolicy
• channels.imessage.allowFrom
• phê duyệt ghép nối (openclaw pairing list imessage)

Kiểm tra:

• channels.imessage.groupPolicy
• channels.imessage.groupAllowFrom
• hành vi danh sách cho phép channels.imessage.groups
• cấu hình mẫu lượt nhắc (agents.list[].groupChat.mentionPatterns)

Kiểm tra:

• channels.imessage.remoteHost
• channels.imessage.remoteAttachmentRoots
• xác thực khóa SSH/SCP từ máy chủ gateway
• khóa máy chủ tồn tại trong ~/.ssh/known_hosts trên máy chủ gateway
• khả năng đọc đường dẫn từ xa trên máy Mac chạy Messages

Chạy lại trong terminal GUI tương tác trong cùng ngữ cảnh người dùng/phiên và phê duyệt lời nhắc:

imsg chats --limit 1
imsg send <handle> "test"

Xác nhận Full Disk Access + Automation đã được cấp cho ngữ cảnh tiến trình chạy OpenClaw/imsg.