搭建OpenClaw

搭建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.发布后快速验证
- 在飞书中找到机器人,发送一条测试消息。
- 如果收到配对码,在 1Panel 中填写配对码并保存。
- 如果没有收到配对码,直接可以对话,则无须后续步骤。
随后再发送消息即可正常对话。若异常,可查看容器日志排查问题。























