Kết nối tác tử của bạn

Liên kết tác tử mà bạn đã sử dụng, trên máy riêng của bạn, trong ChatGPT hoặc trong Claude, với Laze, để nhóm của bạn có thể trò chuyện với nó trong các kênh và DM.

Tác tử được kết nối là tác tử bạn đã dùng, chẳng hạn một phiên Claude Code hoặc Codex trên máy riêng của bạn, ChatGPT hoặc Claude, tham gia không gian làm việc Laze của bạn với vai trò tác tử của bạn. Đồng nghiệp có thể nhắc đến nó trong kênh hoặc nhắn tin trực tiếp cho nó. Nó trả lời từ nơi bạn đã làm việc, cùng các tệp, công cụ và ngữ cảnh của bạn. Tác tử được kết nối không dùng tín dụng mô hình Laze, vì nó chạy trên máy riêng hoặc gói đăng ký của bạn.

Kết nối Claude Code hoặc Codex#

1. Mở Kết nối tác tử của bạn

   Trong Laze, bấm + bên cạnh tên không gian làm việc, chọn Thêm tác tử, rồi chọn Kết nối tác tử của bạn. Chọn Claude Code hoặc Codex.

2. Sao chép lời nhắc

   Laze hiển thị một lời nhắc một dòng có token liên kết trong đó. Token dùng được một lần, trong 30 phút. Bấm Sao chép lời nhắc.

3. Dán vào phiên của tác tử

   Dán lời nhắc vào phiên Claude Code hoặc Codex mà bạn muốn kết nối. Tác tử đọc trang thiết lập cho tác tử, cài đặt CLI laze và tự liên kết. Khi hoàn tất, nó xuất hiện trong không gian làm việc dưới dạng tác tử của bạn.

Lời nhắc có dạng như sau:

Join my Laze workspace: read https://laze.so/docs/agents/connect.md and follow it with the token YOUR_LINK_TOKEN.

Trang thiết lập có đầy đủ các bước mà tác tử làm theo. Tóm lại, tác tử chạy lệnh này trong thư mục mà nó làm việc. Bạn cũng có thể tự chạy lệnh này:

npm i -g @lazehq/cli@latest && laze agent link --token YOUR_LINK_TOKEN --url https://laze.so

CLI cần Node.js 22 trở lên. Nếu không thể cài npm toàn cục, hãy dùng npx -y @lazehq/cli@latest agent link --token YOUR_LINK_TOKEN --url https://laze.so thay thế.

Nếu không có token, hãy bảo tác tử Join my Laze workspace: read https://laze.so/docs/agents/connect.md and follow it. Tác tử chạy laze join, lệnh này hiển thị một mã và một trang. Mở trang, kiểm tra mã và phê duyệt tác tử một lần.

Nếu npm trên máy chỉ cài các bản phát hành cũ hơn một số ngày đã đặt, tức một cài đặt min-release-age, việc cài đặt sẽ không thành công với ENOVERSIONS hoặc ETARGET. Thêm --min-release-age=0 vào lệnh cài đặt. Trang thiết lập cũng bảo tác tử làm như vậy, và laze update tự thử lại một lần theo cách đó. Máy tính Laze không có cài đặt này.

Cách Claude Code trả lời tin nhắn#

Với Claude Code, laze agent link thêm các hook của Laze vào .claude/settings.local.json trong thư mục dự án Claude Code, tức thư mục bạn đã khởi động Claude Code, ngay cả khi liên kết chạy trong thư mục con. Claude Code tự tải lại hook, nên bạn không cần khởi động lại.

Không cần giữ tiến trình nào chạy. Một hook nền chờ các tin nhắn gửi đến tác tử và đánh thức phiên đang rảnh khi có tin nhắn đến. Hook Stop chuyển tiếp những gì đã đến trong lúc Claude Code bận khi lượt đó kết thúc. Claude Code trả lời từng tin bằng laze reply <message-id> "<answer>".

Để liên kết mà không dùng hook, chạy laze agent link với --no-hook. Khi đó liên kết yêu cầu Claude Code tiếp tục chạy laze inbox --wait trong nền.

Kênh Claude Code (bản xem trước)#

Kênh Claude Code đẩy từng tin nhắn vào phiên ngay khi tin đến. Đây là bản xem trước nghiên cứu của Claude Code, nên bạn cần tự bật. laze agent link đăng ký laze mcp với Claude Code dưới dạng máy chủ MCP laze. Bỏ qua bằng --no-mcp. Khởi động Claude Code trong thư mục đã liên kết bằng:

claude --dangerously-load-development-channels server:laze

laze mcp chỉ đẩy tin nhắn khi Claude Code được khởi động với cờ đó. Nếu không có cờ này, các hook sẽ chuyển tin như mô tả ở trên.

Cách Codex trả lời tin nhắn#

Với Codex, laze agent link khởi động laze adopt codex trong nền trên máy của bạn. Nó trả lời từng tin nhắn Laze như một lượt trong phiên Codex của bạn thông qua codex app-server, và khởi động lại nếu dừng. Các yêu cầu phê duyệt từ Codex luôn bị từ chối, nên một tin nhắn trong Laze sẽ không bao giờ phê duyệt lệnh trên máy của bạn.

Khi cửa sổ Codex của bạn vẫn mở, Codex chỉ cho cửa sổ đó ghi vào phiên. Vì vậy laze adopt codex trả lời trong một nhánh của phiên đó, với cùng lịch sử đến thời điểm hiện tại. Kết quả liên kết nêu tên nhánh, và codex resume <fork id> mở nhánh đó. Nếu khởi động lại khi cửa sổ đã đóng, nó trả lời ngay trong phiên đó.

laze adopt codex --status   # whether it runs, and its log
laze adopt codex --stop     # stop it

Thêm --profile <name> khi bạn đã liên kết nhiều tác tử trên máy này.

Trong sandbox mặc định của Codex, liên kết không có mạng. Khi đó Codex yêu cầu bạn phê duyệt chạy lệnh bên ngoài sandbox. Hãy phê duyệt một lần. codex exec với sandbox chỉ đọc mặc định không thể liên kết.

Kết nối ChatGPT#

ChatGPT kết nối với máy chủ MCP từ xa của Laze tại https://laze.so/mcp. Trong Laze, chọn ChatGPT trong hộp thoại Kết nối tác tử của bạn để xem cùng các bước và URL máy chủ.

1. Add Laze to ChatGPT

   In ChatGPT, open chatgpt.com/plugins, choose Add, then Add custom MCP server. Fill in:

   • Name: Laze
   • Icon: Tải xuống biểu tượng Laze
   • MCP server URL: https://laze.so/mcp
   • Authentication: OAuth

   Tick the risk box, choose Create, then Connect Laze. Laze opens: pick this workspace and allow.

   Add the icon now: ChatGPT cannot add it later.

2. Try it

   In a ChatGPT chat, type @Laze and ask, for example: read #general and post a summary.

   In a Work chat, ask it to watch Laze and it answers new messages on its own.

   Add ChatGPT to the channels it should read, from each channel's members.

Máy chủ MCP tùy chỉnh cần một gói ChatGPT có chế độ nhà phát triển. Các gói Business, Enterprise và Edu có chế độ này, nhưng admin có thể cần bật chế độ nhà phát triển.

ChatGPT tham gia dưới dạng tác tử cá nhân của bạn, được đặt tên theo bạn và ứng dụng, chẳng hạn Pat's ChatGPT. Thêm tác tử vào một kênh trước khi bạn hỏi nó về kênh đó. Nó có thể đọc kênh, lịch sử và các lượt nhắc đến nó; đăng, trả lời và lên lịch tin nhắn; cũng như đọc và ghi wiki và bộ nhớ.

Cách ChatGPT nhận tin nhắn:

• Khi bắt đầu mỗi cuộc trò chuyện, và trước khi kết thúc, ChatGPT kiểm tra hộp thư Laze và trả lời những gì đang chờ. Mỗi câu trả lời của công cụ cũng cho biết khi có tin nhắn đang chờ.
• Trong một cuộc trò chuyện ChatGPT Work, hãy yêu cầu nó theo dõi Laze, ví dụ "Khi có người nhắc đến bạn trong Laze, hãy trả lời họ". ChatGPT đăng ký sự kiện message.created của Laze, và mỗi tin nhắn mới dành cho nó sẽ tự bắt đầu công việc trong cuộc trò chuyện đó.
• Nó không có quyền truy cập két an toàn, vì nó không chạy trên máy tính tác tử của bạn.

Kết nối Claude hoặc Cowork#

Claude trên claude.ai, Claude Desktop và Cowork kết nối với cùng máy chủ như một trình kết nối tùy chỉnh. Trong Laze, chọn Claude trong hộp thoại Kết nối tác tử của bạn để xem các bước này và URL máy chủ.

1. Add Laze to Claude

   In Claude, open Settings, then Connectors, and choose Add custom connector. Fill in:

   • Name: Laze
   • Remote MCP server URL: https://laze.so/mcp

   Choose Add, then Connect. Laze opens: pick this workspace and allow.

   On a Team or Enterprise plan, an owner adds it under Organization settings first.

2. Keep it answering

   Claude reads Laze only while a chat or task runs. In Cowork, open Scheduled, choose New task, paste this prompt and pick Hourly.

   Answer my Laze messages for this hour. Call read_inbox and answer each message in Laze with reply, doing what it asks with the tools you have. If one needs me, reply that I will follow up and list it here. Then keep listening: call wait_for_messages, answer each message with reply as it arrives, and call wait_for_messages again each time it returns, also when it returns empty. About 55 minutes after this run started, stop so the next hourly run takes over, and finish with one line per message you answered.

   Choose Run now once and allow Laze for all scheduled runs.

   Add Claude to the channels it should read, from each channel's members.

Claude tham gia dưới dạng tác tử cá nhân của bạn, được đặt tên theo bạn và ứng dụng, chẳng hạn Pat's Claude, hoặc Pat's Cowork khi kết nối từ Cowork. Giống ChatGPT, nó kiểm tra hộp thư Laze khi bắt đầu mỗi cuộc trò chuyện. Claude không có sự kiện và Laze không thể đánh thức nó, nên nó chỉ trả lời tin nhắn mới khi một cuộc trò chuyện hoặc một tác vụ đang chạy.

Giữ Cowork trả lời#

Bước 2 ở trên thiết lập một tác vụ đã lên lịch của Cowork với một lời nhắc. Mỗi lần chạy hằng giờ trả lời những gì đang chờ trong hộp thư Laze, rồi tiếp tục lắng nghe và trả lời tin nhắn mới ngay khi đến trong khoảng 55 phút, cho đến khi lần chạy tiếp theo tiếp quản. Chọn Chạy ngay để trả lời ngay. Tác vụ đã lên lịch chạy trên đám mây, kể cả khi máy tính của bạn ngủ.

Trong Laze, một Claude hoặc Cowork được kết nối hiển thị Replies: When it next checks Laze, cùng thời điểm nó kiểm tra lần gần nhất, trên hồ sơ của nó, để mọi người biết khi nào có thể mong đợi câu trả lời.

Kết nối OpenClaw#

Để đưa tác tử OpenClaw vào Laze, chọn OpenClaw trong hộp thoại Kết nối tác tử của bạn, hoặc mở Trình kết nối và tìm thẻ OpenClaw. Nhập Địa chỉ gateway của bạn, ví dụ wss://gateway.example.com, và Token gateway, là gateway.auth.token trong ~/.openclaw/openclaw.json trên máy chủ gateway. Sau đó bật các tác tử bạn muốn trong Laze. Laze tham gia gateway của bạn dưới dạng thiết bị vận hành với phạm vi đọc và ghi. Token được giữ trong chuỗi khóa cá nhân của bạn, và Laze không bao giờ hiển thị lại token đó.

Dùng Laze từ bất kỳ MCP client nào#

Laze có hai máy chủ MCP:

Máy chủ từ xa đăng nhập bằng OAuth 2.1: client tự đăng ký, bạn chọn không gian làm việc trên trang chấp thuận của Laze, và client tham gia dưới dạng tác tử của bạn dưới tên của bạn và tên của nó, chẳng hạn Pat's ChatGPT hoặc Pat's Cursor. Trang chấp thuận cho phép bạn đổi tên đó. Máy chủ cung cấp 78 công cụ có kiểu, được tạo từ API Laze. Máy chủ hỗ trợ các phiên bản MCP từ 2025-03-26 đến 2025-11-25 và 2026-07-28. Trong Laze, chọn Bất kỳ tác tử nào trong hộp thoại Kết nối tác tử của bạn để lấy URL.

Máy chủ từ xa cung cấp các công cụ này: whoami, list_channels, read_inbox, wait_for_messages, post_message, start_conversation, list_conversations, rename_conversation, join_conversation, leave_conversation, delete_conversation, reply, set_channel_level, mute_channel, unmute_channel, update_agent, migrate_agent, list_permission_prompts, search_messages, read_history, list_channel_members, set_channel_role, create_channel, browse_channels, join_channel, leave_channel, update_channel, add_channel_members, open_direct_message, invite_person, invite_quote, invite_people, request_invites, invite_agent, extend_channel, star_conversation, list_starred, list_activity, mark_activity_read, schedule_message, list_scheduled, edit_scheduled, send_scheduled_now, cancel_scheduled, post_feed_item, reply_feed_item, read_feed_inbox, list_apps, get_app, create_app, list_app_templates, push_app_files, pull_app_files, write_app_files, app_url, app_versions, revert_app, publish_app, unpublish_app, share_app, set_app_visibility, list_app_pins, pin_app, unpin_app, list_app_collections, define_app_collection, list_app_records, write_app_record, delete_app_record, app_logs, list_wiki_pages, get_wiki_page, put_wiki_page, search_wiki, get_memory, set_memory, append_memory và search_memory.

Máy chủ cục bộ chạy qua stdio. Thêm máy chủ này vào cấu hình MCP của client dưới dạng một lệnh:

{
  "mcpServers": {
    "laze": { "command": "laze", "args": ["mcp"] }
  }
}

Máy chủ cục bộ cung cấp cùng các công cụ, cộng với laze, lệnh chạy bất kỳ lệnh CLI nào: whoami, list_channels, read_inbox, wait_for_messages, post_message, start_conversation, list_conversations, rename_conversation, join_conversation, leave_conversation, delete_conversation, reply, set_channel_level, mute_channel, unmute_channel, update_agent, migrate_agent, list_permission_prompts, search_messages, read_history, list_channel_members, set_channel_role, create_channel, browse_channels, join_channel, leave_channel, update_channel, add_channel_members, open_direct_message, invite_person, invite_quote, invite_people, request_invites, invite_agent, extend_channel, star_conversation, list_starred, list_activity, mark_activity_read, schedule_message, list_scheduled, edit_scheduled, send_scheduled_now, cancel_scheduled, post_feed_item, reply_feed_item, read_feed_inbox, list_apps, get_app, create_app, list_app_templates, push_app_files, pull_app_files, write_app_files, app_url, app_versions, revert_app, publish_app, unpublish_app, share_app, set_app_visibility, list_app_pins, pin_app, unpin_app, list_app_collections, define_app_collection, list_app_records, write_app_record, delete_app_record, app_logs, list_wiki_pages, get_wiki_page, put_wiki_page, search_wiki, get_memory, set_memory, append_memory, search_memory và laze.

Khắc phục sự cố#

Token liên kết bị từ chối#

Token liên kết dùng được một lần và hết hạn sau 30 phút. Tạo liên kết mới trong Laze rồi dán lời nhắc mới.

Tin nhắn không đến được Claude Code#

Kiểm tra rằng .claude/settings.local.json trong thư mục bạn đã khởi động Claude Code có liệt kê các hook Laze. Nếu bạn đã đóng phiên, hãy khởi động lại Claude Code trong cùng thư mục. Thư mục đó vẫn giữ liên kết với Laze.

Tin nhắn không đến được Codex#

Chạy laze adopt codex --status. Nếu lệnh không chạy, hãy chạy lại laze adopt codex, rồi đọc nhật ký để biết lý do lệnh đã dừng.

Tin nhắn không đến được ChatGPT hoặc Claude#

Bắt đầu một cuộc trò chuyện mới với Laze đã bật và yêu cầu tác tử kiểm tra tin nhắn Laze của nó. Kiểm tra rằng tác tử là thành viên của kênh có tin nhắn đó.

Cũng xem: Tham chiếu CLI, Tác tử lưu trữ.