OpenClaw 配置实战：从一脸懵到配出 AI 团队 检查一下你的配置对不对

一份真正实用的配置指南，解决你实际遇到的问题

故事是这样的。

上周我在一个 AI 群里潜水，看到有个人发了条消息，说他配好了第一个 OpenClaw 智能体，想再加一个，结果对着配置文件发了半小时呆，完全不知道从哪下手。

我当时就笑了。不是笑他，是笑我自己。因为两个月前，我也是这样。

那时候我刚接触 OpenClaw，兴冲冲地配好了第一个智能体，能用了，挺开心。然后我就想，要不搞个团队吧，一个小绿负责写东西，一个小紫负责审查，再来个小蓝跑执行。结果打开那个 openclaw.json，我直接懵了。

这文件里密密麻麻的配置，哪个是管模型的，哪个是管智能体的，哪个是管权限的，完全分不清。我改一行，重启，报错。再改一行，再重启，又报错。搞了整整一个下午，最后小绿和小紫倒是能用了，但它们俩互相不认识，各干各的。

我就想，这不对啊，智能体团队不就该协同工作吗？

后来我才搞明白，OpenClaw 的配置其实没那么复杂，只是没人用大白话讲清楚。今天我就把踩过的坑都掏出来，让你十分钟配好自己的 AI 团队。

~/.openclaw/openclaw.json

改完记得重启 Gateway，不然不生效。

openclaw gateway restart

很多人以为要复制粘贴一大堆代码，其实就改两个地方。id 和 workspace。id 就是智能体的名字，不能重复。workspace 是工作目录，每个智能体要分开。就这么简单。

{
  "agents": {
    "defaults": {
      ...                                                                // 此处以省略
    },
    "list": [
      {
        "id": "xiaolv",                                                 // 🔴 智能体唯一 ID，不能重复！
        "name": "小绿",                                            
        "workspace": "/Users/cc/.openclaw/workspace-xiaolv",            // 🔴 独立工作空间
        "model": {
          "primary": "modelstudio/kimi-k2.5"                            
        }
      },
      {
        "id": "xiaozi",                                                 // 🔴 另一个智能体
        "name": "小紫",
        "workspace": "/Users/cc/.openclaw/workspace-xiaozi",            // 🔴 不同工作空间
        "model": {
          "primary": "modelstudio/qwen3.5-plus"
        }
      }
    ]
  }
}

我一开始傻乎乎地让两个智能体共用一个 workspace，结果它们互相覆盖文件，搞得一团糟。分开就没事了。

你肯定遇到过这种情况，给飞书机器人发消息，它在那转圈圈，转了半天，啪一下出来一大段文字。你就干等着，也不知道它在干嘛。

其实只需要加一行配置。

{
 "channels": {
    "feishu": {
      ...                                       // 🟢此处以省略
      "enableCardResponse": true,               // 🟢启用卡片式响应
      "showContextUsage": true,                 // 🟢显示上下文使用情况
      "threadSession": true
      "dmPolicy": "open",                       
      "groupPolicy": "open",                    
      "streaming": true,                        // 🔴 流式输出开关！逐字显示就靠它！
      "accounts": {
        "xiaolv": {                             // 🟢 飞书机器人配置
          "appId": "cli_xxx",                   // 🟢 应用ID
          "appSecret": "xxx",                   // 🟢 应用密钥
          "botName": "小绿",                  
          "enabled": true                       // 🟢 机器人开关
        }
      }
    }
  }
}

在飞书账号配置里加上这个，回复就会像 ChatGPT 一样逐字显示。你看着它一个字一个字往外蹦，至少知道它在干活，心里踏实。

我一开始以为模型配置里那个 supportsUsageInStreaming 是管流式输出的，结果不是。那个是显示 token 使用量的，和流不流式没关系。流式输出就只看 streaming 这一个参数。

这是我最开始最头疼的问题。小绿写完了东西，想让小紫帮忙看看，结果小紫说，我不认识这个人啊。

后来我发现要在 tools 里开权限。

{
  "tools": {
    "profile": "full",                         // 🔴 工具权限级别 （智能体能执行命令的关键）
    "sessions": {
      "visibility": "all"                      // 🔴 会话可见性 （多智能体互通关键）
    },
    "agentToAgent": {                          // 🔴 多智能体互通关键！
      "enabled": true,                         // 🔴 开启智能体间通信
      "allow": ["main", "xiaolv", "xiaozi"]    // 🔴 允许互通的智能体列表
    }
  }
}

这个 allow 列表里的智能体，就能互相发消息、调用彼此。小绿可以直接喊小紫，小紫也可以喊小蓝，像个真正的团队。

我一开始让机器人发图片，有时候成功有时候失败，完全找不到规律。后来才发现，图片必须放在特定的目录里。

~/.openclaw/media/

而且路径要写相对路径，MEDIA:./media/图片名.png。我写成了绝对路径，有时候能发有时候不能，搞得我很崩溃。改成相对路径就稳定了。

说了这么多，其实 OpenClaw 的配置就这几块。

模型配置管你用什么 AI，智能体配置管你有几个员工，工具权限管他们能干什么，飞书通道管怎么收发消息。每一块搞清楚，整个系统就跑起来了。

我现在的小团队，小绿写初稿，小紫审查，小蓝执行，我只需要在关键节点看一眼。效率比我自己单打独斗高多了。

如果你也在配 OpenClaw，希望这些坑你别再踩一遍。

在开始配置之前，先打开你的 ~/.openclaw/openclaw.json 文件，对照下面的清单逐项检查：

1. 1. 第一步：确认 agents.list 里有没有你的智能体 ID
2. 2. 第二步：检查每个智能体的 workspace 路径是否存在
3. 3. 第三步：确认 channels.feishu.accounts 里有对应的账号配置
4. 4. 第四步：检查 tools.agentToAgent.allow 是否包含了需要互通的智能体
5. 5. 第五步：确认 bindings 路由规则是否正确

下面是一份参考配置，红色标注的地方需要根据你的实际情况修改：

{
  "models": {
    "mode": "merge",
    "providers": {
      "qwen-portal": {
        ...                                                                // 此处以省略
        "models": [
          {
            ...                                                           // 此处以省略
            "contextWindow": 128000,                                      
            "maxTokens": 8192,                                             
            "compat": {
              "supportsUsageInStreaming": true                             // 🔴 让飞书显示 token 使用量，你的飞书不显示可能就是因为他没打开
            }
          }
        ]
      }
    }
  }，
  "agents": {
    "defaults": {
      ...                                                                  // 此处以省略
    },
    "list": [
      {
        "id": "xiaolv",                                                    // 🟢 一个智能体
        "name": "小绿",                                                    
        "workspace": "/Users/cc/.openclaw/workspace-xiaolv",            
        "model": {
          "primary": "modelstudio/kimi-k2.5"                              
        }
      },
      {
        "id": "xiaozi",                                                    // 🟢 另一个智能体
        "name": "小紫",
        "workspace": "/Users/cc/.openclaw/workspace-xiaozi",            
        "model": {
          "primary": "modelstudio/qwen3.5-plus"
        }
      }
    ]
  }，
  "channels": {
    "feishu": {
      ...                                       // 此处以省略
      "enableCardResponse": true,               // 🔴 启用卡片式响应
      "showContextUsage": true,                 // 🔴 显示上下文使用情况
      "footer": {                               // 🔴 飞书底部显示详细信息
        "elapsed": true,                        
        "status": true,                         // 🟢 显示状态信息（如成功/失败）
        "tokens": true,                         // 🟢 显示Token 使用量（输入+输出 token 数）
        "cache": true,                          // 🟢 显示缓存命中情况（是否使用了缓存）
        "context": true,                        // 🟢 显示上下文消息数（当前对话轮数）
        "model":true                            // 🟢 显示使用的模型（如 kimi-k2.5）
      },
      "threadSession": true
      "dmPolicy": "open",                       
      "groupPolicy": "open",                    
      "streaming": true,                        // 🔴 流式输出开关！逐字显示就靠它！
      "accounts": {
        "xiaolv": {                             // 🟢 飞书机器人配置
          "appId": "cli_xxx",                   // 🟢 应用ID
          "appSecret": "xxx",                   // 🟢 应用密钥
          "botName": "小绿",                  
          "enabled": true                       // 🟢 机器人开关
        }
      }
    }
  }，
  "bindings": [                                //🔴 路由绑定：消息怎么分配给不同智能体
    {
      "type": "route",                 
      "agentId": "main",               // 🟢 在openclaw。json中的路径： agents.list.id
      "match": {
        "channel": "feishu",           // 🟢 通道名称   
        "accountId": "main"            // 🟢 在openclaw。json中的路径： channels.feishu.accounts.main    
      }
    },
    {
      "type": "route",                 
      "agentId": "xiaolv",                   
      "match": {
        "channel": "feishu",
        "accountId": "xiaolv"
      }
    },
  ]，
  "tools": {
    "profile": "full",                         // 🔴 工具权限级别 （智能体能执行命令的关键）
    "sessions": {
      "visibility": "all"                      // 🔴 会话可见性 （多智能体互通关键）
    },
    "agentToAgent": {                          // 🔴 多智能体互通关键！
      "enabled": true,                         // 🔴 开启智能体间通信
      "allow": ["main", "xiaolv", "xiaozi"]    // 🔴 允许互通的智能体列表
    }
  }
}

🔴 appId 和 appSecret

• • 位置： channels.feishu.accounts.你的账号
• • 获取方式： 飞书开发者后台 → 你的应用 → 凭证信息

🔴 gateway.auth.token

• • 位置： gateway.auth.token
• • 建议： 用随机生成的强密码，至少 16 位

🔴 workspace 路径

• • 位置： agents.list[].workspace
• • 检查： 确保路径存在，每个智能体独立目录

🟠 可选调整项

• • agents.list[].id 和 name：改成你想要的智能体名称
• • gateway.port：如果 18789 被占用，换个端口
• • models.providers：根据你使用的模型服务商调整

修改完成后，执行 openclaw gateway restart 重启服务。如果有报错，检查 JSON 格式是否正确（逗号、括号是否匹配）。

本文基于真实踩坑经历撰写