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 飞书应用创建

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

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 消息订阅配置

在飞书开发者后台：

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

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

5.1 安装文件处理技能

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

5.2 通过飞书触发任务

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

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

OpenClaw会执行以下动作：

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

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：文件操作权限不足

• macOS需要授权终端磁盘访问权限
• Windows需以管理员身份启动OpenClaw

---

获取更多AI镜像

想探索更多AI镜像和应用场景？访问 CSDN星图镜像广场，提供丰富的预置镜像，覆盖大模型推理、图像生成、视频生成、模型微调等多个领域，支持一键部署。