Maka如何接入钉钉、飞书、微信IM扫码接入机器人完整教程【免费下载链接】makaApache Maka (Incubating) is a local-first AI agent workspace. Model messages, tool calls, tool results, permission decisions, and termination events are recorded as an append-only log.项目地址: https://gitcode.com/GitHub_Trending/mak/makaMakaApache MakaIncubating是一个本地优先的 AI Agent 工作台除了桌面端它还支持把机器人接入钉钉、飞书、企业微信和个人微信让你在手机上随时向自己的 Agent 发消息、查看工具执行结果。本文是一份面向新手的完整教程不用手动填一堆密钥扫码即可完成机器人创建、凭据保存和连接启动凭据全程只留在你的电脑上。为什么要在 IM 里和 Maka 对话Maka 的核心设计理念是数据在你的机器上模型消息、工具调用、工具结果、权限决策和终止事件都会以追加日志的形式保存在本机界面只是这份记录的一个视图。把 IM 接入进来之后它解决的问题很实际离开电脑也能用通过飞书、微信等平台从其他设备与 Maka 对话免密钥配置快捷接入模式下平台负责完成应用注册Maka 自动取得凭据、启用渠道并启动消息桥接凭据不出本机扫码拿到的 Secret 只保存在本机设置文件中界面中只能看到打码值不会上传到任何云端行为可追溯IM 里发生的对话同样进入同一份可恢复的运行记录而不是丢失在聊天记录里。先看清楚Maka 支持哪些 IM 渠道打开 Maka 桌面端进入设置 → 远程接入页面即可看到全部渠道清单。V1 快捷接入扫码覆盖以下平台平台接入方式运行通道备注钉钉扫码注册应用Stream 长连接扫码确认后自动回传 AppKey飞书 / Lark扫码创建机器人官方 Channel WebSocket同一个渠道内可切换区域企业微信扫码创建 AI 应用官方 AI Bot WebSocket需企业管理员扫码确认个人微信扫码登录本机 bridgeiLink 轮询需手机微信 iOS/Android 8.0.70另外 Telegram、QQ、Discord、Slack 等平台支持手动配置接入。各平台的桥接实现分别位于packages/runtime/src/bots/目录例如dingtalk-bridge.ts钉钉、feishu-bridge.ts飞书、wecom-bridge.ts企业微信、wechat-bridge.ts微信由统一的bot-registry.ts管理生命周期。 每个平台同一时间只有一个扫码会话二维码过期或授权被拒后界面上可以直接点重新生成。一键接入钉钉机器人 4 步配置教程以钉钉为例整个流程通常 1 分钟内完成飞书、企业微信的步骤完全一致。第 1 步准备环境。从源码启动 MakamacOS Apple Silicon 桌面版git clone https://gitcode.com/GitHub_Trending/mak/maka cd maka npm ci npm run dev第 2 步进入远程接入页面。在 Maka 左下角打开设置选择远程接入页面描述为通过 Telegram、飞书、微信等平台从其他设备与 Maka 对话。第 3 步扫码接入。选中钉钉在接入方式里选择快捷接入推荐点击开始快捷绑定。Maka 会生成一张安全二维码——用钉钉 App 扫描并在手机上确认授权。此时主进程正在与平台注册端点轮询窗口状态会实时从等待扫码跳到已扫码再到正在连接。第 4 步自动落盘并启动监听。授权完成后Maka 在 main process 内把凭据映射为渠道配置AppId / AppSecret、原子写入设置、并让BotRegistry启动 Stream 桥接。页面出现凭据已安全保存并开始连接提示渠道状态变为监听中即可在手机钉钉里给机器人发消息了。飞书机器人接入别忘区分飞书与 Lark 区域飞书和 Lark海外版共用同一个feishu渠道区别只在域名国内用户选择飞书feishu.cn扫码走accounts.feishu.cn的注册流程海外用户切换Lark走larksuite.com的注册流程。在快捷接入弹窗内即可切换品牌区域。确认后 Maka 自动保存 App ID 与 App Secret并通过官方 Channel WebSocket 建立长连接。飞书 SDK 标准化后的消息再映射为 Maka 的内部事件原始 payload 不会跨越 runtime 边界。企业微信管理员扫码即完成绑定企业微信的快捷绑定面向企业管理员在远程接入页选中企业微信选择快捷接入用企业微信 App 扫描弹窗中的二维码管理员在手机上确认机器人创建Maka 自动保存 Bot ID 与 Secret并启动官方 AI Bot WebSocket 长连接。连接建立后有独立的 15 秒认证等待窗口认证通过页面才会显示运行可用失败则提示最近一次失败原因可点重启监听重试。个人微信扫码登录本机 bridge 专属通道个人微信走的是本机 wechat-bridge桥接方案与其他平台略有不同需要手机微信为iOS / Android 8.0.70 及以上版本bridge 默认监听http://127.0.0.1:18400Maka 会先向本机 bridge 索取登录二维码再展示在弹窗中用手机微信扫码并在手机上确认即完成个人微信登录状态窗口每 3 秒刷新一次登录进度二维码过期可点刷新二维码重新获取如需向公众号发消息可在高级设置里补充公众号 App ID / App Secret仅用于公众号消息发送。⚠️ 注意断开微信登录会清除本机保存的扫码凭据之后需要重新扫码才能继续使用微信渠道。手动配置扫码不可用时的备用方案每个渠道详情页都保留了手动配置入口适合平台能力受限或已有现成应用的情况。各平台需要填写的凭据如下平台需要填写的凭据获取方式钉钉应用密钥AppId、Client Secret钉钉开发者后台创建机器人应用飞书App ID、App Secret、事件订阅域名飞书开放平台创建应用企业微信AI 应用 Bot ID、Secret企业微信管理后台创建 AI 应用个人微信本机 bridge Token可选公众号 App ID/Secret本机 wechat-bridge手动填写后先点测试连接凭据探测通过再点测试并连接避免把错误配置直接推向运行态。安全边界凭据只留在你这台机器Maka 的 IM 接入在设计上有一条硬边界值得新手了解详见docs/architecture/bot-onboarding-runtime.zh-CN.md密钥只存在于 main process设备码、轮询 token 和最终凭据从不进入渲染进程界面拿到的只是打码快照存储仅本机凭据写入 owner-only 的设置文件弹窗中也明确提示凭据仅保存在本机不会传给 renderer 或 Maka 云端取消即回滚扫码中途取消Maka 会停止本地轮询并阻止迟到凭据落盘已跨入写入窗口的会执行受保护的字段级回滚不会覆盖你同时做的手动修改白名单控制渠道支持配置允许的用户 ID每行一个留空表示不限名单外的来信会被静默忽略防止陌生人驱动你的 Agent。常见问题排查FAQQ1二维码一直转圈/状态停在准备扫码接入…检查网络。所有平台注册请求都由 main process 发出单次超时 15 秒国内网络访问 Telegram、Discord 类渠道时界面上会提示需要 TUN 代理模式打开后重启应用即可。Q2显示凭据已保存但连接尚未成功启动说明设置已落盘但 bridge 启动失败。先点测试连接确认凭据有效再点重启监听仍失败时查看运行日志中的最近一次失败详情。Q3扫码确认了但渠道没反应确认渠道开关已打开且允许用户 ID 白名单没有把自己挡在外面。白名单填错比如填了用户名而非数字 ID会匹配不到任何人界面对此有专门的提示。Q4二维码过期或被拒绝授权怎么办直接点重新生成。每个平台同一时间只保留一个 current session新会话会自动接管。总结Maka 的 IM 接入体验你关心的Maka 的做法配置难度扫码 4 步完成凭据自动回传覆盖平台钉钉、飞书、Lark、企业微信、微信快捷接入Telegram/QQ/Discord/Slack 手动接入数据安全凭据仅本机存储界面只见打码值取消即回滚可观测性监听状态、最近事件、测试与重启一键可达行为记录IM 对话进入与桌面端同一份 append-only 运行日志想深入了解数据流、状态机与回滚契约可以阅读仓库内的架构文档docs/architecture/bot-onboarding-runtime.zh-CN.md和桥接源码packages/runtime/src/bots/桌面端设置交互的文案契约在apps/desktop/src/renderer/locales/settings-bot-copy.ts中维护。把 Maka 接入你每天在用的 IM从一次扫码开始。【免费下载链接】makaApache Maka (Incubating) is a local-first AI agent workspace. Model messages, tool calls, tool results, permission decisions, and termination events are recorded as an append-only log.项目地址: https://gitcode.com/GitHub_Trending/mak/maka创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考