当前位置：首页 > news >正文

OpenClaw对接百川2-13B实战：本地部署与飞书机器人配置指南

news 2026/3/26 8:22:04

OpenClaw对接百川2-13B实战：本地部署与飞书机器人配置指南

1. 为什么选择OpenClaw+百川2-13B组合

去年我在整理团队知识库时，每天要重复执行几十次"下载附件→重命名→分类存储→提取关键信息"的操作。直到发现OpenClaw这个能像人类一样操作电脑的开源智能体框架，配合百川2-13B这类中量级模型，终于实现了工作流的自动化。

这个组合最吸引我的三个特点：

隐私安全：所有数据处理都在本地完成，敏感文档无需上传第三方
成本可控：4bit量化的百川2-13B在消费级显卡就能运行，显存占用仅10GB左右
交互自然：通过飞书机器人用对话方式触发任务，比写脚本更符合直觉

2. 环境准备与基础安装

2.1 硬件配置建议

我的开发机是MacBook Pro M1（16GB内存），实测同时运行百川2-13B和OpenClaw时内存占用约12GB。Windows/Linux用户建议：

显卡：RTX 3060及以上（显存≥12GB）
内存：建议32GB（最低16GB）
存储：至少20GB可用空间

2.2 OpenClaw安装

通过npm安装汉化版（国内网络更友好）：

sudo npm install -g @qingchencloud/openclaw-zh@latest openclaw --version # 验证安装

初始化配置时选择Advanced模式，模型提供方暂时跳过：

openclaw onboard > Mode selection: Advanced > Provider: Skip for now > Skills: Yes (启用基础技能模块)

3. 百川2-13B模型部署

3.1 获取模型镜像

在星图平台搜索"百川2-13B-对话模型-4bits量化版"，部署后获得API访问地址，形如：

http://192.168.1.100:5000/v1

3.2 配置模型连接

编辑OpenClaw配置文件（通常位于~/.openclaw/openclaw.json），新增模型提供方：

{ "models": { "providers": { "baichuan": { "baseUrl": "http://192.168.1.100:5000/v1", "apiKey": "your-api-key-here", "api": "openai-completions", "models": [ { "id": "baichuan2-13b-chat", "name": "Baichuan2-13B-Chat", "contextWindow": 4096, "maxTokens": 2048 } ] } } } }

重启网关使配置生效：

openclaw gateway restart

4. 飞书机器人集成

4.1 飞书应用创建

登录飞书开放平台
创建"企业自建应用"，记录App ID和App Secret
在"权限管理"中开通"获取用户发给机器人的单聊消息"等权限

4.2 OpenClaw插件安装

openclaw plugins install @m1heng-clawd/feishu openclaw plugins list # 确认安装成功

修改配置文件添加飞书通道：

{ "channels": { "feishu": { "enabled": true, "appId": "your-app-id", "appSecret": "your-app-secret", "connectionMode": "websocket" } } }

4.3 消息订阅配置

在飞书开发者后台：

进入"事件订阅"，添加"接收消息"事件
设置请求网址为http://你的服务器IP:18789/feishu/events
验证并启用配置

5. 实战：文件整理自动化

5.1 安装文件处理技能

clawhub install file-processor clawhub list --installed # 确认技能列表

5.2 通过飞书触发任务

在飞书群聊中@机器人发送：

请整理我的下载文件夹，将所有PDF文件移动到~/Documents/PDF目录，并按日期重命名

OpenClaw会执行以下动作：

扫描~/Downloads目录
过滤出PDF文件
按"YYYYMMDD-原文件名"格式重命名
创建目标目录（如不存在）
移动文件并返回操作日志

5.3 执行效果验证

我测试时有个意外情况：某些PDF文件名包含特殊字符导致移动失败。通过查看OpenClaw日志发现是编码问题，后来在技能配置中添加了文件名清洗规则：

{ "skills": { "file-processor": { "filenameClean": true, "replaceSpace": "_" } } }

6. 常见问题排查

问题1：飞书消息无法触发任务

检查网关是否运行：openclaw gateway status
验证飞书IP白名单是否包含服务器IP

问题2：模型响应超时

测试模型API直接调用：curl http://192.168.1.100:5000/v1/chat/completions -H "Content-Type: application/json" -d '{"model":"baichuan2-13b-chat","messages":[{"role":"user","content":"你好"}]}'
调整OpenClaw超时设置："models": { "timeout": 60000 }

问题3：文件操作权限不足