OpenClaw(原 Clawdbot/Moltbot)作为近期爆火的开源高权限 AI 智能体,凭借代码生成、任务自动化、多源信息检索等能力,已成为团队提效的核心工具。
结合柿柿校友圈的运营场景,我们团队面临着高频用户咨询、多角色协作、海量信息检索的效率瓶颈。基于此,我们通过Clawbot与飞书的集成,构建了一套轻量化、高可用的智能协作方案。
准备工作
在开始之前,你需要准备:
- 腾讯云账号:须完成实名认证(个人、企业均可)。
- 飞书账号:需要企业/团队级飞书账号,且拥有「创建企业自建应用」权限。
- 大模型API Key:优先选国内适配性强的(腾讯混元、通义千问、DeepSeek都可)。
- 安全提醒:Clawbot权限较高,建议部署在云端,不要安装非官方插件,防止 数据泄露 。
一、新购实例
1.新购一台实例(Clawdbot完全不吃性能,所以2核2G就够用了。)
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
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教程
准备工作
- 确认服务器端 Gateway 已启动:
openclaw gateway status
openclaw gateway start
- 确认端口和 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 :
- 打开 Web UI(通过 SSH 隧道、Tailscale 或 Nginx)
- 如果提示未授权,点击左下角 Settings
- 找到 Gateway ****Token 输入框
- 粘贴从服务器获取的 Token
- 点击 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 18789或sudo iptables -I INPUT -p tcp --dport 18789 -j ACCEPT - 重新建立 SSH 隧道
问题 2: Web UI 显示 "Unauthorized" 或 " Token mismatch"
症状:页面显示未授权错误或要求输入 Token
解决方案:
-
从服务器获取 Gateway Token(见上文"获取 Gateway Token"部分)
-
在 Web UI 设置中粘贴 Token
-
或者使用带 Token 的 URL 直接访问
参考资源
- OpenClaw 官方文档:docs.openclaw.ai
- OpenClaw GitHub:github.com/openclaw/op…
- Tailscale 文档:tailscale.com/kb
- Nginx 文档:nginx.org/en/docs
- 腾讯云社区:cloud.tencent.com/developer/a…