OpenClaw+飞书+通义千问 AI助手搭建

每日技术
26 阅读4分钟

本教程将指导您搭建一个由 OpenClaw 作为大脑、通义千问作为模型、飞书作为交互界面的 AI 助手。

📝 整体架构与准备

1. 架构说明

  • OpenClaw (大脑) ：一个开源 AI 智能体，负责理解指令、调用工具（如读写文件、执行命令、浏览网页）并完成任务。
  • 通义千问 (模型) ：作为 OpenClaw 的“大脑”，通过 API 提供推理能力。推荐使用 OAuth 模式，无需手动管理 Key。
  • 飞书 (界面) ：作为与 AI 助手交互的聊天窗口，通过“企业自建应用 + 机器人”接入，支持长连接，无需公网 IP。

2. 准备工作清单

  • 运行环境：一台云服务器 (推荐 2核2G+，Ubuntu 22.04) 或本地电脑 (Windows/macOS/WSL2)。

  • 软件工具：

    • Node.js ≥ 22.x
    • Git
    • 若内存 ≤ 2GB，建议配置 Swap 虚拟内存。

  • 账号凭证：

    • 飞书账号 (需有创建企业自建应用的权限)。
    • 通义千问账号 (用于 OAuth 授权)。

🦾 步骤一：安装与配置 OpenClaw

1. 安装 OpenClaw

  • Linux / WSL2

    bash

    1. 安装 Git 和 Node.js 22

    sudo apt update && sudo apt install -y git

    curl -o- gitee.com/RubyMetric/…| bash

    source ~/.bashrc

    nvm install 22 && nvm use 22

    2. (可选) 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

    3. 一键安装 OpenClaw

    curl -fsSL openclaw.bot/install.sh| bash

  • Windows (PowerShell)

    powershell

    以管理员身份运行 PowerShell

    iwr -useb clawd.org.cn/install.ps1 | iex

    安装后可使用 openclaw-cn命令。

2. 配置通义千问模型

安装后，启动配置向导：

bash

Linux / WSL

openclaw onboard

Windows

openclaw-cn onboard

在向导中，关键步骤如下：

  1. 安全确认：输入 Yes继续。
  2. 配置模式：选择 QuickStart(快速开始)。
  3. 选择模型：选择 Qwen (OAuth)。
  4. 通义授权：终端会显示一个授权链接和验证码。在浏览器中打开链接，登录通义千问并授权。授权成功后，终端将自动继续。

🤖 步骤二：创建飞书机器人应用

  1. 进入开发者后台：访问 https://open.feishu.cn，进入【开发者后台】。
  2. 创建应用：选择【企业自建应用】，填写名称（如“AI小助手”）和描述后创建。
  3. 获取凭证：在应用的【凭证与基础信息】页面，复制 App ID​ 和 App Secret。
  4. 添加机器人能力：在【应用能力】中，点击【机器人】，为其命名（如“小爪”）。

🔗 步骤三：连接 OpenClaw 与飞书

1. 配置 OpenClaw 飞书渠道

启动 OpenClaw 配置工具：

bash

Linux / WSL

openclaw config

Windows

openclaw-cn config

在交互式菜单中，按以下指引操作：

  1. 选择 Channels(渠道) → Feishu/Lark(飞书)。
  2. 输入上一步获取的 App ID​ 和 App Secret。
  3. 域名选择 Feishu (feishu.cn) - China。
  4. 群聊策略选择 Open - respond in all groups (requires mention)(群内@机器人时回复)。
  5. 完成后，选择 Finished并退出。
2. 重启网关服务

配置完成后，必须重启网关使配置生效：

bash

Linux / WSL

openclaw gateway restart

Windows

openclaw-cn gateway restart

3. 配置飞书事件与权限

回到飞书开放平台，完成以下三项关键配置：

  • 开通权限

    在【权限管理】页面，搜索并开通以下权限：

    • contact:user.base:readonly(获取用户信息)
    • im:message(收发消息)
    • im:message.group_at_msg:readonly(接收群@消息)
    • im:message.p2p_msg:readonly(接收私信)
    • im:message:send_as_bot(以机器人身份发送消息)
    • im:resource(上传/下载文件)

  • 订阅事件

    1. 进入【事件与回调】页面。
    2. 订阅方式选择【使用长连接接收事件】。
    3. 点击【添加事件】，搜索并勾选 im.message.receive_v1(接收消息)。建议同时添加 im.chat.member.bot.added_v1(机器人进群) 等事件。

  • 发布应用

    1. 进入【版本管理与发布】页面，点击【创建新版本】。
    2. 填写版本说明，选择【保存】后点击【申请线上发布】。
    3. 等待管理员审批通过。

🚀 步骤四：测试与使用

  1. 找到并添加机器人

    在飞书客户端搜索你的应用名称，或在任意群聊的“添加机器人”中找到它并添加。

  2. 首次对话与设置

    向机器人发送 Hello，根据提示设置你的称呼，助手即可开始工作。

  3. 使用示例

    • 文件整理：“帮我把下载文件夹里上周的截图都移动到‘上周截图’文件夹。”
    • 网页摘要：“帮我总结一下这个页面的内容：”
    • 代码编写：“写一个 Python 脚本，批量将当前目录下的 .jpg 文件转换为 .png 格式。”

🔧 常见问题排查

  • 安装失败/卡住：大概率是内存不足。请确保已配置 Swap 虚拟内存。

  • openclaw: command not found：执行 source ~/.bashrc刷新环境变量，或重启终端/电脑。

  • 飞书机器人无反应：

    1. 检查 OpenClaw 网关是否运行 (openclaw status)。
    2. 核对飞书应用的 App ID 和 App Secret 是否正确。
    3. 确认【事件与回调】已配置长连接并订阅了 im.message.receive_v1事件。
    4. 每次修改权限或事件后，必须在飞书后台【创建新版本】并发布。

  • 飞书后台显示“未连接” ：

    1. 确保 OpenClaw 网关正在运行。
    2. 检查服务器防火墙是否放行相关端口。
    3. 重启 OpenClaw 网关服务。
avatar
文章
阅读
粉丝