大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



本教程将指导您搭建一个由 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

  sudo apt update && sudo apt install -y git

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

  source ~/.bashrc

  nvm install 22 && nvm use 22

  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

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

• Windows (PowerShell)

  powershell

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

  安装后可使用 命令。

2. 配置通义千问模型

安装后，启动配置向导：

bash

openclaw onboard

openclaw-cn onboard

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

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

---

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

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

---

🔗 步骤三：连接 OpenClaw 与飞书

1. 配置 OpenClaw 飞书渠道

启动 OpenClaw 配置工具：

bash

openclaw config

openclaw-cn config

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

1. 选择 (渠道) → (飞书)。
2. 输入上一步获取的 App ID​ 和 App Secret。
3. 域名选择 。
4. 群聊策略选择 (群内@机器人时回复)。
5. 完成后，选择 并退出。

2. 重启网关服务

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

bash

openclaw gateway restart

openclaw-cn gateway restart

3. 配置飞书事件与权限

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

• 开通权限

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

  • (获取用户信息)
  • (收发消息)
  • (接收群@消息)
  • (接收私信)
  • (以机器人身份发送消息)
  • (上传/下载文件)
• 订阅事件
  1. 进入【事件与回调】页面。
  2. 订阅方式选择【使用长连接接收事件】。
  3. 点击【添加事件】，搜索并勾选 (接收消息)。建议同时添加 (机器人进群) 等事件。
• 发布应用
  1. 进入【版本管理与发布】页面，点击【创建新版本】。
  2. 填写版本说明，选择【保存】后点击【申请线上发布】。
  3. 等待管理员审批通过。

---

🚀 步骤四：测试与使用

1. 找到并添加机器人

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

2. 首次对话与设置

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

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

---

🔧 常见问题排查

• 安装失败/卡住：大概率是内存不足。请确保已配置 Swap 虚拟内存。
• ：执行 刷新环境变量，或重启终端/电脑。
• 飞书机器人无反应：
  1. 检查 OpenClaw 网关是否运行 ()。
  2. 核对飞书应用的 App ID 和 App Secret 是否正确。
  3. 确认【事件与回调】已配置长连接并订阅了 事件。
  4. 每次修改权限或事件后，必须在飞书后台【创建新版本】并发布。
• 飞书后台显示“未连接” ：
  1. 确保 OpenClaw 网关正在运行。
  2. 检查服务器防火墙是否放行相关端口。
  3. 重启 OpenClaw 网关服务。