OpenClaw：自托管AI助理，统一接入钉钉飞书微信的部署指南

2026年了如果你还在让微信、QQ、钉钉、飞书各自为战那 OpenClaw也有人叫 Clawdbot这种自托管 AI 助理框架绝对值得你花一晚上试试。它本质上是一个跑在你自己服务器上的“数字管家”把大模型、消息网关、任务脚本全部串在一起你可以在里面配置多个聊天入口然后让同一个 AI 大脑统一回复。最关键的是它零门槛不需要你懂深度学习也不用会写代码只要有台能联网的电脑或云主机按步骤跑几条命令就能搭起来。这篇文章我尽量把每一步都写到“保姆级”从环境准备、模型接入到钉钉、飞书、企业微信、公众号的接入姿势再到我踩过的坑一次讲清楚。适合动手能力一般的普通用户也适合想给团队做个统一客服入口的创业者参考。1. 先把OpenClaw是什么彻底搞清楚1.1 它到底解决了什么问题先说一个最常见的场景你白天在公司用钉钉晚上在客户群里用微信周末还要在飞书里跟进项目进度QQ群里还有一帮老朋友找你。每个平台都有人发消息每个平台都要求“及时回复”但你不可能同时挂着四五个窗口更不可能给每个平台都单独写一套 AI 回复脚本。OpenClaw 做的事情就是把“多平台消息汇聚”这件事统一接管。它内部有一个消息网关层所有平台都通过适配器把消息转换成统一格式然后把消息交给同一个大模型大脑。这个大脑可以根据历史记忆、你的知识库、预设指令去生成回复再通过对应的适配器把回复发回原平台。也就是说你在微信里问它“帮我整理一下昨天会议纪要”在钉钉里问同样的问题它表现出的状态是同一个助理而不是四个互不认识的机器人。除了聊天气泡OpenClaw 还支持插件和技能。你可以给这个助理挂上天气预报、待办提醒、文档检索、网页摘要之类的技能。我实际用下来最顺手的一个用法是把 Obsidian 笔记库挂进去它能直接基于我写的笔记回答“我上个月记录的服务器密码重置流程是什么”。之前的方案是去翻文件夹现在直接对话就能拿到答案。1.2 为什么是OpenClaw而不是自己写机器人很多人第一反应是我已经会写 Python也调过各平台 API自己写几个机器人不就行了说实话我一开始也是这么想的直到我自己写了一版之后发现真正麻烦的不是“发消息”而是“处理平台差异”。微信、QQ、钉钉、飞书的消息回调格式完全不一样群里消息和私聊消息的权限模型也不一样甚至同一个平台在不同时期的接口还会变。你在钉钉里一条消息是 Event 驱动在飞书里是长连接事件在微信公众号里是 XML 格式的加密请求每一套你都要去抠文档。OpenClaw 把这一层差异封装成标准适配器你只需要关心业务逻辑不需要关心平台底层。从架构上说它像一个“消息路由器”你定义路由规则这个大模型回复那个关键词触发某个脚本然后实时记录所有会话。这种现成的框架比自己从零撸省了至少一周时间。而且2026年这个时间点开源社区已经比较成熟。OpenClaw 的插件生态能覆盖知识库、RSS、定时任务、数据统计等常见需求社区文档也在持续更新。自己写代码很容易陷入“终于把微信接通了结果平台改了协议”的死循环用现成框架至少有人帮你踩坑。1.3 部署模式怎么选Docker、裸机还是云服务器我推荐优先用 Docker Compose 方式部署不是因为它最高端而是因为它最能保证“零门槛”。Docker 把依赖打包在一起命令只需要一条docker compose up -d升级也就是拉镜像重启删掉容器不会留残留。如果你家里有旧电脑或者云主机配置不高裸机安装 Node.js 再跑官方脚本也可以内存占用会更低但依赖冲突的可能性也会高一些。云服务器方面如果你还没有顺手的主机国内各家云厂商的免费试用活动基本能满足前期需求。我自己体验过阿里云免费试用一个月2核2G的配置跑 OpenClaw 一个小模型足够。家庭宽带的旧电脑内网穿透也能跑但注意回调稳定性这个我后面详细说。还有一点要提醒你的服务器必须能访问模型 API 和 IM 平台的服务器。千万别把服务器放在一个完全断内外网的环境里否则消息网关起来了模型和平台的连接却全走不通。2. 保姆级环境准备从WSL2到一台干净的Ubuntu2.1 5分钟搞定WSL2解决“无法安全验证”报错很多人在 Windows 上部署 OpenClaw遇到第一个报错就是“OpenClaw无法安全验证 WSL2 环境”。这不是 OpenClaw 本身的问题而是你的 WSL 内核老了或者默认版本不对。解决办法很简单打开 PowerShell管理员模式先运行一句wsl --status看输出里的“默认版本”。如果默认版本是 1就执行wsl --set-default-version 2如果提示找不到内核运行wsl --update然后重启电脑。重启后安装 Ubuntu 22.04wsl --install -d Ubuntu-22.04第一次打开 Ubuntu 会要求设置用户名和密码设置完成后你就已经拥有一个 Linux 环境了。为什么要这么折腾因为 OpenClaw 的安装脚本、Docker 运行环境、Node.js 依赖都是以 Linux 为基准的。在 WSL2 里跑 Linux 容器比在原生 Windows 上用 CMD 强多了。而且 WSL2 是一个真正的轻量虚拟机有完整内核Docker Desktop 也能直接挂上去。2.2 服务器初始化创建用户、更新系统、设时区如果你选择云服务器登录后第一件事是更新系统包sudo apt update sudo apt upgrade -y然后创建普通用户别一整天用 root 操作sudo adduser claw sudo usermod -aG sudo claw su - claw把时区改成上海sudo timedatectl set-timezone Asia/Shanghai顺手装一下后续会用到的工具sudo apt install -y curl git vim ufw开启防火墙只放行 SSH 和 OpenClaw 需要的端口sudo ufw allow OpenSSH sudo ufw allow 8080/tcp sudo ufw enable这里 8080 是你给 OpenClaw Web 控制台预留的端口如果你配置了别的端口记得同步改。就这样一个干净的 Ubuntu 基础环境就绪了。2.3 安装Docker和Node.js一台机器两种准备OpenClaw 官方推荐 Docker但有些朋友可能不想用容器或者服务器只有 1G 内存跑 Docker 吃力。所以我把两条路都说一下。安装 Dockercurl -fsSL https://get.docker.com | sh sudo systemctl enable --now docker验证docker --version docker compose version如果打算用裸机方式跑 Node.js先安装 Node 20 LTScurl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt install -y nodejs验证node -v npm -v这里有个小教训OpenClaw 对 Node 的奇数版本比如 19、21支持并不好尽量用偶数 LTS。我第一次装到 Node 23 上跑了两小时最后发现是版本问题换成 20 一切正常。3. 核心配置拆解模型、密钥与消息网关3.1 准备一个大模型APIDeepSeek、通义千问还是OllamaOpenClaw 本身不带智能它需要一个“大脑”。2026年可选的大模型非常多但从稳定性和成本角度我建议优先考虑国内 APIDeepSeek、通义千问、Kimi 都有成熟的 OpenAI 兼容接口。我的主力配置是 DeepSeek 的 deepseek-chat价格便宜中文理解好用来做客服和会议摘录基本够用。如果你更看重隐私可以本地部署 Ollama并拉取一个小参数模型curl -fsSL https://ollama.com/install.sh | sh ollama pull qwen2.5:3b ollama run qwen2.5:3b这里 qwen2.5:3b 是一个 30 亿参数模型2G 内存左右的机器也能跑起来回答比较快适合测试。跑通之后你可以换更大的模型提升智商。要注意Ollama 默认监听 11434 端口OpenClaw 容器里访问宿主机时要用http://host.docker.internal:11434不是127.0.0.1这是我刚开始踩过的坑。3.2 配置文件到底怎么写字段逐个讲OpenClaw 的配置最终会落到一个 YAML 文件假设是openclaw/config.yaml。下面这个示例基本覆盖了核心场景bot: name: 小助手 prompt: 你是我的私人助理回答简洁、准确不确定时直接说不知道。 model: provider: deepseek api_key: ${DEEPSEEK_API_KEY} model: deepseek-chat temperature: 0.3 max_tokens: 2000 memory: type: sqlite path: ./data/memory.db platforms: dingtalk: enabled: true app_key: ${DINGTALK_APP_KEY} app_secret: ${DINGTALK_APP_SECRET} feishu: enabled: true app_id: ${FEISHU_APP_ID} app_secret: ${FEISHU_APP_SECRET} wecom: enabled: true corp_id: ${WECOM_CORP_ID} agent_id: ${WECOM_AGENT_ID} secret: ${WECOM_SECRET}temperature我一般调到 0.3因为助理场景要的是稳定不是天马行空。max_tokens控制单次回复长度2000 够日常使用。memory.type选 sqlite就是让它可以跨时间记住你是谁、上回聊到哪。密钥不要直接写在 YAML 里而是放到.env文件然后通过${变量名}引用。这样的好处是未来把配置分享给别人时不会泄露密钥。3.3 启动服务一条命令完成怎么看日志清理好.env之后开始启动cd openclaw cp .env.example .env nano .env # 在里面填好所有密钥 docker compose up -d第一次启动会拉镜像可能比较久耐心等。然后看日志docker compose logs -f openclaw如果一切正常你会看到类似gateway started、listening on 0.0.0.0:8080的日志。此时 OpenClaw 就已经处于待命状态只是还没有接入任何平台。如果使用裸机源码方式则按下面执行npm install npm run dev日志里出现“ready”字样就算成功。要注意docker compose restart不会重新读取环境变量改了.env后必须用docker compose down docker compose up -d才会生效。3.4 可选挂上Obsidian知识库让AI有“记忆”如果你的笔记都在 ObsidianOpenClaw 社区有对应的适配插件。操作起来很简单在配置文件里加一段知识库路径指向你 Obsidian 的本地文件夹然后设置索引间隔。这样在聊天里问“我之前记录的 XX 脚本思路是什么”它会先去笔记里检索再综合回答。我实际用下来最值钱的不是让 AI 记流水账而是让它基于我自己的笔记做推理。比如我笔记里记了“服务器密码每个月换一次”它就能在回复中直接引用那篇笔记的标题。这个功能对个人知识管理爱好者来说比单纯接 IM 更让人上瘾。4. 四款IM接入实操钉钉、飞书、企业微信与个人微信/QQ4.1 钉钉机器人接入优先用Stream模式不用买公网回调钉钉的接入方式最近几年变化很大旧教程还在让你填“公网回调 URL”但 2026 年我强烈建议直接用 Stream 模式。Stream 模式就是机器人主动连上钉钉服务器不需要你的服务器有公网地址这对家里部署来说省事太多了。操作步骤登录钉钉开发者后台选择“企业内部开发”创建一个企业内部应用。在应用信息里拿到 AppKey 和 AppSecret。添加“机器人”能力配置方式选“Stream 模式”。把 AppKey/AppSecret 填到 OpenClaw 的.env中对应DINGTALK_APP_KEY和DINGTALK_APP_SECRET。重启 OpenClaw 容器在钉钉群里添加机器人然后 它发一句“你好”。如果选择 HTTP 模式则必须有一个公网 HTTPS 地址并且要把回调地址指到 OpenClaw 的/dingtalk/webhook路径。我建议新手直接用 Stream免去配置 HTTPS 证书的麻烦。4.2 飞书自建应用接入权限和事件订阅是关键飞书同样支持“长连接”方式适合家庭部署。步骤如下打开飞书开放平台创建“企业自建应用”。在“应用能力”里添加“机器人”。在“权限管理”里开通消息相关权限至少要有im:message:read和im:message:send。在“事件订阅”里选择“使用长连接接收事件”订阅im.message.receive_v1。发布应用版本并确保开发者后台里已启用。然后把 App ID 和 App Secret 填进 OpenClaw 配置重启在飞书群里添加机器人发消息测试。这里最大的坑是“发布应用版本”这一步如果你只改了权限但是不发布新版本机器人永远没有权限收到消息也不会处理。我在这一步卡了半小时后来发现是发布按钮一直没点。4.3 企业微信和公众号官方通道里最稳的选择微信生态要想合规稳定个人微信没有官方真机器人接口但企业微信和公众号是允许开发者做消息服务的。以公众号为例先准备一个已认证的服务号或者用测试号也可以在公众号后台“设置与开发 - 基本配置”中启用服务器配置。URL 填https://你的域名/openclaw/wechatToken 自己随便写一个固定字符串EncodingAESKey 可以生成或留空明文模式下留空。把 URL、Token、EncodingAESKey 填入 OpenClaw 的公众号配置。点击提交微信会往你的 URL 发一条验证请求只要 OpenClaw 在运行验证基本秒过。验证通过后粉丝在公众号里发消息OpenClaw 就能响应。企业微信也类似创建自建应用在“接收消息服务器配置”里填上 OpenClaw 的回调地址然后把可信 IP 设为你的服务器公网 IP。这套流程最大的优点是平台官方支持不会一言不合封号。4.4 个人微信和QQ接入能接但风险请自己扛我知道很多人最想要的就是个人微信接入所以必须把话说透个人微信没有任何官方对外聊天机器人接口市面上的方案几乎都是逆向协议、HOOK、模拟点击一类灰色手段。这类方案往往同时要求你保持登录状态、不能多开、不能频繁发消息否则极其容易被限制。QQ 的情况也类似曾经流行的开源协议库已经停止维护现在新方案基本都会遇到风控。我不会在正文里贴逆向方案不是因为不想给你是因为这种东西即便今天能用明天平台一改协议就失效。你花两天调通的代码可能睡一觉就成了一堆废铁。如果你只为了学习测试非要试个人微信我的建议是用手机注册一个备用小号不要加任何认识的人不要建群不要跑高频任务不要尝试群发把这个号当成纯测试沙盒。把风险控制在自己手里比任何技术都重要。那是不是微信生态就不能接不是。正确的姿势是企业微信的“客户联系”能力和公众号留言。把 OpenClaw 接到企业微信客户群做售前自动答疑这是官方支持的玩法稳定得多。4.5 多平台共存身份映射和去重把钉钉和飞书同时接上之后很快会发现一个问题同一个用户在不同平台里是不同 ID。如果你不做身份映射这个人在钉钉问“我昨天让你记的快递单号是多少”OpenClaw 在飞书里查不到他的记忆。因为memory存储默认按平台 ID 记账。解决办法是在 OpenClaw 里配置一个统一用户 ID 的转换表把各平台的用户 ID 映射到一个内部唯一 ID 上。我用的方式是把手机号或邮箱作为统一标识在平台适配器里通过用户信息查询到手机号再作为记忆 key。另外消息去重也很重要特别是群聊里如果同一个平台配了两个机器人实例很容易同一条消息被触发两次。用幂等 key 消化掉会省去很多尴尬。5. 常见问题与排查技巧实录5.1 收不到消息先查平台事件和网络可达性我遇到过太多人一上来就说“我的机器人没反应”但最后 90% 不是 OpenClaw 的问题而是平台侧没把事件送过来。排查顺序我建议这样平台后台确认事件订阅是否成功钉钉看 Stream 是否在线飞书看“事件订阅”里是否有失败记录。确认 OpenClaw 的日志有[INFO] message received。没有这条日志说明消息没到应用这层。确认配置的端口可以被外网访问云服务器要去安全组放行端口家庭服务器需要内网穿透。如果前面都正常只是平台回调地址不通你会看到平台侧反复推送失败的记录。这时把回调地址放到浏览器里访问一下看是否能正常返回状态码。5.2 日志里的“connection reset”和“timeout”connection reset通常意味着长连接被对面断开常见原因有服务器 IP 变了、家庭宽带掉线、平台主动回收空闲连接。解决办法是稳定 IP或者开启 OpenClaw 的自动重连机制。大部分版本默认会自动重连但你要确认日志里面有retry after 5s一类的记录。timeout则集中在模型调用上。如果你用免费 API 或本地小模型推理速度慢OpenClaw 默认超时可能不够。可以在模型配置里加请求超时参数比如timeout: 120。我实测本地 qwen2.5:3b 在 CPU 机器上推理一次可能要 10 秒以上所以超时不能设太短。5.3 配置改了为什么不生效改.env后只docker compose restart不够因为 compose 不会重新加载环境变量。正确操作是docker compose down docker compose up -d改config.yaml也是同理。之后用docker compose logs -f openclaw确认加载的是新配置。如果改了密钥建议在日志里先搜一下有没有config loaded这样的启动信息。5.4 模型报错“authentication failed”或者“invalid_api_key”这就是明牌的密钥问题。先去 API 平台创建一个新密钥确认没有多余空格然后看.env引用的变量名是否与配置文件一致。注意有些平台的密钥是sk-开头有些是Bearer格式OpenClaw 一般会自动加前缀但你千万不要在.env里手动加Bearer否则报错非常常见。如果你用的是本地 Ollama先验证curl http://127.0.0.1:11434/api/tags能返回模型列表就说明服务正常。然后记得在容器内用host.docker.internal访问宿主机别用127.0.0.1。5.5 问题排查速查表症状大概率原因处理动作钉钉机器人没反应机器人未发布 / Stream离线检查发布状态重启服务飞书收不到事件权限不足 / 版本未发布重新发布应用版本公众号验证失败Token或EncodingAESKey不一致复制后台信息到配置并重启模型回复慢模型太大或接口超时换小模型或调大超时日志出现EOF长连接被断开重启服务检查网络稳定性多平台重复回复同一平台配了两个实例用幂等key去重重启后配置不生效没有重新创建容器down up -d最后再分享两个自己实际用的技巧第一先把钉钉或飞书跑通再去碰微信生态。钉钉和飞书的开发者后台对普通用户最友好Stream 模式不需要公网 IP十分钟就能验证整个链路是否正常。等你对 OpenClaw 的配置结构熟悉了再上企业微信和公众号难度会低很多。我第一次就跳过钉钉直接搞公众号结果被加密验证折腾到凌晨两点。第二日志一定要挂起来看。用docker compose logs -f --tail200 openclaw放一个窗口在旁边所有新消息进来、模型调用、平台回调都会实时滚动。尤其是平台改协议、密钥失效这类问题日志永远比你的直觉先发现问题。另外配置目录和memory.db记得做定时备份。我曾在一次系统重装之后把整个记忆库弄丢那种感觉比丢手机还难受。坐一次crontab每天凌晨打包到另一个磁盘成本几乎为零。OpenClaw 这东西用起来顺手之后你会越来越依赖它备份就是最后的保命符。