帮人搭建 OpenClaw多Agent，7小时踩了9个坑

靖扬

发布于 2026-04-21 15:57:12

2320

前段时间的一个晚上，微信弹窗，朋友发来一条消息。

“靖扬，你能自己配置OpenClaw吗？我想弄5个独立的机器人，让它们协同工作。”

我当时就想，这有啥难的，不就是改个配置文件吗？

结果花了7个小时，踩了9个坑。

先说结论：如果你正在使用OpenClaw，或者打算用，这篇文章能帮你省下至少7个小时的排错时间。

不吹不黑，纯记录。

坑 1：API Key 直接发出来，裸奔了。

离谱程度：⭐⭐⭐⭐⭐

在修改之前，我让朋友把他的 openclaw.json 发给我，把API Key这类信息先进行脱敏，改成abc。但他发给我的openclaw.json里，不仅API Key明文给我了，appid 和 appserect 都在里面。

包括给我的参考openclaw.json，里面也有别人的appid 、appserect 。

发给我倒是无所谓，但如果是别人拿到这份配置，就跟把家门钥匙扔小区业主群里，还说“谁要用谁拿去”没区别。

提醒大家，敏感凭证绝对不要在非加密渠道明文传输。必须发的话，至少打个码，只发部分确认。如果已经发了，立刻去后台重新生成 Secret 轮换掉。

坑 2：A2A插件投毒

离谱程度：⭐⭐⭐⭐⭐

这个坑更隐蔽，也更危险。

因为朋友想要本地的OpenClaw可以控制远程的OpenClaw，这种叫做A2A，全称Agent To Agent。OpenClaw官方还不支持，只有插件支持。

就在我去调研的时候发现，A2A插件在官方网站里标记为有风险插件，有潜在风险。

OpenClaw是在急速发展的新东西，很多东西还没有完善的审查机制。

大家可以装一个Skill Vetter，这个可以对SKill进行审查。地址：https://clawhub.ai/spclaudehome/skill-vetter。

另外建议大家只装大厂或者可信来源的插件，不要装不明渠道的插件。

坑 3：AI生成的配置，信不得

离谱程度：⭐⭐⭐⭐⭐

在我一番劝解下，朋友放弃安装A2A插件，于是我就开开心心的去帮他改配置了，想着把关键地方的配置一改就完事了。

结果没想到发过去的配置不能用。

啊这，不可能，我改的语法没错，来回审查过的。

于是我让他运行了一下openclaw gateway staus查看究竟是什么问题。

报错是“descption”字段不存在，但我压根没写过这个配置。

仔细一看，发现是发给我的原始openclaw.json就有问题，问了朋友，他寻思了一下，说这个配置文件是他让AI写的。

怎么说呢，写得挺像那么回事的，语法也对，结构也对，但配置字段名是错的。

不要让AI 给你写OpenClaw的配置文件，OpenClaw还太新了，AI在这方面幻觉比较严重，会出现把一个该放在全局的配置放在了局部这种问题。

一旦配置错了，就直接使用不了。

提醒大家坚决不要让 AI 直接生成/修改关键配置文件。而且每次 AI 建议的改动，都必须和官方文档的 Schema 进行核对。

坑 4：配置没有备份

离谱程度：⭐⭐⭐

那既然这份配置是错的，肯定是要基于一个正确的配置来改才行。

于是我就问我朋友，上一份能正确运行的配置你有不。

但真的会谢，他没有留下备份。

于是现在想改回去都不知道原来的值是多少。

我只能盲改，一遍一遍跟朋友确认他装了哪些插件，哪些配置是要留下来的，哪些配置是要删除的。

重新给他做了一份新的配置文件出来。

在修改前，先 cp 备份或者用 mv 把原配置重命名，永远保留一份“确定能跑”的配置。

坑 5：OpenClaw的配置，每个层级和位置都很重要

离谱程度：⭐⭐⭐

为了培养朋友的保密意识，没有像朋友要那5个Agent的配置，而是每次把配置文件发过去，让他自己填配置。

在我把修正后的配置文件发过去后，他把appid和appserect填写了进去。

然后OpenClaw还是没跑起来。

认真排查了一下发现，朋友填错位置了，把value填在key的位置了。

JSON 有严格的语法要求，每个配置的 key 不能出错，否则可能导致配置没法正常生效。

这个也不算坑吧，算是一个技术细节。

建议采用带语法校验的编辑器（比如 VSCode），基于官方标准的 JSON 格式去比对检查，不要自己发挥创造新的嵌套结构。

坑 6：模型能不能用，除了名字还得看权限

离谱程度：⭐⭐

到此为止，朋友的4个Agent都能跑起来了，但有一个模型怎么改都死活不回消息。

我用指令看了一下状态才破案，噢，没开这个模型的权限，模型提供商不让你用。

有时候排查方向全错，以为是自己的配置问题，其实是这个帐号被平台限制了，某些模型不让用。

大家遇到 403 之类的报错，去控制台看日志是不是被限制了无法调用，同时确认API Key余额和模型调用权限。

坑 7：重启拯救一切

离谱程度：⭐

在上述的几次调整里，由于OpenClaw是热加载机制，所以每次修改配置后，不需要重启就会生效。

以至于当我们修改了配置文件却没有生效的时候，还以为是配置文件没改成功，或者最新的配置文件是错误的。

来来回回检查几轮之后发现，配置文件没错，配置也没错。

那就只剩配置没生效这个可能了，于是让朋友重启一下试试。

重启之后果然就生效了。

别太相信OpenClaw的热加载，有时候openclaw gateway restart一下。

同时重启前别忘了openclaw gateway status查看一下配置状态，错误的配置文件下重启，会导致你直接没法用，注意备份和回滚哦。

坑 8：备份别只看配置文件

离谱程度：⭐

朋友担心万一哪天本地电脑坏了，所有的东西都没了。

OpenClaw的配置本质上是深耦合在本地环境里的，只是迁移一份JSON，是完成不了系统迁移的。

工具生态还不够成熟，很多同步机制还需要人肉补齐。

可以采用百度网盘/icloud这类云端工具，对.openclaw核心目录进行备份，而不是只存个JSON。

坑 9：升级版本之后全挂了回退不了

离谱程度：⭐⭐⭐⭐⭐

本来事情到上面就结束了，结果第二天朋友打开电脑，发现本地UI提示更新版本，顺手点了一下更新。

然后本地UI没反应了，5个机器人也都挂了。

这也不能怪他，这个坑我甚至踩过2次，每次因为各种原因不得不更新版本，结果更新后出问题的概率是100%。

这是因为OpenClaw版本迭代极快，且带有自动修复机制。一旦升级就会修改底层的配置文件，老版本就没法兼容了。

你想回退？抱歉，回不去了。

甚至每次你回退修改成了正确的版本，OpenClaw的热修复还会再帮你改回来，像是在跟一个看不见的人在拔河，直到你把它彻底杀死，并且把环境彻底搞干净。

如果没有时间处理故障时，绝对不要点升级。就算真的要升级，升级前，必须要备份当前的运行环境，整个.openclaw目录。

坑踩到这里就结束了，后来我想了想，这7个小时、9个大坑的洗礼，其实并不是无意义的内耗，本质上是新技术普及的必然代价。

就像AI 工作流专家 Dan Shipper说的：

“基础设施的‘日常照护’，是AI落地的隐形代价。没有完美的自动驾驶。人必须承担起‘智能体经理’的职责”。

为了让AI提效90倍，就必须忍受那7小时的脏活累活。这并不是浪费时间，而是在建立新时代的护城河。

而唯有一次次在回退、备份、排错和抗争中所展现出来的人的判断力、安全警觉和对复杂系统的掌控力，才是AI永远无法抢走的内核。

附：OpenClaw 多Agent官方推荐配置方案参考（敏感信息已打码，请自行替换配置）

【前置科普：关于JSON】: openclaw.json是一种JSON结构的数据，JSON是一种极其严谨的数据格式，容不得半点沙子，少一个逗号、多一个括号、键名（Key）拼错一个字母，整个文件就会直接失效。因此每个配置就必须基于官方配置，千万别自己发明结构。插件版本建议：3.10以上（飞书官方插件）。

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "alibaba-cloud/qwen3.5-plus"
      },
      "imageModel": {
        "primary": "volcengine/seedream-5-0"
      },
      "models": {
        "alibaba-cloud/qwen3-max-2026-01-23": {}
      },
      "workspace": "/home/admin/.openclaw/workspace",
      "compaction": {
        "mode": "safeguard"
      },
      "maxConcurrent": 4,
      "subagents": {
     
        "maxSpawnDepth": 2,
        "maxChildrenPerAgent": 5,
        "runTimeoutSeconds": 900
      }
    },
    "list": [
      {
        "id": "xiaoguan",
        "name": "小管",
        "default": true,
        "workspace": "~/.openclaw/workspace-xiaoguan",
        "model": {
          "primary": "alibaba-cloud/qwen3.5-plus"
        }
      },
      {
        "id": "xiaoling",
        "name": "小灵",
        "workspace": "~/.openclaw/workspace-xiaoling",
        "model": {
          "primary": "google/gemini-3.1-pro-preview"
        }
      },
      {
        "id": "xiaochan",
        "name": "小产",
        "workspace": "~/.openclaw/workspace-xiaochan",
        "model": {
          "primary": "google/gemini-3.1-pro-preview"
        }
      },
      {
        "id": "xiaopin",
        "name": "小频",
        "workspace": "~/.openclaw/workspace-xiaopin",
        "model": {
          "primary": "google/gemini-3.1-pro-preview"
        }
      },
      {
        "id": "xiaowen",
        "name": "小文",
        "workspace": "~/.openclaw/workspace-xiaowen",
        "model": {
          "primary": "google/gemini-3.1-pro-preview"
        }
      }
    ]
  },
  "session": {
    "dmScope": "per-peer"
  },
  "tools": {
    "web": {
      "search": {
        "enabled": true,
        "provider": "brave"
      }
    },
    "agentToAgent": {
      "enabled": true,
      "allow": ["xiaowen", "xiaopin", "xiaoling", "xiaochan"]
    },
    "sessions": {
      "visibility": "all"
    }
  },
  "messages": {
    "ackReactionScope": "group-mentions"
  },
  "channels": {
    "feishu": {
      "enabled": true,
      "threadSession": true,
      "replyMode": "auto",
      "appId": "[已脱敏]",
      "appSecret": "[已脱敏]",
      "domain": "feishu",
      "accounts": {
        "default": "xiaoguan",
        "xiaoling": {
          "appId": "[已脱敏]",
          "appSecret": "[已脱敏]",
          "domain": "feishu",
          "enabled": true,
          "model": "google/gemini-3.1-pro-preview",
          "botName": "小灵",
          "p2p": {
            "enable": true,
            "allowedUsers": ["all"]
          },
          "group": {
            "enable": true,
            "atOnly": true,
            "allowedGroups": ["all"]
          },
          "connectionMode": "websocket",
          "allowFrom": ["*"]
        },
        "xiaowen": {
          "appId": "[已脱敏]",
          "appSecret": "[已脱敏]",
          "domain": "feishu",
          "enabled": true,
          "model": "google/gemini-3.1-pro-preview",
          "botName": "小文",
          "p2p": {
            "enable": true,
            "allowedUsers": ["all"]
          },
          "group": {
            "enable": true,
            "atOnly": true,
            "allowedGroups": ["all"]
          },
          "connectionMode": "websocket",
          "allowFrom": ["*"]
        },
        "xiaochan": {
          "appId": "[已脱敏]",
          "appSecret": "[已脱敏]",
          "domain": "feishu",
          "enabled": true,
          "model": "alibaba-cloud/qwen3.5-plus",
          "botName": "小产",
          "p2p": {
            "enable": true,
            "allowedUsers": ["all"]
          },
          "group": {
            "enable": true,
            "atOnly": true,
            "allowedGroups": ["all"]
          },
          "connectionMode": "websocket",
          "allowFrom": ["*"]
        },
        "xiaopin": {
          "appId": "[已脱敏]",
          "appSecret": "[已脱敏]",
          "domain": "feishu",
          "enabled": true,
          "model": "google/gemini-3.1-pro-preview",
          "botName": "小频",
          "p2p": {
            "enable": true,
            "allowedUsers": ["all"]
          },
          "group": {
            "enable": true,
            "atOnly": true,
            "allowedGroups": ["all"]
          },
          "connectionMode": "websocket",
          "allowFrom": ["*"]
        },
        "xiaoguan": {
          "appId": "[已脱敏]",
          "appSecret": "[已脱敏]",
          "domain": "feishu",
          "enabled": true,
          "model": "alibaba-cloud/qwen3.5-plus",
          "botName": "小管",
          "p2p": {
            "enable": true,
            "allowedUsers": ["all"]
          },
          "group": {
            "enable": true,
            "atOnly": true,
            "allowedGroups": ["all"]
          },
          "connectionMode": "websocket",
          "allowFrom": ["*"]
        }
      },
      "dmPolicy": "allowlist",
      "allowFrom": [
        "*"
      ],
      "groupPolicy": "allowlist",
      "groupAllowFrom": [
        "*"
      ]
    }
  },
  "bindings": [
    {
      "agentId": "xiaoguan",
      "match": {
        "channel": "feishu",
        "accountId": "xiaoguan"
      }
    },
    {
      "agentId": "xiaoling",
      "match": {
        "channel": "feishu",
        "accountId": "xiaoling"
      }
    },
    {
      "agentId": "xiaochan",
      "match": {
        "channel": "feishu",
        "accountId": "xiaochan"
      }
    },
    {
      "agentId": "xiaopin",
      "match": {
        "channel": "feishu",
        "accountId": "xiaopin"
      }
    },
    {
      "agentId": "xiaowen",
      "match": {
        "channel": "feishu",
        "accountId": "xiaowen"
      }
    },
    {
      "agentId": "xiaoguan",
      "match": {
        "channel": "feishu",
        "accountId": "default"
      }
    }
  ]
}

常用命令：

openclaw doctor          # 检查配置问题
openclaw doctor --fix    # 自动修复
openclaw logs --follow   # 查看日志
openclaw gateway restart # 重启（拯救一切）

谢谢你的时间，我们下次再见。

本文参与腾讯云自媒体同步曝光计划，分享自微信公众号。

原始发表：2026-04-12，如有侵权请联系 cloudcommunity@tencent.com 删除

agent

本文分享自靖扬微信公众号，前往查看

如有侵权，请联系 cloudcommunity@tencent.com 删除。

本文参与腾讯云自媒体同步曝光计划，欢迎热爱写作的你一起参与！

登录后参与评论

0 条评论

热度

帮人搭建 OpenClaw多Agent，7小时踩了9个坑

帮人搭建 OpenClaw多Agent，7小时踩了9个坑

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐