其他聊天平台
具有可用集成但尚未提取为独立指南的通道。每个通道都通过功能门控进行控制;在构建时启用相应的 channel-<name> 功能。
Discord
[channels.discord]
enabled = true
bot_token = "..." # 在 https://discord.com/developers/applications 创建
allowed_guilds = ["123..."]
allowed_users = []
reply_to_mentions_only = true
draft_update_interval_ms = 750 # 如果遇到 Discord 速率限制,请增加此值
- 所需的机器人意图: 消息内容意图、服务器成员意图。在开发者门户中设置。
- 流式传输: 完整模式 — 就地编辑消息,并将长回复拆分为多条消息。
- 工具调用指示器: 工具运行时的输入指示器;针对 shell 和浏览器调用的可见代码块预览。
Slack
[channels.slack]
enabled = true
bot_token = "xoxb-..." # 经典机器人令牌
app_token = "xapp-..." # 用于 Socket 模式
signing_secret = "..."
allowed_channels = ["C01..."]
- Socket 模式是默认模式(无需公共 webhook URL)。
- 对于 HTTP Events API,请移除
app_token,并将 Slack 的事件订阅 URL 指向网关上的/slack/events。 - 支持多消息流式传输、线程回复和斜杠命令入口。
Telegram
[channels.telegram]
enabled = true
bot_token = "..." # 来自 @BotFather
allowed_users = [123456789]
allowed_chats = [-100987...] # 群组/频道 ID
use_long_polling = true # 默认值 — 无需配置 webhook
- 长轮询是默认模式,无需公开 URL。通过设置
webhook_url切换到 Webhook 模式(然后暴露网关)。 - 支持流式草稿编辑,但受 Telegram 速率限制的限制。如果看到“Too Many Requests”错误,请调整
draft_update_interval_ms。
iMessage(仅限 macOS)
[channels.imessage]
enabled = true
provider = "linq" # 用于 iMessage/RCS/SMS 的 Linq 合作伙伴 API
api_key = "..."
仅限 macOS,需要 Linq 作为第三方中继,或直接使用 AppleScript 自动化(实验性功能,需要完全磁盘访问权限和辅助功能权限)。
WeCom Bot Webhook (企业微信群机器人)
[channels.wecom.default]
enabled = true
webhook_key = "..." # key from the group bot webhook URL
WeCom Bot Webhook is send-only through the group bot webhook API. Use it for simple outbound delivery into a WeCom group when ZeroClaw does not need to receive messages from WeCom.
WeCom channel choices
| 用例 | Config block | 传输 | Direction |
|---|---|---|---|
| Send simple messages into a WeCom group bot webhook | [channels.wecom.<alias>] | WeCom group bot webhook | Outbound only |
| Receive and reply as a WeCom AI Bot | [channels.wecom_ws.<alias>] | WeCom AI Bot long connection over WebSocket | Bidirectional |
wecom_ws uses WebSocket as the transport, but it is not a generic WebSocket-compatible channel. It implements WeCom’s AI Bot long-connection protocol, including subscription, inbound callback frames, response commands, request acknowledgements, user/group allowlists, and encrypted attachment handling.
WeCom AI Bot Long Connection (企业微信智能机器人长连接)
[channels.wecom_ws.default]
enabled = true
bot_id = "..."
secret = "..."
allowed_users = ["zeroclaw_user"] # empty denies all users
allowed_groups = ["zeroclaw_group"] # empty denies all groups
bot_name = "danya" # optional group mention alias
stream_mode = "partial"
file_retention_days = 7
max_file_size_mb = 20
# proxy_url = "http://127.0.0.1:7890" # optional per-channel override
This channel connects to WeCom’s AI Bot long-connection API over WebSocket. Use it when ZeroClaw needs to receive WeCom messages and reply as the AI Bot. For simple outbound-only group webhook delivery, use [channels.wecom.<alias>] instead.
The WebSocket is only the transport. The channel still implements WeCom-specific subscription/auth, msg_callback parsing, aibot_respond_msg / aibot_send_msg replies, request acknowledgement handling, allowlists, group addressing, and encrypted attachment handling. Enabling wecom_ws does not change existing webhook behavior.
Access control is explicit. If both allowed_users and allowed_groups are empty, inbound messages are denied. Use "*" only for controlled test deployments.
Set bot_name to the visible WeCom robot name when using the channel in groups. This lets ZeroClaw recognize messages such as @danya say hi as addressed to the bot during reply-intent prechecks.
Attachments sent by WeCom can be downloaded into the workspace cache and represented to the model as local markers such as [IMAGE:/absolute/path.png] or [Document: /absolute/path.bin].
Outbound image payloads are not supported yet. stream_mode supports "partial" for progressive draft updates or "off" for final replies only.
WeChat personal iLink Bot (微信个人号 iLink)
[channels.wechat]
enabled = true
allowed_users = ["*"]
# api_base_url, cdn_base_url, and state_dir are optional overrides.
WeChat personal iLink Bot is a different channel from WeCom. It uses QR-code login against the iLink Bot API for personal WeChat conversations and should not be used for WeCom enterprise bot traffic.
钉钉
[channels.dingtalk]
enabled = true
app_key = "..."
app_secret = "..."
robot_code = "..."
阿里巴巴的企业通讯工具。与企业微信具有相同的机器人界面。
飞书
[channels.lark]
enabled = true
app_id = "..."
app_secret = "..."
[channels.qq]
enabled = true
bot_id = "..."
bot_token = "..."
腾讯的消费级即时通讯工具。机器人 API 访问需要开发者注册。
IRC
[channels.irc]
enabled = true
server = "irc.libera.chat"
port = 6697
tls = true
nickname = "zeroclaw"
channels = ["#mychannel"]
nickserv_password = "..." # 可选
经典 IRC。支持 SASL、NickServ 认证以及多频道。
Mochat
[channels.mochat]
enabled = true
api_key = "..."
# 其他特定于提供者的字段
Notion
[channels.notion]
enabled = true
integration_token = "..."
databases = ["..."] # 智能体可写入的数据库 ID
将 Notion 数据库视为消息表面。适用于“通道”为任务收件箱的异步工作流。
何时选择专用指南
具有更复杂设置(OAuth 流程、端到端加密、多设备考虑)的频道位于其各自的页面中:
- Matrix — E2EE、设备验证、Synapse/Dendrite 特定内容
- Mattermost
- 行
- Nextcloud Talk
- Signal
如果您在上述任何渠道中遇到配置问题,请提交包含复现步骤的 Issue,我们将考虑将其提升为专门的指南。