本文记录了我在服务器上部署 OpenClaw 并配置 QQ Bot 的全过程，希望能帮到同样想折腾的朋友。

前言

你有没有想过，能在 QQ、微信、Telegram 等各种聊天软件里直接和 AI 对话？不是那种网页版的 ChatGPT，而是一个真正属于你的、部署在自己服务器上的 AI 助手？

OpenClaw 就是这么一个东西——一个开源的、自托管的 AI Agent 网关。它像一座桥，把你常用的聊天软件和 AI 模型连接起来。

今天这篇文章，就来分享一下如何从零开始配置 OpenClaw。

一、什么是 OpenClaw

简单来说，OpenClaw 是一个多渠道 AI 助手网关：

• 🏠 自托管：运行在你自己的服务器上，数据完全由你掌控
• 📱 多渠道：一个 Gateway 同时服务 QQ、Telegram、Discord、WhatsApp 等多个平台
• 🤖 Agent 原生：支持工具调用、会话管理、记忆系统、多智能体协作
• 🔓 开源免费：MIT 协议，社区驱动

用官方的话说："Any OS gateway for AI agents across Discord, Google Chat, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp, Zalo, and more."

• GitHub 仓库

项目概述

本项目旨在利用多模态大模型，对破损快递包裹进行识别，获取破损程度，并结合快递公司赔付政策，利用增强检索（RAG）技术，快速检索相关条款并生成赔付结果。项目集成多模态大模型图像识别、数据向量化存储检索、Agent决策等技术，为物流行业提供智能化解决方案。

技术栈

| 层级 | 技术 | 说明 | |

Coze Studio 扣子开源项目是一个基于 AI 的协同创作平台，旨在帮助用户更高效地进行内容创作和管理。Coze官方与2025.7.26日发布了Coze Studio的开源版本，支持本地部署。本文将实践如何在本地部署 Coze Studio 扣子开源项目。

1. 环境准备

• 操作系统：macOS 15 Sequoia
• Docker：Docker Desktop for macOS

部署步骤：

1. 获取源码。

   # 克隆代码
   git clone https://github.com/coze-dev/coze-studio.git
   

2. 配置模型。

   1. 从模板目录复制模型的模版文件，并粘贴到配置文件目录。

      # 模版文件目录
      backend/conf/model/template/xxx.yaml
      

      # 配置文件目录
      backend/conf/model/xxx.yaml
      

   2. 在配置文件目录下，修改模版文件。

      1. 进入目录 backend/conf/model。打开复制后的文件xxx.yaml。
      2. 设置 id、meta.conn_config.api_key、meta.conn_config.model 字段，并保存文件。
         • id：Coze Studio 中的模型 ID，由开发者自行定义，必须是非 0 的整数，且全局唯一。模型上线后请勿修改模型 id 。
         • meta.conn_config.api_key：模型服务的 API Key。
         • meta.conn_config.model：模型服务的 model ID。

3. 部署并启动服务。 首次部署并启动 Coze Studio 需要拉取镜像、构建本地镜像，可能耗时较久，请耐心等待。部署过程中，你会看到以下日志信息。如果看到提示 "Container coze-server Started"，表示 Coze Studio 服务已成功启动。

   # 启动服务
   cd docker
   cp .env.example .env
   docker compose --profile '*' up -d
   

注意：若本地已有SQL服务运行，可能会导致端口占用

4. 访问 Coze Studio。 打开浏览器，访问 http://localhost:8888，即可进入 Coze Studio 的 Web 界面。

项目中，部署使用了Google的Gemini免费API

Flutter是Google开发的一款软件包，能够构建高性能、高保真的移动应用。在更新之后可以支持Web、桌面应用和Android以及iOS设备，能够实现跨平台开发。

安装Flutter

1. 下载Flutter SDK：访问Flutter官网下载适合你操作系统的Flutter SDK。
2. 解压缩下载的文件到你希望安装Flutter的目录。
3. 将Flutter的bin目录添加到你的系统环境变量中，以便在终端或命令行中可以直接使用flutter命令。
4. 在终端或命令行中运行flutter doctor命令，检查Flutter的安装状态和依赖项。根据提示安装缺失的依赖项。

Redis是一个开源的内存数据库，遵守 BSD 协议，它提供了一个高性能的键值（key-value）存储系统，常用于缓存、消息队列、会话存储等应用场景。通常用于处理高并发操作

一、为什么选择 Redis？

相比传统数据库或文件系统，Redis 有以下优势：

• 🚀 超快的访问速度：所有数据存储于内存中，读写速度可达十万级 QPS。
• 📦 丰富的数据结构：支持字符串、列表、集合、有序集合、哈希等多种结构。
• 💾 支持持久化：通过 RDB、AOF 两种方式将内存快照保存到磁盘。
• 📡 内置高可用机制：支持主从复制、哨兵、集群部署。
• 🧠 广泛应用场景：从缓存到排行榜、分布式锁等，都能胜任。