夜雨聆风一、项目目标
本次部署旨在搭建一套完整的AI自动化协作体系，实现全流程数字化、智能化运转，具体目标如下：
目标：构建单OpenClaw+单飞书多机器人+多Agent配置，以逐步实现AI军团（实战推荐）
二、环境与平台准备
2.1 运行环境
本次部署基于纯净Ubuntu 24.04 LTS系统，环境信息如下：
Distributor ID: Ubuntu
Description: Ubuntu 24.04 LTS
Release: 24.04
Codename: noble
系统建议配置：CPU≥2核，内存≥4GB，硬盘≥20GB，保证网络通畅，具备sudo管理员权限。
2.2 运行其他环境要求
云主机：火山引擎云主机（ECS）(操作系统：Ubuntu 24.04 LTS)
即时通信工具：飞书
大模型：豆包
OpenClaw：OpenClaw 2026.3.13
2.3 常用平台地址
OpenClaw官方地址：https://openclaw.ai/
豆包模型官方（火山方舟）：https://console.volcengine.com/ark/
火山云主机：https://console.volcengine.com/ecs
飞书开放平台：https://open.feishu.cn/
三、OpenClaw官方安装步骤（Ubuntu 24.04）
3.1 安装前置依赖
先更新系统并安装基础工具，避免安装过程报错：
sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git build-essential ca-certificates
3.2 一键官方安装
采用OpenClaw官方推荐的一键安装脚本，自动检测Node环境、完成CLI安装并启动引导：
curl -fsSL https://openclaw.ai/install.sh | bash
若需跳过初始化引导，仅安装程序，执行以下命令：
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
3.3 验证安装
安装完成后，关闭当前终端，重新打开，执行以下命令校验：
# 查看版本号，验证安装成功
openclaw --version
# 检查环境与配置完整性
openclaw doctor
3.4 初始化配置
执行初始化向导，按提示完成基础配置、模型密钥绑定、通道预设等操作：
openclaw onboard
四、单OpenClaw+单飞书账号基础配置
该模式适用于单人、小型团队初步使用，实现单个AI机器人对接单个飞书账号，完成基础交互和自动化任务。
4.1 飞书机器人创建配置飞书接入
要让 OpenClaw 能够接收和发送飞书消息，我们需要在飞书开放平台创建一个企业自建应用，并获取必要的凭证信息。
创建飞书应用
访问飞书开放平台
2. 创建企业自建应用并发布
点击页面右上角的 “创建企业自建应用”
填写应用名称（例如：我的AI助理）
填写应用描述（可选）
点击 “确定创建”
点击“创建企业自建应用”，填写应用名称（如“我的助理”）和描述。
3. 获取应用凭证
创建后进入应用详情页，点击“凭证与基础信息”，获取App ID和App Secret。
进入应用详情页
点击左侧菜单 “凭证与基础信息”
记录下 App ID 和 App Secret
4、为应用添加机器人能力
在应用详情页左侧菜单中，点击 “添加应用能力”
找到 “机器人” 能力，点击 “添加”：为应用添加机器人能力，开通im:message等消息收发核心权限。
配置机器人信息：
5、配置权限
在左侧目录树选择“开发配置 > 权限管理”，单击“批量导入/导出权限”按钮。
在“导入”页签中，将如下权限替换原有示例，单击“下一步，确认新增权限”按钮。
{
"scopes": {
"tenant": [
"contact:contact.base:readonly",
"docx:document:readonly",
"im:chat:read",
"im:chat:update",
"im:message.group_at_msg:readonly",
"im:message.p2p_msg:readonly",
"im:message.pins:read",
"im:message.pins:write_only",
"im:message.reactions:read",
"im:message.reactions:write_only",
"im:message:readonly",
"im:message:recall",
"im:message:send_as_bot",
"im:message:send_multi_users",
"im:message:send_sys_msg",
"im:message:update",
"im:resource",
"application:application:self_manage",
"cardkit:card:write",
"cardkit:card:read"
],
"user": [
"contact:user.employee_id:readonly",
"offline_access",
"base:app:copy",
"base:field:create",
"base:field:delete",
"base:field:read",
"base:field:update",
"base:record:create",
"base:record:delete",
"base:record:retrieve",
"base:record:update",
"base:table:create",
"base:table:delete",
"base:table:read",
"base:table:update",
"base:view:read",
"base:view:write_only",
"base:app:create",
"base:app:update",
"base:app:read",
"board:whiteboard:node:create",
"board:whiteboard:node:read",
"calendar:calendar:read",
"calendar:calendar.event:create",
"calendar:calendar.event:delete",
"calendar:calendar.event:read",
"calendar:calendar.event:reply",
"calendar:calendar.event:update",
"calendar:calendar.free_busy:read",
"contact:contact.base:readonly",
"contact:user.base:readonly",
"contact:user:search",
"docs:document.comment:create",
"docs:document.comment:read",
"docs:document.comment:update",
"docs:document.media:download",
"docs:document:copy",
"docx:document:create",
"docx:document:readonly",
"docx:document:write_only",
"drive:drive.metadata:readonly",
"drive:file:download",
"drive:file:upload",
"im:chat.members:read",
"im:chat:read",
"im:message",
"im:message.group_msg:get_as_user",
"im:message.p2p_msg:get_as_user",
"im:message:readonly",
"search:docs:read",
"search:message",
"space:document:delete",
"space:document:move",
"space:document:retrieve",
"task:comment:read",
"task:comment:write",
"task:task:read",
"task:task:write",
"task:task:writeonly",
"task:tasklist:read",
"task:tasklist:write",
"wiki:node:copy",
"wiki:node:create",
"wiki:node:move",
"wiki:node:read",
"wiki:node:retrieve",
"wiki:space:read",
"wiki:space:retrieve",
"wiki:space:write_only"
]
}
}
在弹窗中确认权限无误后，单击“申请开通”按钮。
说明
相关权限的具体含义可查看飞书API权限列表。
单击“配置”按钮设置权限可访问的数据范围（本文保持默认“与应用的可用范围一致”），单击“确定”按钮完成操作。
6、为应用添加事件与回调
在应用详情页左侧菜单中，点击 “事件与回调”
事件配置
选择“事件配置”页签，单击“订阅方式”旁的编辑按钮。
选择“使用 长连接 接收事件”，并单击“保存”按钮。
在“已添加事件”区域，单击“添加事件”按钮。
在添加事件对话框中，选择“应用身份订阅”页签，搜索“消息”并勾选“接收消息”、“消息被reaction”及“消息被取消reaction”三个事件，单击“确认添加”按钮。
（可选）若您期望将机器人添加到聊天群组中使用，需开通获取群组消息权限。否则，请跳过本步骤。
注意：由于OpenClaw是个人AI助手，在群聊场景下可能存在凭证泄露等风险，请谨慎使用。
在“已添加事件”模块中，单击“接收消息”事件“所需权限”列的“查看其它权限”按钮。
单击“获取群组中所有消息（敏感权限）”。
在弹窗中单击“开通权限”按钮，申请开通。
回调配置
选择“回调配置”页签，单击“订阅方式”旁的编辑按钮。
选择“使用 长连接 接收回调”，并单击“保存”按钮。
在添加回调对话框中，选择“卡片”页签，并勾选“卡片回传交互”，单击“确认添加”按钮。
4.2 飞书通道配置
编辑OpenClaw核心配置文件 ~/.openclaw/openclaw.json，在channels模块中配置飞书账号信息：
"channels": {
"feishu": {
"enabled": true,
"domain": "feishu",
"dmPolicy": "pairing",
"accounts": {
"default": {
"enabled": true,
"name": "AICEO",
"appId": "你的飞书AppID",
"appSecret": "你的飞书AppSecret",
"encryptKey": null,
"verificationToken": null,
"workspace": "/root/.openclaw/workspace"
}
}
}
}
4.3 启动网关
# 启动网关服务
openclaw gateway start 或 openclaw gateway restart
# 查看服务状态
openclaw gateway status
4.4 用户配对授权
首次向飞书机器人发送消息，会收到配对码，在服务器终端执行授权命令：
openclaw pairing approve feishu 你的配对码
授权完成后，即可正常与机器人交互。
五、单OpenClaw+单飞书+多机器人+多Agent配置（实战推荐）
该模式可打造专业AI团队，解决单一机器人记忆混杂、专业度不足、无法并行工作的问题，实现各智能体分工协作、互不干扰。
5.1 核心工作逻辑
在动手配置前，需先理清OpenClaw多Agent系统的三大核心概念与工作逻辑，避免配置过程中出现混淆：
工作流程逻辑：用户向飞书机器人发送消息→飞书账号（Accounts）接收消息→路由（Bindings）根据预设映射规
用户向飞书机器人发送消息→飞书账号接收消息→路由规则转发至对应Agent→Agent处理后原路反馈，全程做到消息不串线、能力不重叠、数据不泄露。
5.2 多Agent核心优势
完全隔离：每个Agent拥有独立工作区、记忆、人设、配置，互不干扰
专业深耕：单一Agent专注单一领域，处理精度更高、流程更稳定
并行运行：单服务器可同时运行多个AI智能体，高效处理多任务
协同互通：Agent间可通信、流转任务、互相调用能力
低成本：无需多台服务器，单实例即可搭建完整AI作业团队
5.3 多Agent创建（官方命令，禁止手动改配置）
以经典4智能体架构为例，创建主助手、CEO、运营副总裁、财务副总裁四类角色：
# 创建CEO智能体
openclaw agents add aiceo \
--workspace /root/.openclaw/workspace-aiceo \
--model byteplus-plan/doubao-seed-code
# 创建运营副总裁智能体
openclaw agents add aicoo \
--workspace /root/.openclaw/workspace-aicoo \
--model byteplus-plan/doubao-seed-code
# 创建财务副总裁智能体
openclaw agents add aicfo \
--workspace /root/.openclaw/workspace-aicfo \
--model byteplus-plan/doubao-seed-code
执行命令后，系统自动生成独立目录、写入配置、初始化隔离环境。
5.4 多飞书机器人配置
为每个Agent单独创建飞书自建应用（机器人），分别获取App ID和App Secret，在配置文件中配置多账号：
"channels": {
"feishu": {
"enabled": true,
"domain": "feishu",
"dmPolicy": "pairing",
"accounts": {
"aiceo": {
"enabled": true,
"name": "AICEO",
"appId": "CEO机器人AppID",
"appSecret": "CEO机器人AppSecret",
"encryptKey": null,
"verificationToken": null,
"workspace": "/root/.openclaw/workspace-aiceo"
},
"aicoo": {
"enabled": true,
"name": "AICOO",
"appId": "运营机器人AppID",
"appSecret": "运营机器人AppSecret",
"encryptKey": null,
"verificationToken": null,
"workspace": "/root/.openclaw/workspace-aicoo"
},
"aicfo": {
"enabled": true,
"name": "AICFO",
"appId": "财务机器人AppID",
"appSecret": "财务机器人AppSecret",
"encryptKey": null,
"verificationToken": null,
"workspace": "/root/.openclaw/workspace-aicfo"
},
"default": {
"groupPolicy": "open",
"dmPolicy": "open",
"allowFrom": [
"*"
]
}
}
}
}
5.5 消息路由绑定（核心配置）
配置bindings规则，将飞书账号与对应Agent精准绑定，避免消息错发：
"bindings": [
{
"type": "route",
"agentId": "main",
"match": {
"channel": "feishu",
"accountId": "default"
}
},
{
"agentId": "aiceo",
"match": {
"channel": "feishu",
"accountId": "aiceo"
}
},
{
"agentId": "aicoo",
"match": {
"channel": "feishu",
"accountId": "aicoo"
}
},
{
"agentId": "aicfo",
"match": {
"channel": "feishu",
"accountId": "aicfo"
}
}
]
5.6 Agent间协同通信配置
开启Agent互访权限，实现AI团队内部协作、任务流转：
"tools": {
"profile": "coding",
"web": {
"search": {
"enabled": false
},
"fetch": {
"enabled": true
}
},
"sessions": {
"visibility": "all"
},
"agentToAgent": {
"enabled": true,
"allow": [
"aiceo",
"aicoo",
"aicfo"
]
}
}
5.7 重启网关生效
多Agent配置修改后，必须重启网关才能生效：
openclaw gateway restart
5.8 功能验证
分别向各个飞书机器人发送消息，检查是否由对应Agent回复，测试Agent间协作是否正常。
六、常用运维命令汇总
# 启动网关
openclaw gateway start
# 重启网关
openclaw gateway restart
# 查看网关状态
openclaw gateway status
# 查看Agent列表及绑定关系
openclaw agents list --bindings
# 查看通道配置状态
openclaw channels status
# 初始化配置
openclaw onboard
# 环境诊断排查
openclaw doctor
# 查看版本
openclaw --version
# 用户配对授权
openclaw pairing approve feishu 配对码
# 搜索配置文件中的旧配置
grep -r "byteplus:default" ~/.openclaw/
# 查看实时日志
openclaw logs --follow
七、常见问题与排错
7.1 飞书机器人无反馈
执行重新配置命令，核对AppID、AppSecret、路由绑定是否正确：
openclaw configure
7.2 多Agent记忆混乱、互相干扰
必须通过 openclaw agents add 命令创建Agent，手动修改配置易导致路径冲突；确保每个Agent的workspace和agentDir完全独立。
7.3 Agent间无法通信
检查 tools.agentToAgent 模块，确认enabled设为true，allow列表包含所有需要协同的Agent ID。
7.4 消息路由失败，全部进入默认Agent
核对bindings配置中channel名称、accountId、agentId是否与飞书账号、Agent名称完全一致。
7.5 创建Agent报错无权限
使用sudo权限执行命令，给工作目录赋予755权限：
chmod -R 755 /root/.openclaw/
7.6 部分Agent启动掉线
服务器内存不足，升级服务器配置，或减少并行运行的Agent数量。
八、OpenClaw卸载
8.1 停止服务
openclaw gateway stop
8.2 卸载CLI
npm uninstall -g openclaw
8.3 清理配置文件（彻底卸载）
rm -rf ~/.openclaw/
