1. 项目概述
今天我要分享一个非常实用的AI助手搭建方案,这个方案结合了OpenClaw、通义千问和飞书三大组件,可以让你在飞书里拥有一个强大的AI助手。这个助手不仅能聊天,还能帮你处理文件、总结网页内容、编写代码等,特别适合需要提高工作效率的团队或个人使用。
这个方案最大的特点就是:
- 完全开源(OpenClaw)
- 使用国内大模型(通义千问)
- 集成到日常办公软件(飞书)
- 支持长连接,不需要公网IP
我在实际搭建过程中踩过不少坑,也总结了很多经验,今天就把完整的搭建过程和注意事项分享给大家。
2. 环境准备与架构解析
2.1 硬件与软件需求
首先我们来看下搭建这个系统需要准备什么:
硬件要求:
- 推荐使用云服务器(2核2G内存起步)
- 也可以使用本地电脑(Windows/macOS/WSL2)
- 如果内存小于2GB,必须配置Swap虚拟内存
软件要求:
- Node.js ≥ 22.x(这是OpenClaw的硬性要求)
- Git(用于代码管理)
- 一个稳定的网络环境
提示:如果你的服务器内存较小,建议提前配置好Swap空间,否则在安装过程中可能会因为内存不足而失败。
2.2 系统架构解析
这个AI助手的架构可以分为三层:
-
交互层(飞书):
- 提供用户界面
- 处理消息收发
- 管理用户权限
-
控制层(OpenClaw):
- 解析用户指令
- 调用适当的工具
- 管理任务流程
-
AI层(通义千问):
- 提供自然语言理解
- 生成响应内容
- 执行复杂推理
这种分层架构的好处是各组件职责明确,可以单独升级或替换。比如你可以保留飞书作为交互界面,只更换底层的AI模型。
3. OpenClaw安装与配置
3.1 基础环境安装
Linux/WSL2系统安装
对于Linux或WSL2环境,我们需要先安装必要的依赖:
bash复制# 更新软件包列表
sudo apt update && sudo apt upgrade -y
# 安装Git
sudo apt install -y git
# 安装Node.js 22.x
curl -o- https://gitee.com/RubyMetric/nvm-cn/raw/main/install.sh | bash
source ~/.bashrc
nvm install 22 && nvm use 22
Windows系统安装
Windows用户可以使用PowerShell安装:
powershell复制# 以管理员身份运行PowerShell
Set-ExecutionPolicy Bypass -Scope Process -Force
iwr -useb clawd.org.cn/install.ps1 | iex
安装完成后,Windows用户需要使用openclaw-cn命令,而Linux用户使用openclaw命令。
3.2 配置Swap空间(内存不足时)
如果你的服务器内存小于2GB,强烈建议配置Swap空间:
bash复制# 创建2GB的Swap文件
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
# 永久生效
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
# 验证Swap是否生效
free -h
3.3 安装OpenClaw
现在可以安装OpenClaw了:
bash复制# 一键安装
curl -fsSL https://openclaw.bot/install.sh | bash
# 验证安装
openclaw --version
安装完成后,我们需要进行初始化配置:
bash复制openclaw onboard
在配置向导中,按照以下步骤操作:
- 输入
Yes确认继续 - 选择
QuickStart模式 - 选择
Qwen (OAuth)作为模型 - 按照提示完成通义千问的授权
注意:通义千问的OAuth授权需要在浏览器中完成,确保你的服务器可以访问外网,或者有代理设置。
4. 飞书机器人应用创建
4.1 创建企业自建应用
- 访问飞书开放平台:https://open.feishu.cn
- 登录后进入"开发者后台"
- 点击"创建企业自建应用"
- 填写应用名称(如"AI小助手")和描述
- 点击"创建"
4.2 获取应用凭证
创建应用后,我们需要获取两个关键信息:
- App ID
- App Secret
这些信息可以在应用的"凭证与基础信息"页面找到。请妥善保存这些凭证,后续配置OpenClaw时会用到。
4.3 添加机器人能力
- 在应用管理页面,点击"应用能力"
- 选择"机器人"
- 为机器人命名(如"小爪")
- 保存设置
5. 系统集成与配置
5.1 配置OpenClaw的飞书渠道
现在我们需要把OpenClaw和飞书连接起来:
bash复制openclaw config
在交互式菜单中选择:
Channels→Feishu/Lark- 输入之前获取的App ID和App Secret
- 域名选择
Feishu (feishu.cn) - China - 群聊策略选择
Open - respond in all groups (requires mention) - 完成后选择
Finished退出
5.2 重启网关服务
配置完成后,必须重启网关使配置生效:
bash复制openclaw gateway restart
5.3 配置飞书权限和事件
回到飞书开放平台,完成以下关键配置:
开通必要权限
在"权限管理"页面,搜索并开通以下权限:
contact:user.base:readonlyim:messageim:message.group_at_msg:readonlyim:message.p2p_msg:readonlyim:message:send_as_botim:resource
订阅事件
- 进入"事件与回调"页面
- 选择"使用长连接接收事件"
- 添加
im.message.receive_v1事件 - 建议同时添加
im.chat.member.bot.added_v1事件
发布应用
- 进入"版本管理与发布"
- 点击"创建新版本"
- 填写版本说明
- 点击"申请线上发布"
- 等待管理员审批
重要提示:每次修改权限或事件后,都必须创建新版本并发布,否则更改不会生效。
6. 测试与使用
6.1 添加机器人
- 在飞书客户端搜索你的应用名称
- 或者在群聊的"添加机器人"中找到它
- 将机器人添加到个人聊天或群聊中
6.2 基本功能测试
向机器人发送Hello,它应该会回应并引导你完成初始设置。设置完成后,你就可以开始使用各种功能了。
6.3 实用功能示例
文件整理
"帮我把下载文件夹里上周的截图都移动到'上周截图'文件夹。"
网页摘要
"帮我总结一下这个页面的内容:[URL]"
代码编写
"写一个Python脚本,批量将当前目录下的.jpg文件转换为.png格式。"
数据分析
"分析这个CSV文件中的销售数据,找出销售额最高的三个产品。"
7. 常见问题与解决方案
7.1 安装问题
问题1:安装过程中卡住或失败
- 原因:通常是内存不足
- 解决方案:
- 确认已配置足够的Swap空间
- 关闭不必要的进程
- 尝试重新安装
问题2:openclaw: command not found
- 原因:环境变量未更新
- 解决方案:
- 运行
source ~/.bashrc - 或者重启终端/电脑
- 运行
7.2 飞书连接问题
问题1:机器人无响应
- 检查步骤:
- 确认OpenClaw网关正在运行(
openclaw status) - 核对App ID和App Secret是否正确
- 确认已订阅
im.message.receive_v1事件 - 检查是否已发布新版本
- 确认OpenClaw网关正在运行(
问题2:飞书后台显示"未连接"
- 检查步骤:
- 确认OpenClaw网关正在运行
- 检查服务器防火墙设置
- 尝试重启OpenClaw网关服务
7.3 性能优化建议
-
资源监控:定期检查系统资源使用情况
bash复制top free -h df -h -
日志查看:遇到问题时查看日志
bash复制
journalctl -u openclaw -f -
定期更新:保持OpenClaw和依赖项最新
bash复制
openclaw update
8. 高级配置与扩展
8.1 自定义技能开发
OpenClaw支持通过插件扩展功能。你可以开发自己的技能插件:
- 创建插件目录结构
- 编写技能逻辑
- 注册到OpenClaw
- 测试并部署
8.2 多模型支持
除了通义千问,OpenClaw还支持其他模型:
- 在配置中选择其他模型
- 提供相应的API密钥
- 调整模型参数
8.3 安全加固建议
- 使用HTTPS加密通信
- 定期轮换API密钥
- 设置IP访问限制
- 启用操作日志审计
我在实际使用中发现,这个AI助手特别适合处理重复性的办公任务。比如自动整理会议纪要、分类保存文件、快速生成报告等。刚开始可能需要一些时间来训练它理解你的工作习惯,但一旦调教好了,能节省大量时间。
最后分享一个小技巧:给机器人设置一个清晰的角色描述(比如"你是一个高效的数字助理,擅长整理文档和数据分析"),这样它的回答会更符合你的期望。
