OpenClawClawdbot2026年萌新3分钟搭建喂饭级图文流程前阵子有朋友问我OpenClaw 到底怎么装他在群里看到 Clawdbot 的截图想给自己的团队也搞一个结果去 GitHub 一看全是命令行心态直接崩了。这很正常——这类工具本质上是从开源项目长出来的 AI 助手框架资料散、版本迭代快网上一搜不是英文 README 就是老教程萌新根本无处下手。这篇东西就是给你这种不想读源码、只想赶紧跑起来的人写的。我会把 OpenClaw也就是社区里常说的 Clawdbot从下载、配置、接入聊天软件到换模型、排故障的完整流程用最啰嗦、最直白的方式讲一遍。文章目标只有一个让你在一杯咖啡的时间内把属于自己的 AI 助手跑起来并且真的能用。我不会假设你有编程基础也不会让你去碰那些看不懂的编译参数。跟着每一步走哪怕中间报错按我给的排查思路去查大概率十分钟内能解决。1. 为什么萌新也该拥有一台随时在线的 AI 助手先花三分钟搞清楚一件事OpenClawClawdbot到底是个啥它能帮我干什么我凭什么要花时间去搭它。1.1 一个聊天入口 大模型 自动化的容器简单说OpenClaw 是一个开源的 AI 助手运行时框架。它做的事情就三件接大模型你可以配置不同的模型服务商比如千问通义千问、DeepSeek以及各种 OpenAI 兼容接口接聊天软件它能把机器人挂到飞书、Teams、钉钉、Telegram 之类的平台上让你用平时聊天的窗口跟 AI 对话跑自动化除了聊天它还能执行任务、定时提醒、处理消息、调用脚本本质上是一个可以长期在线的数字员工。你可以把它理解成一个自带轮子的 AI 管家安装包已经把模型连接、会话管理、消息收发、权限控制这些底层逻辑都封装好了你要做的只是填几个配置项告诉它用哪个模型、接哪个软件、叫什么名字。1.2 Clawdbot 和 OpenClaw 是同一个东西吗这个问题几乎每个新手都会问。答案是是也不是。官方仓库现在的名字是 OpenClaw但社区很多人还习惯叫它 Clawdbot因为早期项目名和机器人账号名都带 Clawd 这个词。所以你搜教程时看到这两个名字混用别慌说的是同一套东西。有些教程标题写Clawdbot 部署内容用的却是 OpenClaw 的配置文件这不冲突。1.3 典型的使用场景我实测下来比较有代表性的玩法有这么几类团队小助手挂在飞书或 Teams 群里帮大家查资料、写周报初稿、翻译通告、整理会议纪要个人日程管家每天早上定时推送天气和待办事项晚上提醒你该睡觉了运维告警转发服务器出问题时把告警消息推到 IM 群机器人根据告警内容给出初步处理建议内容加工流水线把 RSS 摘要、邮件通知、工单消息统一收口让 AI 先做一层过滤和总结只把重要的事推给你。这些场景的共同特点是不需要写代码只需要配置。所以哪怕你是零基础的萌新也完全能驾驭。1.4 为什么建议萌新先在自己电脑上装官方支持多种运行方式但我强烈建议第一步在本地电脑跑通而不是直接上云服务器或 NAS。原因很简单本地出问题你能直接看到控制台日志能快速定位等到跑熟了再迁到 NAS 或小主机上长期挂机也不迟。本地跑通了 3 分钟的事后面迁移也就是一条命令的功夫。2. 搭建前的准备别急着下载先把这几样东西备齐这一步很多人会跳过结果装到一半发现缺 API Key、缺平台账号卡在半路。提前把下面三样东西准备好后面全程不折腾。2.1 一个能调用的模型服务商账号OpenClaw 本身不带大模型它像是一个接线员需要你提供一个模型接口来干活。目前最省事的是开通千问的 OpenAI 兼容接口原因如下国内直连稳定网络问题少兼容模式做得很成熟OpenClaw 填个 base_url 就能直接用有免费额度萌新测试足够了。你需要拿到的东西有两样API Key一串密钥和Base URL接口地址。千问兼容模式的地址一般形如https://dashscope.aliyuncs.com/compatible-mode/v1不同模型服务商各有各的地址别填错。如果你已经买了 OpenAI 官方的 Key或者用的 DeepSeek、MiniMax 等也可以。OpenClaw 这层是通用设计只要你手上有API Key Base URL 模型名三件套就可以。至于是哪个厂商后面配置章节再细说。2.2 一台能长期开机的电脑或 NAS本地体验阶段你只需要一台能联网的电脑Windows、macOS、Linux 都行。建议配置别太寒酸至少 2 核 CPU、4GB 内存。AI 助手跑起来后模型调用主要是在云端完成的对本地资源消耗不算大但消息服务、会话管理这些进程还是要占一点内存的。如果你想长期挂着当团队机器人用而不是只在需要时开一下那我建议准备一台 NAS 或者迷你小主机。社区里用飞牛fnOS和群晖的人很多尤其是飞牛因为它自带 Docker 应用中心搜索 OpenClaw 就能图形化安装比较适合新人。后面我会单独讲这条路。2.3 一个聊天软件的机器人账号OpenClaw 装好之后你总得有个地方跟它说话。它支持通过渠道Channel接入各种 IM 平台飞书、Teams、钉钉、Telegram 等等。萌新阶段我建议你先挑一个平时用得最多的平台来测试。这里有个心态上的坎别想着一次性把所有平台全接上。先接一个跑通了再加第二个。消息平台接入涉及回调地址、权限开通等操作一次接太多容易搞混。后面我会把飞书和 Teams 的配置单独拆开讲你到时候对照着操作就行。2.4 各运行环境怎么选直接给结论运行环境适合人群安装难度推荐度Windows 图形安装包只在本地测试、第一次接触低高Linux / Docker有 NAS 或小主机想长期跑中高飞牛 NAS 应用中心有飞牛设备、想要简单省事低高macOS 本机开发调试为主中中一句话总结想在最短时间内看到效果选 Windows 图形安装包想以后当服务长期运行选 NAS 或 Linux Docker。3. 喂饭级安装流程三条路任选一条都能跑起来现在进入正题。我按平台拆成三个小节你只看自己对应的那条路就行不用全看。3.1 路线一Windows 图形化安装最适合萌新2026 年的 OpenClaw 已经提供了比较成熟的 Windows 安装器不像早年还得装 WSL、配环境变量。流程大概是这样到官方发布页找 Windows 版安装包一般是.exe下载后双击运行选择数据保存目录默认是C:\Users\你的用户名\.openclaw你如果想改到 D 盘也可以安装器会弹出配置向导这里填三样东西模型服务商的 API Key、Base URL、模型名称选择启用哪些渠道Channel这一步可以先只勾一个后面再加点击启动窗口下方会滚动日志看到类似OpenClaw is running的字样就说明服务起来了。这里有个细节安装向导里填的模型配置最终会写入数据目录下的配置文件或.env文件。所以哪怕你当时填错了也不用重装直接打开那个文件改就是了。我后面讲模型配置时会给出具体的字段名。Windows 安装器最大的优势是它把 Python 运行时、依赖库、进程管理全打包了你不需要知道背后发生了什么。缺点是你得保证这台电脑别随便休眠否则机器人就断线了。如果你只是测试这个缺点无所谓。3.2 路线二Linux / Docker 部署适合长期挂机如果你手头有一台 Linux 服务器或者 NAS走 Docker 是最干净的方案。官方提供了一键部署脚本但为了让你心里有数我建议手动跑一遍。先创建一个目录比如openclaw在里面放一个docker-compose.yml内容大致如下version: 3.8 services: openclaw: image: openclaw/openclaw:latest container_name: openclaw restart: unless-stopped ports: - 3000:3000 volumes: - ./data:/data environment: - OPENCLAW_BIND_ADDR0.0.0.0:3000然后在同一目录下新建.env文件填入模型和渠道配置。最后执行docker compose up -d看日志用docker logs -f openclawDocker 方案的好处是升级方便以后只要拉新镜像、重建容器就行。缺点是第一次接触容器的人可能会被数据目录、环境变量这些概念吓到。其实不用怕你只需要记住所有配置都在.env里所有数据都在./data目录下其他地方不用去动。3.3 路线三飞牛 NAS 图形化安装懒人福音飞牛fnOS的应用中心里可以直接搜到 OpenClaw。操作路径是打开 Docker 应用中心搜索OpenClaw点击安装然后填写端口号和数据路径确认即可。飞牛版的 OpenClaw 镜像一般会自动带上 Web 管理界面你安装完成后浏览器访问http://你的NAS地址:端口就能看到可视化的配置页面。填 API Key、选模型、开关渠道都可以在网页上点对新手非常友好。我认识的不少朋友就是用这种方式把 OpenClaw 装在飞牛上一跑就是几个月没管过。唯一要注意的是给容器分配的内存别低于 1GB不然多开几个会话可能会卡。3.4 怎么确认自己安装成功了不管走哪条路判断标准都一样服务进程在跑日志里没有报错如果你配了 Web 界面能正常打开你在聊天软件里给 Bot 发消息它能回复你。如果前两步通过、第三步失败大概率是渠道接入的问题不是安装的问题。那我们就进入下一章。4. 渠道接入实战让助手出现在飞书、Teams 和群里安装只是一层壳真正让 OpenClaw 好用的是渠道Channel接入。所谓 Channel就是 OpenClaw 和聊天软件之间的连接器。你得让机器人账号出现在飞书、Teams 或者 Telegram 里它才有地方施展拳脚。4.1 Agent 怎么选择 Channel先理解配置逻辑打开 OpenClaw 的数据目录你会看到一个配置文件可能是config.json或.env里面有一组channel相关的开关。比如channels: enabled: - teams - lark意思就是启用 Teams 和飞书这两个渠道。修改之后重启服务OpenClaw 会去尝试连接对应的机器人账号。启动日志里你会看到类似[channel:teams] connected的提示看到它才说明这个渠道真正上线了。所以Agent 怎么选择 Channel这个问题答案不是聊天界面里点一下而是配置文件里声明 重启生效。你在群里发/channel之类的指令多半只能查看状态改配置还是得去数据目录。4.2 接入 Microsoft Teams八步走Teams 接入整体不复杂但涉及 Azure 门户的不少点击操作。我按照 2026 年前后的界面习惯给你梳理一个流程细节上不同版本可能略有差异思路是通用的。登录 Azure 门户搜索并创建Bot 服务Azure Bot在创建页面选择多租户类型填写名称创建完成后进入配置页面找到Microsoft App ID也叫 App ID和客户端密码Client Secret记下来在 OpenClaw 的配置文件中启用 teams 渠道填入 App ID 和 Client Secret重启 OpenClaw此时服务会后台连接 Teams回到 Teams 客户端在应用管理里选择上传自定义应用或者直接通过 Bot 服务提供的测试连接链接打开聊天窗口给这个 Bot 发一条私聊消息比如你好收到回复后把 Bot 拉进一个测试群再在群里 它一下试试。这里最坑的一步是客户端密码。Azure 现在默认不允许直接查看明文密码创建时只展示一次忘了就得重新生成。建议创建 Bot 服务时就把秘密保存到一个临时文件里别等到配置 OpenClaw 时再翻。4.3 接入飞书自建应用 事件订阅飞书接入的核心是企业自建应用。流程大概是登录飞书开放平台创建企业自建应用给应用添加机器人能力开启事件订阅配置回调地址为 OpenClaw 的 Webhook 地址在权限管理里给应用开消息读写权限发布应用并在飞书 IM 里搜索到你的 Bot把应用凭证App ID / App Secret填到 OpenClaw 的 lark 渠道配置中重启 OpenClaw完成长连接订阅。我提醒一句如果你的 OpenClaw 跑在家里内网没有公网地址那就要用飞书的长连接模式WebSocket不要用 Webhook 回调模式。长连接模式不需要公网暴露端口内网环境也能工作。具体在开放平台后台选择使用长连接接收事件即可。4.4 接入多个渠道时的要点同时接 Teams 和飞书也没问题理论上一个实例能挂多个渠道。但建议初期只开一个等日志里看到connected之后再开下一个。多个渠道同时接如果出问题日志里会有一大堆报错新手很难分清是哪一块的锅。下表是几个平台的关键配置项对照渠道需要的账号信息是否需要公网地址常见坑Microsoft TeamsApp ID Client Secret不需要主动拉取密码忘了权限没开飞书App ID App Secret长连接模式不需要权限开太少回调地址填错TelegramBot Token不需要主动拉取Token 输错尾巴钉钉AppKey / AppSecret取决于模式权限点漏5. 模型与角色把默认助手换成千问并定制人设OpenClaw 装好后默认的模型配置可能指向某个预设接口国内用户用起来不一定顺手。这一章专门讲怎么把它切成千问以及怎么让机器人按你想要的方式说话。5.1 模型配置的底层逻辑OpenClaw 之所以能兼容这么多模型是因为它走的是 OpenAI 兼容协议。翻译成大白话就是只要某个模型服务商提供了长得像 OpenAI的接口OpenClaw 就能直接对接不用为每家写单独的适配代码。所以配置模型这件事本质上就是填三个环境变量LLM_API_KEY你的密钥LLM_BASE_URL服务商的接口地址LLM_MODEL模型名称比如qwen-plus、qwen-turbo。有些图形化安装工具把这三个字段改成了别的名字但你在配置文件里总能找到对应的映射关系。Windows 安装器的向导让你填 API Key、Base URL、Model分别就是上面三样。5.2 配置千问的具体操作千问通义千问的 OpenAI 兼容地址是https://dashscope.aliyuncs.com/compatible-mode/v1在 OpenClaw 的.env文件里按下面这种格式填LLM_API_KEYsk-你的千问APIKey LLM_BASE_URLhttps://dashscope.aliyuncs.com/compatible-mode/v1 LLM_MODELqwen-plus如果你想省钱也可以先用qwen-turbo速度更快、额度更便宜。等实际测下来发现回答质量不够再升级到qwen-plus或qwen-max。填完后重启服务在聊天软件里发一句话测试。如果机器人回复正常说明模型切换成功了。如果回复乱码、报错或直接不答检查三件事LLM_MODEL是否填了服务商提供的完整名称不要用缩写LLM_BASE_URL末尾有没有多余的斜杠API Key 前后有没有空格。这三类小问题占了模型配置失败原因的绝大多数。5.3 定制人设让机器人更像你的同事模型配好之后默认的聊天风格可能会偏通用助手你可以在 OpenClaw 里设置系统提示词System Prompt也就是给它定义角色。举个例子你想要一个冷酷的运维告警机器人可以这样写你是团队运维助手名字叫小爪。收到告警消息时先分析严重级别再给出处理建议。回答简洁不闲聊不超过三行。如果你想要温柔但靠谱的行政助理就写你是行政助理负责整理会议纪要、提醒日程、回答同事关于请假和报销的问题。语气亲和信息准确。不同的渠道建议用不同人设。比如团队群里用正式一点的设定私聊可以用更放松的风格。OpenClaw 的配置文件里会对不同渠道做一些 persona 上的区分具体字段名以你安装版本的自述文档为准。5.4 实测经验模型参数别乱调很多萌新一看配置文件里有temperature、max_tokens这些参数就想试试结果调完发现回复忽长忽短、格式稀碎。我的经验是初期全部保持默认等机器人用顺手了再微调。特别是max_tokens给太小会导致长回答被截断给太大又浪费额度还可能超限。如果你确实想调只动一个地方就够了system prompt。它是性价比最高的效果调节器。6. 踩坑实录session file locked 的完整排查链路写教程只写顺风局没意义我把新手最常撞的一个报错拆开讲透。这个报错信息长这样agent failed before reply: session file locked (timeout 60000ms)6.1 这个报错在说什么翻译一下OpenClaw 尝试读写某个会话文件但这个文件一直处于锁定状态等了 60 秒还没解锁于是放弃了。就像你在卫生间门口等里面的人出来结果里面的人可能是上一批留下来没走的你干等一分钟没等到。会话文件是 OpenClaw 用来记录每个对话历史的地方一般是数据目录下一个以.jsonl或.db结尾的文件。正常情况下同一时间只会有一个进程去读写它。出现 locked 报错几乎都是因为有多个进程在抢同一个文件。6.2 最常见的三种触发场景你双击了两次启动程序Windows 上直接开了两个 OpenClaw 实例上一次程序崩溃或强制关闭但后台进程没有完全退出你把同一个数据目录挂载给了两个容器比如同时跑了两份 Docker Compose。还有一种容易忽略的情况某些文件同步软件比如网盘同步目录正在锁定数据目录里的文件也会导致这个报错。如果你把 OpenClaw 的数据目录放在 OneDrive 或 iCloud 同步文件夹里建议迁出来。6.3 逐步排查流程按顺序做每一步都做完再看效果第一步确认到底有几个进程在跑。Windows 打开任务管理器搜索openclawLinux 或 NAS 执行ps aux | grep openclaw如果看到两行以上说明多实例确认了。全部杀掉只保留一个。第二步重启服务后过 10 秒再试。如果恢复说明就是多实例问题注意以后别重复启动。第三步如果还在报错需要手动清理会话锁文件。锁文件一般在数据目录下命名类似session.lock、chat.lock。先备份再删除cp /data/session.lock /data/session.lock.bak rm /data/session.lock然后重启服务。锁文件删除不会丢聊天记录它只是进程间互斥的标记文件真正的聊天数据在另一个文件里。第四步如果删完还是锁检查是不是数据目录权限有问题。在 Linux 下确保容器内用户对数据目录有读写权限chown -R 1000:1000 /data我排查过几十次这类问题九成都是第一步就找到了原因多开进程。剩下的一成才是锁文件残留或权限问题。你先别急按顺序来。6.4 飞书输出容易被截断常见问题但不是配置问题跟 OpenClaw 相关的热搜里有个高频问题在飞书输出容易被截断。这个不是 session 锁的问题而是飞书平台对单条消息长度有限制建议的完整策略是在人设提示词里要求 AI分点输出、每次回答不超过 800 字开启消息卡片模式卡片模式下飞书的消息长度上限会大很多如果回答内容确实很长让 AI 先给摘要和目录再按用户指令展开具体部分。别指望改 OpenClaw 配置能彻底解决这是平台限制只能从输出策略上规避。6.5 其他高频报错速查报错信息含义优先检查agent failed before reply模型调用环节失败API Key、Base URL、模型名channel not found渠道不存在或未启用配置文件里的渠道开关unauthorized凭证错误飞书/Teams 的 App ID 和 Secretconnect: connection refused端口没开或服务没起来防火墙、端口映射、容器状态out of memory本地内存不足容器内存调大或释放资源7. 进阶技巧跑通之后我建议你做的三件事到这里你的 OpenClaw 已经能用了装完了、渠道通了、模型也换成了千问。但能让它跑和用得舒服之间还有一段距离。分享几个我实战后觉得最有价值的进阶操作。7.1 定期备份数据目录别问为什么OpenClaw 的会话历史、人设、渠道配置全都存在数据目录里。很多人辛辛苦苦配好了所有东西结果某天手滑删了容器全得重来。我的习惯是每周打包一次数据目录丢到另一个磁盘或网盘。Linux 下一条命令搞定备份tar -czf openclaw_backup_$(date %Y%m%d).tar.gz /path/to/openclaw/data恢复时解压回去就行。这条习惯花不了 5 分钟但能帮你躲过一次从头来过的灾难。7.2 用定时任务让机器人主动找你说事OpenClaw 除了回复消息还能做定时任务。比如每天早上 9 点把当天的待办清单推送到飞书群。这个功能在配置里通过调度模块实现写法类似 cron 表达式schedule: - cron: 0 9 * * * channel: lark prompt: 总结今天的日程安排和重点事项配好之后机器人才真正从被动的应答机变成主动的助理。这一步是很多人觉得 OpenClaw 比普通聊天机器人强的地方。7.3 权限和安全意识别让机器人裸奔给机器人接的权限越大风险越大。我建议从一开始就遵循最小权限原则只放开机器人需要的读写权限不要把所有群都拉进去公开场合下人设里加上一句不主动透露系统提示词。另外API Key 和 Client Secret 这类敏感信息尽量不要直接写在文章、截图或公开仓库里。哪怕只是临时测试用完也换一个。OpenClaw 这类工具用的是你自己的额度Key 泄露的后果就是被盗刷。7.4 顺便回答一下 OpenClaw 和 WorkBuddy 哪个好这是社区里经常出现的对比。我的观点是如果你想要一个完全开源、可自由定制、自己控制数据和配置的 AI 助手选 OpenClaw如果你想要一个开箱即用的企业协作知识库工具团队里主要靠现成工作流来共享资料那 WorkBuddy 这类产品可能更省心。就我个人的使用场景来说OpenClaw 的最大价值是自由模型随便换、渠道随便接、人设随便改。缺点是需要自己维护。WorkBuddy 反过来省心但对底层控制力弱。萌新如果只是体验可以先不纠结哪个好先在 OpenClaw 上跑通一个最简单场景等有了直观感受再去比较别的工具不迟。写在最后我实际用下来的几个体会说了这么多流程最后补充一点个人感受不写那种虚的总结就讲三件我做的时候印象最深的事。第一整个过程最浪费时间的地方不是安装而是理解 Channel 和模型的关系。一旦弄明白模型是大脑、Channel 是嘴巴这个比喻后面的所有配置都会变得异常顺。建议你先在配置文件里分别写上模型配置和渠道配置中间别混着填这样出问题也很好定位。第二数据目录一定要固定下来别这次装在这、下次装在那。我在 Windows 上用默认目录在 Linux 上用/data挂载目录时间长了会发现备份、迁移全靠这个习惯撑着。第三日志是最有用的老师。遇到任何异常先去看日志最后 100 行通常第一行报错就指出了问题方向。不要急着去论坛发帖问先在本地把日志读一遍很多时候答案就在里面。最后再分享一个小技巧如果哪天机器人突然不答话先看看是不是 API 额度用完了。这个原因藏得很深但它比任何配置错误都常见。养成额度 → 日志 → 配置的排查顺序你就能少走很多弯路。