搭建OpenClaw

背景

OpenClaw 是一款开源 AI 助手,能够 24*7 执行电脑操作任务,能够通过飞书等通讯平台接入,直接通过通讯软件和它交流,指挥它干活。最近也准备搭建一套试试看效果。

准备工作

1. 服务器要求

  • 已安装 1Panel 面板的服务器
  • Docker 和 Docker Compose 已安装
  • 开放 18789 和 18790 端口

2. AI 模型准备

OpenClaw 需要配置 AI 模型才能工作,支持 OpenAI 和 Claude 两种协议:

  • OpenAI 协议:适用于 OpenAI、Gemini 等模型
  • Claude 协议:适用于 Claude 模型

由于我已经有智谱的coding套餐,所以直接使用glm-4.7模型,省钱是主要的。

1Panel 部署 OpenClaw

1. 创建模型账号

这里由于我有自己的AI代理,所以就配置了自定义,模型就填写上面提到的glm-4.7

2. 创建智能体

这里需要选择上面创建的模型账号

3. 配置反向代理

4. 访问控制台

第一次访问先配置令牌,并点击链接,之后在同一个浏览器里就不需要再次填写了。

5. 测试

接着我们可以在聊天界面中和它对话,看看是否正常。正常则说明调用AI模型都是没问题的,就可以继续配置飞书了。

飞书配置

1.创建企业自建应用

打开飞书开放平台 https://open.feishu.cn/app,点击“创建企业自建应用”,填写名称、描述和图标。

飞书创建企业自建应用

飞书后台创建应用入口。

2.复制应用凭证

进入“凭证与基础信息”,复制并保存 App ID(例如 cli_xxx)和 App Secret。

飞书应用凭证

请妥善保管 App Secret,避免泄露。

3.批量导入应用权限

在“权限管理”页点击“批量导入”,粘贴下方权限 JSON(官方推荐),然后提交。

1
{ "scopes": { "tenant": [ "contact:contact.base:readonly", "aily:file:read", "aily:file:write", "application:application.app\_message\_stats.overview:readonly", "application:application:self\_manage", "application:bot.menu:write", "cardkit:card:write", "contact:user.employee\_id:readonly", "corehr:file:download", "docs:document.content:read", "event:ip\_list", "im:chat", "im:chat.access\_event.bot\_p2p\_chat:read", "im:chat.members:bot\_access", "im:message", "im:message.group\_at\_msg:readonly", "im:message.group\_msg", "im:message.p2p\_msg:readonly", "im:message:readonly", "im:message:send\_as\_bot", "im:resource", "sheets:spreadsheet", "wiki:wiki:readonly" ], "user": [ "aily:file:read", "aily:file:write", "contact:contact.base:readonly", "im:chat.access\_event.bot\_p2p\_chat:read" ] } }

飞书权限导入

导入后请检查关键权限是否都在“已申请”状态。

4.启用机器人能力

打开“应用能力 > 机器人”,启用机器人并设置机器人名称。

飞书机器人能力

机器人名称建议与 OpenClaw 应用场景保持一致。

5.在 1Panel 中配置飞书

打开“智能体 > 配置”,在聊天渠道中启用飞书,并填写 App ID 和 App Secret。

飞书配置

6.配置事件订阅(长连接)

进入“事件订阅”,选择“使用长连接接收事件(WebSocket)”,并添加事件 im.message.receive_v1

飞书事件订阅配置

若保存失败,优先检查 OpenClaw 网关是否正在运行。

7.发布应用

在“版本管理与发布”中创建版本并提交发布,等待企业管理员审批(企业自建应用通常可快速通过)。

8.发布后快速验证

  1. 在飞书中找到机器人,发送一条测试消息。
  2. 如果收到配对码,在 1Panel 中填写配对码并保存。
  3. 如果没有收到配对码,直接可以对话,则无须后续步骤。

飞书配置

随后再发送消息即可正常对话。若异常,可查看容器日志排查问题。

效果