夜雨聆风我用 OpenClaw 开发海外销售智能体，踩过的 10 个坑——不是技术难题，而是别把系统搞乱的实战复盘。文末有 5 条避坑铁律，建议收藏！
这段时间，我一直在用 OpenClaw / 龙虾，折腾我的"海外销售智能体"。
一开始我以为，开发智能体最难的地方，应该是模型怎么选、Prompt 怎么写、Skill 怎么设计、工具怎么接、飞书怎么打通。
但真的一路做下来，我发现一个更扎心的现实：开发智能体，最难的往往不是"不会做"，而是"做乱了"。
很多时候，系统不是死在能力不够，而是死在边界没锁、阶段没分、配置乱改、会话混乱、环境变量没接好、Bot 看起来通了其实没真的跑对。
这篇文章，我不想讲太多概念，也不想装专家。我就想把我在开发"智能线索引擎 ILE"过程中，真实踩过的一些坑写出来，给正在折腾龙虾 / OpenClaw 的朋友提个醒。
尤其是小白用户，我真心想说一句：你不是技术差，你只是还没踩够坑。
坑一：没先锁边界，就开始改功能
这是我觉得最容易踩、也最致命的坑。
很多人一开始做智能体，脑子里只有一个念头：赶紧把它做出来。于是就会出现一种很典型的混乱局面：一边修 Skill，一边改 Gateway，一边动飞书配置，一边搞新的 Bot，一边还想顺手优化 Prompt。
最后的结果往往是：本来能跑的东西，被自己一点点搞挂。
我们后来慢慢摸出来一个规律：每一轮开发前，必须先锁死四件事——本轮目标是什么、本轮允许改什么、本轮绝对不能碰什么、完成后要输出什么。
机器人不像人。你没说清楚，它就容易自己往下推；你没设边界，它就可能帮你"好心办坏事"。
很多人不是不会开发智能体，而是没有先学会"给智能体上缰绳"。
坑二：设计阶段和执行阶段混在一起
以前我跟机器人说一句"开始做吧"，它就会一路往下推：设计、改配置、写文件、执行、测试、总结，全都一口气干了。
问题是，这种方式对小白来说极度危险，因为你根本不知道它这次到底做了什么、改了什么、有没有越权、有没有顺手动到你不该动的地方。
后来我强行要求每一轮都必须先做一个东西：执行前回显。就是它先告诉我：这轮准备做什么、本轮只会碰哪些文件、本轮不碰哪些地方、做完后会回什么结果。
这一步看起来"慢"，但实际上是最省时间的。因为开发智能体最怕的不是慢，最怕的是失控。一旦失控，你后面花的时间不是在开发，而是在排雷。
坑三：机器、路径、环境搞混，排查一小时，结论全错
这个坑我们自己踩得特别典型。
有一次我以为自己在排查本地部署的 OpenClaw 问题，结果后来发现——我命令是跑在另一台根本没装 OpenClaw 的 Mac 上。
当时我一顿检查：~/.openclaw 不存在、openclaw 命令找不到、Gateway 状态也不对，差点得出一个很严重的结论："完了，目录丢了，环境没了。"
后来才发现，不是环境丢了，是我自己跑错机器了。
这个坑特别适合提醒所有小白：在你开始排查之前，先确认三件事——你是不是在那台真正部署 OpenClaw 的电脑上、你是不是在正确的用户下、你看的路径是不是那套真实运行路径。
很多排查问题，不是技术问题，而是你查错地方了。
坑四：Gateway 是最容易被误伤的底层
如果你在做龙虾 / OpenClaw，一定要记住一句话：只要 Bot 不回，先别急着怀疑 Prompt，先看 Gateway 活没活。
我们这一路里，小铁、小铜有几次"不回复"，表面看起来像是 Skill 坏了、Bot 没接通、飞书配置错了，但后面真正查下来，很多次根因都在 Gateway：LaunchAgent 没 loaded、RPC probe failed、18789 没监听、Gateway 没有正确重载、Service unit not found。
也就是说，你以为是"上层能力问题"，实际是"底盘熄火了"。
这类坑对小白特别有杀伤力，因为它会制造一种错觉：你会一直在上层修逻辑，但底层其实根本没起来。
坑五：飞书独立 Bot，不是建好就能用
很多人会以为：Bot 建好了，App ID / Secret 拿到了，飞书后台配置了，发布了，那就应该能用了吧？
不，远远没完。
我们后面踩过一整串相关问题：长连接模式和 webhook 模式理解混了、飞书后台事件配置完了但本地没真正接住、Bot 能收消息了却提示 access not configured、还得手动做 pairing approve、消息看起来进来了但没真正进到对应 agent。
所以我后来有个非常朴素的判断标准：能在窗口里看到 Bot，不等于 Bot 真正可用。
真正的可用，至少要同时满足：能收到消息、能正确路由、能调用技能、能返回结果、返回的是对的那个 Bot，不是串角色。
坑六：新 Bot 明明接通了，消息却跑到了旧 Bot 那里
我们后来给"小铜"做了独立 Bot。理论上，它应该在自己的窗口里处理自己的消息。
结果日志里出现了一个很诡异的现象：消息是从 lead-assistant 收到的，但最后却被 dispatch 到了 agent:main。
意思是：小铜收到了消息，但真正处理消息的人，还是小铁。
为什么会这样？后来查下来，根因不是接入没通，而是同一个飞书用户，之前已经和 main agent 建过旧会话。OpenClaw 的 session 机制，把这个用户默认继续绑定到了旧 agent。
于是你以为自己在跟小铜说话，实际上系统还在拿小铁处理。
这件事给我一个很大的启发：独立 Bot 不只是独立窗口，独立会话、独立路由、独立处理器也必须独立。否则表面是两个 Bot，底层还是一团线缠在一起。
坑七：窗口独立了，身份还是串的
小铜联通之后，我们又踩了一个很有意思的坑。
它已经能回复了，但回复里却写："小铁在线，随时待命。"
也就是说：窗口是小铜的，消息也通了，但人格提示词、默认回复、身份文案没有彻底切干净。
这个坑看起来小，但本质上很重要。因为它说明了一件事："接入独立"和"角色独立"不是一回事。
很多小白做 Bot，容易只盯着"功能能不能跑"。但如果你真的想做产品，人格、话术、欢迎语、身份边界这些东西，都会直接影响用户感受。
坑八：本地 shell 里能用，不等于机器人运行时也能用
这是 ILE 这次开发里一个特别有代表性的坑。
我们在做 Germany industrial robotics dealer 测试时，发现：Google 能跑、Merger 能跑，但 Apify 就是不工作。
一开始很容易怀疑：是不是代码没写好？是不是小铜不会调？是不是 Adapter 有 bug？
后来越查越深，最后发现根因竟然是：APIFY_API_TOKEN 没有被正确注入 Skill 的运行环境。
注意，这里最容易误导人的地方在于：我本地 ~/.zshrc 里明明有 Token，但 OpenClaw 执行 Skill 时，不会自动继承你本地 shell 里的所有环境变量。
同时，ILE 的 skill.json 里又没有声明 APIFY_API_TOKEN。结果就是：表面上，Skill 会调；实际上，真实环境不完整。
这个坑我特别想提醒小白一句："我本地能用"和"机器人能用"是两回事。
坑九：别把"验证场景"误当成"产品边界"
现在 ILE 先验证过的场景，主要是 Germany + industrial robotics + dealer，以及 Japan + nursing care equipment + partner。
但我们真正想做的，不是"工业机器人专用引擎"，也不是"护理设备专用引擎"。
我们真正想做的是：一个跨行业可用的海外代理 / 分销客户发现引擎。
所以这里最容易产生的认知偏差是：你会误以为"我们现在主要在测工业机器人、护理设备，是不是这个技能就只能做这些行业？"
不是。这些行业只是当前更适合做验证，因为它们客户画像更清晰，渠道逻辑更明确，结果也更容易判断。
真正该追求的，是把技能做成：通用引擎 + 行业模板。底层引擎是通用的，不同行业只是换参数、换模板、换关键词，而不是每换一个行业，就重写一个新技能。
坑十：一次让机器人干太多事，它很容易崩
这个坑，真的很实际。
很多时候，我也会急，想着既然它能干，那就一口气让它：设计、写文件、改配置、联通 Bot、测试、总结、再顺手写 SOP。
结果就是：输出过长被截断、状态混乱、机器人崩掉，自己也看不清它这轮到底干了什么。
所以后来我们强行形成一个规则：一轮只做一件事。
比如这轮只做执行前回显，或者只改一个文件，或者只做联通测试，或者只做今日收口。
这个方法一点都不性感，但它非常有效。开发智能体不是比谁一口气干得多，而是比谁更稳。
最后，我给龙虾 / OpenClaw 小白的 5 条铁律
第一条：先锁边界，再开工。每一轮都先说清楚：这轮干什么、能碰什么、不能碰什么。
第二条：先保底层，再修上层。Bot 不回，先查 Gateway，再查长连接，再查 Skill。
第三条：接通不等于可用。能看到 Bot、能发消息，��等于它真的能正确处理任务。
第四条：本地能用，不等于运行时能用。环境变量、Token、依赖、权限，都要看机器人实际运行环境。
第五条：一轮只做一件事。不要贪快，不要贪多。小步快跑，比大步翻车强得多。
真正拉开差距的，不是谁更会写 Prompt
如果你现在刚开始做智能体，看到这里可能会觉得：这也太复杂了吧。
我想说，复杂是正常的，但别被吓退。因为智能体开发最难的阶段，不是"你什么都不会"的时候，而是"你会了一点点，开始到处乱动"的时候。
真正拉开差距的，不是谁更会写 Prompt，而是谁更有耐心把系统一步一步搭稳。
我现在越来越觉得，开发智能体这件事，本质上不是拼聪明，而是拼：边界感、纪律性、复盘能力。
你只要别总想着一步到位，别总想着一口气搞定所有事，很多坑其实都可以绕开。
📌 如果你也在做：
• 销售智能体 / 海外销售自动化• OpenClaw 智能体开发• 飞书 Bot / 多 Bot 协同
👇 关注公众号「波哥海外销售智能体」，获取更多实战干货 👇
想深度交流？添加波哥个人微信，备注"行业+需求"一起探讨 OpenClaw 开发、海外销售自动化实战
💬 扫码添加微信，加入智能体开发者交流群
关于波哥
廖光波，赢江出海创始人，曾任普渡与擎朗海外业务负责人。
长期聚焦中国企业出海、海外渠道销售与国际业务增长，拥有多个国家一线业务实战经验。
目前正在亲手搭建"海外销售与营销智能体"系统，持续分享真实案例、踩坑复盘与AI落地心得。
欢迎关注公众号「波哥海外销售智能体」，一起看这套系统怎么一步步从想法变成能用的数字员工。
— 全文完 —
