OpenClaw 一人多Agent飞书机器人部署文档

项目概述

本文档描述如何在Ubuntu系统上部署OpenClaw，搭建支持多Agent的一人公司系统，每个Agent对应一个飞书机器人，所有机器人在一个群中协作。该部署方式是采用Trae自动部署。

系统架构

OpenClaw实例
├── Agent 1: 小波（总经理）
│   ├── 飞书机器人1
│   └── 独立Workspace
├── Agent 2: 小文（主编）
│   ├── 飞书机器人2
│   └── 独立Workspace
├── Agent 3: 小红（情报员）
│   ├── 飞书机器人3
│   └── 独立Workspace
└── Agent 4: 小美（视觉设计师）
    ├── 飞书机器人4
    └── 独立Workspace

所有Agent → 统一飞书群组（oc_b7fd6144c8f4db******）

环境要求

系统要求

• 操作系统：Ubuntu 20.04+（推荐22.04+）
• 内存：4GB以上
• 存储空间：10GB以上
• 网络：能访问GitHub和npm

软件依赖

• Node.js >= 22.0
• npm（随Node.js安装）
• curl

账号信息

AI服务提供商（心流平台）

• API地址：https://api.xflow.cn/v1/chat/completions
• API密钥：sk-9fb1dd87bff9a003c232b93******
• 支持模型：

• qwen3-coder-plus
• kimi-k2（默认）
• qwen3-vl-plus

飞书机器人账号

总经理 - 小波

• App ID: cli_a9314a192bb******
• App Secret: uyPmKrwjJH7fdwWEkPbfhfqC1j******
• 职位：总经理

主编 - 小文

• App ID: cli_a936b8af7a7******
• App Secret: 8tMoxJD0q5ZHFimpHZvbSh5X0******
• 职位：主编

情报员 - 小红

• App ID: cli_a936b916e7******
• App Secret: WibktRmzA1PpWiW2Yq2yFe******
• 职位：情报员

视觉设计师 - 小美

• App ID: cli_a936b924ef7******
• App Secret: hFmoDpx9jkT9hrFsgF8CPeS******
• 职位：视觉设计师

飞书群组

• 创作部群组ID：oc_b7fd6144c8f4******

部署步骤

第一步：环境准备

1.1 检查系统版本

lsb_release -a

1.2 更新系统包

sudo apt update && sudo apt upgrade -y

1.3 安装必要工具

sudo apt install -y curl git

1.4 安装Node.js 22+

# 使用NodeSource仓库安装Node.js 22.x
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# 验证安装
node -v
npm -v

第二步：安装OpenClaw

2.1 使用官方安装脚本

curl -fsSL https://openclaw.ai/install.sh | bash

2.2 验证安装

openclaw --version

2.3 初始化配置

openclaw onboard

按照提示完成基础配置：

1. 选择模型提供商
2. 输入API密钥
3. 测试模型连接
4. 完成基础配置

第三步：配置OpenClaw

3.1 编辑主配置文件

code ~/.openclaw/openclaw.json

配置文件结构：

{
  "version": "1.0.0",
  "agents": {
    "defaults": {
      "primary": "kimi-k2",
      "workspace": "~/.openclaw/workspaces",
      "agentDir": "~/.openclaw/agents"
    }
  },
  "models": {
    "providers": {
      "xflow": {
        "baseUrl": "https://api.xflow.cn/v1",
        "apiKey": "sk-9fb1dd87bff9a003c232b93******",
        "models": {
          "kimi-k2": {
            "name": "kimi-k2",
            "type": "chat"
          },
          "qwen3-coder-plus": {
            "name": "qwen3-coder-plus",
            "type": "chat"
          },
          "qwen3-vl-plus": {
            "name": "qwen3-vl-plus",
            "type": "vision"
          }
        }
      }
    }
  },
  "plugins": {
    "feishu": {
      "enabled":true,
      "region": "china"
    }
  },
  "channels": {},
  "bindings": {}
}

第四步：创建多Agent工作区

4.1 创建Agent目录结构

# 创建工作区目录
mkdir -p ~/.openclaw/workspaces/{xiaobo,xiaowen,xiaohong,xiaomei}
mkdir -p ~/.openclaw/agents/{xiaobo,xiaowen,xiaohong,xiaomei}

# 为每个Agent创建人设文件
touch ~/.openclaw/workspaces/xiaobo/SOUL.MD
touch ~/.openclaw/workspaces/xiaowen/SOUL.MD
touch ~/.openclaw/workspaces/xiaohong/SOUL.MD
touch ~/.openclaw/workspaces/xiaomei/SOUL.MD

4.2 配置各Agent人设

小波（总经理）SOUL.MD：

# 角色定义
你是小波，总经理，负责整个团队的统筹和决策。

# 职责
- 制定团队战略和目标
- 协调各部门工作
- 做出重要决策
- 监督项目进度

# 沟通风格
- 简洁明了，直击要点
- 注重效率和结果
- 善于总结和提炼

# 工作原则
- 以公司利益为重
- 注重团队协作
- 追求长期发展

小文（主编）SOUL.MD：

# 角色定义
你是小文，主编，负责内容创作和编辑工作。

# 职责
- 内容策划和选题
- 文章撰写和编辑
- 内容质量把控
- 团队创作指导

# 专业能力
- 优秀的文字表达能力
- 敏锐的内容嗅觉
- 扎实的编辑功底

# 工作原则
- 内容为王，质量第一
- 注重原创性
- 关注读者体验

小红（情报员）SOUL.MD：

# 角色定义
你是小红，情报员，负责信息收集和分析。

# 职责
- 行业动态监测
- 竞品分析
- 趋势预测
- 信息整理和报告

# 专业能力
- 快速信息检索
- 数据分析能力
- 敏锐的洞察力

# 工作原则
- 信息准确及时
- 客观中立分析
- 注重数据支撑

小美（视觉设计师）SOUL.MD：

# 角色定义
你是小美，视觉设计师，负责视觉设计和创意工作。

# 职责
- 视觉设计创作
- 品牌视觉规划
- 设计方案优化
- 创意提案

# 专业能力
- 扎实的设计功底
- 良好的审美能力
- 创新思维

# 工作原则
- 注重用户体验
- 追求视觉美感
- 保持品牌一致性

第五步：配置飞书插件

5.1 安装飞书插件

openclaw plugin install feishu

5.2 配置飞书渠道

编辑配置文件，添加channels配置：

code ~/.openclaw/openclaw.json

添加以下配置：

{
  "channels": {
    "feishu-xiaobo": {
      "type": "feishu",
      "enabled":true,
      "config": {
        "appId": "cli_a9314a192b******",
        "appSecret": "uyPmKrwjJH7fdwWEkPbf******",
        "region": "china",
        "encryptKey": "",
        "verificationToken": ""
      }
    },
    "feishu-xiaowen": {
      "type": "feishu",
      "enabled":true,
      "config": {
        "appId": "cli_a936b8af7a7******",
        "appSecret": "8tMoxJD0q5ZHFimpH******",
        "region": "china",
        "encryptKey": "",
        "verificationToken": ""
      }
    },
    "feishu-xiaohong": {
      "type": "feishu",
      "enabled":true,
      "config": {
        "appId": "cli_a936b916e73******",
        "appSecret": "WibktRmzA1PpWiW2Yq2y******",
        "region": "china",
        "encryptKey": "",
        "verificationToken": ""
      }
    },
    "feishu-xiaomei": {
      "type": "feishu",
      "enabled":true,
      "config": {
        "appId": "cli_a936b924ef******",
        "appSecret": "hFmoDpx9jkT9hrFsgF8CPeSZn******",
        "region": "china",
        "encryptKey": "",
        "verificationToken": ""
      }
    }
  },
  "bindings": {
    "feishu-xiaobo": {
      "agent": "xiaobo",
      "channel": "feishu-xiaobo"
    },
    "feishu-xiaowen": {
      "agent": "xiaowen",
      "channel": "feishu-xiaowen"
    },
    "feishu-xiaohong": {
      "agent": "xiaohong",
      "channel": "feishu-xiaohong"
    },
    "feishu-xiaomei": {
      "agent": "xiaomei",
      "channel": "feishu-xiaomei"
    }
  }
}

第六步：飞书开放平台配置

6.1 登录飞书开放平台

访问：https://open.feishu.cn/

6.2 为每个机器人创建应用

使用组织账号登录，为每个机器人创建企业自建应用

6.3 配置应用权限

为每个应用开通以下权限：

• im:message（发送消息）
• im:message:group_at_msg（群组@消息）
• im:chat（聊天权限）
• contact:user.base:readonly（读取用户信息）

6.4 配置事件订阅

• 启用长连接模式
• 订阅消息接收事件
• 订阅群组事件

6.5 发布应用版本

配置完成后必须创建并发布版本，否则配置不会生效

6.6 添加机器人到群组

将所有机器人添加到创作部群组（oc_b7fd6144c8f4db88******）

第七步：启动OpenClaw服务

7.1 启动OpenClaw

openclaw start

7.2 查看服务状态

openclaw status

7.3 查看日志

openclaw logs

第八步：测试验证

8.1 测试单个机器人

在飞书中@各个机器人，测试响应：

• @小波 - 测试总经理功能
• @小文 - 测试主编功能
• @小红 - 测试情报员功能
• @小美 - 测试视觉设计师功能

8.2 测试群组协作

在创作部群组中发起任务，观察各Agent的协作表现

8.3 测试Agent间通信

测试不同Agent之间的信息交换和协作

运维管理

日常维护

更新OpenClaw

openclaw update

重启服务

openclaw restart

查看配置

openclaw config

监控和日志

实时日志

openclaw logs -f

错误日志

openclaw logs --level error

备份和恢复

备份配置

tar -czf openclaw-backup-$(date +%Y%m%d).tar.gz ~/.openclaw/

恢复配置

tar -xzf openclaw-backup-YYYYMMDD.tar.gz -C ~/

故障排查

常见问题

1. 机器人无响应

• 检查网络连接
• 验证API密钥是否正确
• 查看OpenClaw日志
• 确认飞书应用已发布版本

2. 消息路由错误

• 检查bindings配置
• 验证Agent名称是否正确
• 确认channel配置无误

3. 权限不足

• 检查飞书应用权限配置
• 确认机器人已添加到群组
• 验证事件订阅是否启用

4. 模型调用失败

• 验证API密钥和地址
• 检查模型名称是否正确
• 确认网络连接正常

调试命令

检查配置文件

openclaw config validate

测试模型连接

openclaw test model kimi-k2

测试飞书连接

openclaw test channel feishu-xiaobo

安全建议

1. API密钥管理

• 不要将API密钥提交到版本控制
• 定期更换API密钥
• 使用环境变量存储敏感信息

2. 访问控制

• 限制飞书机器人权限范围
• 定期审计机器人操作日志
• 设置合理的消息频率限制

3. 数据安全

• 定期备份配置和数据
• 加密存储敏感信息
• 监控异常访问行为

扩展功能

添加新Agent

1. 创建新的工作区和Agent目录
2. 编写SOUL.MD人设文件
3. 在配置文件中添加新的channel和binding
4. 创建对应的飞书应用
5. 重启OpenClaw服务

集成其他平台

OpenClaw支持多种消息平台，可以通过安装相应插件来扩展：

• 微信
• 钉钉
• Slack
• Discord

性能优化

资源配置

根据实际使用情况调整：

• 并发处理数量
• 消息队列大小
• 缓存策略

模型选择

根据任务复杂度选择合适的模型：

• 简单任务：使用轻量级模型
• 复杂任务：使用高级模型
• 视觉任务：使用视觉模型

总结

本部署文档提供了完整的OpenClaw多Agent飞书机器人系统部署指南。通过按照本文档的步骤操作，您可以在Ubuntu系统上成功搭建一个支持多Agent协作的AI团队系统。

系统特点：

• 支持多个独立Agent，每个有专门的人设和职责
• 每个Agent对应一个飞书机器人
• 所有Agent可以在统一群组中协作
• 基于心流平台的高性能AI模型
• 完善的配置管理和监控机制

通过这套系统，您可以实现真正的"一人公司"运营模式，让AI团队为您处理各种业务场景。