在腾讯云上部署你的 24 小时 AI 数字员工:Clawbot × 飞书实战指南

793 阅读7分钟

OpenClaw(原 Clawdbot/Moltbot)作为近期爆火的开源高权限 AI 智能体,凭借代码生成、任务自动化、多源信息检索等能力,已成为团队提效的核心工具。

结合柿柿校友圈的运营场景,我们团队面临着高频用户咨询、多角色协作、海量信息检索的效率瓶颈。基于此,我们通过Clawbot与飞书的集成,构建了一套轻量化、高可用的智能协作方案。

准备工作

在开始之前,你需要准备:

  • 腾讯云账号:须完成实名认证(个人、企业均可)。
  • 飞书账号:需要企业/团队级飞书账号,且拥有「创建企业自建应用」权限。
  • 大模型API Key:优先选国内适配性强的(腾讯混元、通义千问、DeepSeek都可)。
  • 安全提醒:Clawbot权限较高,建议部署在云端,不要安装非官方插件,防止 数据泄露

一、新购实例

1.新购一台实例(Clawdbot完全不吃性能,所以2核2G就够用了。)

腾讯云地址:cloud.tencent.com/act/pro/lig…

2.确认配置后点击「立即购买」,完成支付,等待1-3分钟,实例创建成功(页面显示「运行中」即可)。

3.点击查看服务器

二、OpenClaw配置

腾讯云Lighthouse在产品控制台提供了可视化界面进行OpenClaw配置,通用的操作步骤如下。

进入“应用管理”页签,可以看到如下所示的界面

接下来即可在界面上进行模型配置、OpenClaw的Channel 配置(包括QQ、企微、钉钉、飞书)

配置模型 API Key

此处选择火山引擎(豆包)作为示例进行演示,腾讯混元、DeepSeek(深度求索)、通义千问等其他模型的配置方式大体类似。

进入火山引擎的API Key管理页后,点击页面内的创建API KEY按钮并复制粘贴进面板的“模型配置-API Key”输入框,点击添加按钮保存模型API Key配置。

点击添加之后稍等片刻,直至出现“保存成功”的提示。

添加完成后,在模型配置的页签下将会新增一条模型配置,此时需要再点击对应模型后的应用按钮来使其生效。

点击应用后,单击确认,待网关状态重新变为运行中,且模型状态更新为使用中时,即完成配置。

火山引擎Coding Plan接入教程

1.购买Coding Plan Lite订阅套餐,新用户首月9.9,通过下方链接最低8.9

volcengine.com/L/HlRVFPobv…

2.在腾讯云模型配置处输入以下信息并添加

{
  "provider": "火山引擎",
  "base_url": "https://ark.cn-beijing.volces.com/api/coding/v3",
  "api": "openai-completions",
  "api_key": "火山引擎api",
  "model": {
    "id": "kimi-k2.5",
    "name": "Kimi-K2.5"
  }
}

3.添加成功后点击应用,并等待重启完成即可。

创建 飞书 企业 自建应用

首先,您需要使用您的飞书账号登录飞书开放平台。登录成功后,点击创建企业 自建应用

填写应用名称应用描述,选择应用图标,点击创建按钮,进入应用管理页面。

在左侧导航栏中找到并点击添加应用能力,在列表中选择机器人,点击添加

在左侧导航栏找到 “凭据与基础信息” ,点击进入。在页面中找到 “App ID” 和 “App Secret” 两个参数,分别复制到剪切板。

在腾讯云“Channel配置”输入框,选择“飞书”,并将 “App ID” 和 “App Secret” 粘贴至此,并点击应用并确定执行操作,等待几十秒后页面提示“保存成功”即完成配置。

飞书机器人 相关配置

事件配置

在飞书应用管理页,左侧导航栏找到 “事件与回调” ,点击进入页面。在“事件配置”页签中选择 “长连接接收事件”,点击保存

点击该页面中的 “添加事件”,在弹出的列表中,勾选 “接收消息”、“消息已读”、“机器人进群”、“机器人被移出群”,点击 “确认添加”,按照指引确认开通权限。

完成事件配置后,可以在当前页面中查看到已添加事件。

回调 配置

在“事件与回调-回调配置”页面中,订阅方式选择 “使用长连接”,点击保存,无需填写其他地址,配置自动生效。

权限配置

在飞书应用管理页,左侧导航栏找到 “权限管理” ,点击进入页面。点击页面中的 “批量导入权限” 按钮,弹出权限导入窗口。

复制以下代码,替换前面弹窗中原有的JSON内容,点击下一步,确认新增权限,继续申请开通,确认后等待权限导入完成。

{
  "scopes": {
    "tenant": [
      "contact:contact.base:readonly",
      "docx:document",
      "docx:document.block:convert",
      "docx:document:readonly",
      "drive:drive",
      "drive:drive:readonly",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.group_msg",
      "im:message.p2p_msg:readonly",
      "im:message.reactions:read",
      "im:message:readonly",
      "im:message:recall",
      "im:message:send_as_bot",
      "im:message:update",
      "im:resource",
      "wiki:wiki",
      "wiki:wiki:readonly"
    ],
    "user": []
  }
}

权限列表中出现以下已导入的权限,即为配置完成。

创建版本并发布

在飞书应用管理页,左侧导航栏找到 “版本管理与发布” ,点击进入页面。点击右上角的创建版本

发布成功后,可以在“版本管理与发布”页面,查看到已经发布的版本号和状态。

发布成功后单击打开应用即可与机器人对话。

到这里就完成配置,在手机版飞书和电脑版飞书上均可以开始与已经接入OpenClaw的飞书机器人进行聊天。

本地电脑使用 Web UI教程

准备工作
  1. 确认服务器端 Gateway 已启动:
openclaw gateway status
openclaw gateway start
  1. 确认端口和 Token:
cat ~/.openclaw/openclaw.json | grep -A 5 '"gateway"'

此处选择SSH隧道方法,最简单、最安全的临时访问方式。

步骤

1.在本地电脑上执行:

ssh -L 18789:localhost:18789 用户名@服务器IP -N

2.示例:

ssh -L 18789:localhost:18789 root@192.168.1.100 -N

连接时提示Are you sure you want to continue connecting (yes/no/[fingerprint])?回复yes即可。下一步终端会要求输入服务器密码,如不知道密码可前往腾讯云控制面板重置。

3.保持 SSH 隧道连接(不要关闭终端)

4.在本地电脑浏览器打开:

http://localhost:18789

5.如果需要 Token,从服务器获取后填入

无论使用哪种方法,首次访问 Web UI 时可能需要 Gateway Token。

从服务器获取 Token

方法 1: 查看启动日志

# 前台启动查看日志
openclaw gateway --verbose

# 查找类似输出:
# Web UI: http://localhost:18789?token=eyJhbGciOiJIUzI1NiIs...

方法 2: 查看配置文件

cat ~/.openclaw/openclaw.json | grep -A2 '"token"'

Web UI 中输入 Token

  1. 打开 Web UI(通过 SSH 隧道、Tailscale 或 Nginx)
  2. 如果提示未授权,点击左下角 Settings
  3. 找到 Gateway ****Token 输入框
  4. 粘贴从服务器获取的 Token
  5. 点击 Save

或者直接在 URL 中带 Token 访问:

http://localhost:18789/?token=YOUR_TOKEN_HERE
常见问题排查

问题 1: SSH 隧道连接后无法访问

症状:浏览器显示 "无法连接" 或 "拒绝连接"

排查步骤:

# 1. 确认 SSH 隧道已建立
ps aux | grep "ssh -L"

# 2. 在服务器上检查 Gateway 是否监听
netstat -tlnp | grep 18789
# 或
ss -tlnp | grep 18789

# 3. 测试本地端口是否可连接
curl http://localhost:18789

解决方案:

  • 确保 Gateway 已启动:openclaw gateway start
  • 检查防火墙:sudo ufw allow 18789sudo iptables -I INPUT -p tcp --dport 18789 -j ACCEPT
  • 重新建立 SSH 隧道

问题 2: Web UI 显示 "Unauthorized" 或 " Token mismatch"

症状:页面显示未授权错误或要求输入 Token

解决方案:

  1. 从服务器获取 Gateway Token(见上文"获取 Gateway Token"部分)

  2. 在 Web UI 设置中粘贴 Token

  3. 或者使用带 Token 的 URL 直接访问

参考资源