OpenClaw 部署文档

记录 OpenClaw + Discord + 飞书机器人的完整部署流程

• 环境准备
• OpenClaw Gateway 部署
• 自定义 LLM 配置（Docker）
• Discord Bot 配置
• 飞书机器人配置
• 常见问题解决
• 管理命令

• Podman（容器运行环境）
• Node.js openclaw 配置 >= 18
• Git

• – Google DNS，用于解析外部域名（Discord）
• – 公司内部 DNS，用于解析内部域名（AI API）

输出示例：

实际访问地址（注意端口映射）：

查看待配对设备：

批准所有设备：

然后重启容器应用配对：

访问：https://discord.com/developers/applications

在 Bot 页面启用 Privileged Gateway Intents：

• ✅ Presence Intent
• ✅ Server Members Intent
• ✅ Message Content Intent（必须！）

在 Bot 页面点击 “Reset Token” 获取 token。

使用此 URL（替换 CLIENT_ID）：

在 Discord 中 @机器人名称 发送消息测试。

⚠️ 重要更新（v2026.2.2）：OpenClaw 现已官方支持飞书/Lark！推荐使用官方插件替代第三方桥接方案。

自 v2026.2.2 起，OpenClaw 官方支持飞书通道，使用 WebSocket 长连接接收消息，无需公网 URL。

访问：https://open.feishu.cn/app（国际版 Lark 用户访问 https://open.larksuite.com/app）

1. 点击”创建企业自建应用”
2. 填写应用名称和描述
3. 选择应用图标

在「凭证与基础信息」页面，复制：

• App ID（格式：）
• App Secret

❗ 重要：妥善保管 App Secret，不要泄露。

在「权限管理」页面，点击「批量导入」，粘贴以下 JSON：

在「应用能力」>「机器人」中：

1. 启用机器人能力
2. 设置机器人名称

在「事件订阅」页面：

1. 订阅方式：选择 「使用长连接接收事件」（WebSocket）
2. 添加事件：

⚠️ 配置事件订阅前，请确保 Gateway 已运行。

1. 在「版本管理与发布」创建版本
2. 提交审核并发布
3. 等待管理员审批（企业自建应用通常自动审批）

编辑 ：

如果使用国际版 Lark，需要设置 domain：

默认情况下，未知用户发消息会收到配对码。批准配对：

访问：https://open.feishu.cn/app

1. 点击”创建企业自建应用”
2. 选择”机器人”能力
3. 填写应用名称和描述

在”权限管理”页面启用：

• ✅ – 获取与发送消息
• ✅ – 获取群聊@消息
• ✅ – 获取单聊消息
• ✅ – 以应用身份发消息

在”事件订阅”页面：

1. 订阅方式：选择 “长连接”（不是 Webhook）
2. 添加事件：
3. 确认状态显示”已连接”

症状：

解决方案： 配置 DNS 为 Google DNS (8.8.8.8)：

症状：

解决方案： 添加公司内部 DNS：

症状：

说明： 这是正常现象（由于网络环境限制），bot 仍可正常响应消息。

解决方案（如果影响使用）： 禁用 Discord，只使用飞书：

症状： 在飞书中发消息给机器人，没有收到回复。

解决方案（官方插件）：

1. 确保应用已发布并审批通过
2. 确保事件订阅包含
3. 确保使用「长连接」接收事件
4. 确保应用权限完整
5. 检查 Gateway 是否运行：
6. 查看日志：

解决方案（旧版桥接）： 检查桥接服务是否运行：

解决方案： 参考 批准设备配对 部分。

原因： DNS 解析问题导致 AI API 访问慢。

解决方案： 使用混合 DNS 配置（参考 DNS 配置说明）。

⚠️ 仅适用于使用第三方桥接的旧部署。

⚠️ 以下脚本使用官方飞书插件。如果使用旧版第三方桥接，请参考飞书机器人配置中的「方式二」。

OpenClaw 支持配置自定义 LLM 提供商，包括使用自定义 API 端点和 token。以下是 Docker 部署中的详细配置方法。

最简单的方式是通过环境变量传递 API 密钥：

对于更复杂的配置，建议使用配置文件 ：

如果需要使用自定义 API 端点（如 Azure OpenAI、本地 Ollama 或第三方代理），使用 配置：

Docker 运行命令（需要添加网络访问）：

配置文件支持环境变量替换，使用 语法：

Docker 运行命令：

OpenClaw 也支持从 文件加载环境变量：

通过 CLI 命令修改模型配置：

检查配置是否正确：

📝 v2026.2.2 起，飞书已内置支持，无需独立桥接服务。

位置：

关键配置项：

部署完成后，请检查以下各项：

• OpenClaw 官方文档
• OpenClaw 飞书通道文档
• OpenClaw 模型配置文档
• OpenClaw Gateway 配置文档
• OpenClaw GitHub
• OpenClaw v2026.2.2 Release Notes
• 飞书-OpenClaw 桥接项目（旧）
• Discord Developer Portal
• 飞书开放平台

• 重大更新：飞书机器人配置改用官方插件（v2026.2.2+），保留旧版桥接方案作为参考
• 更新系统架构图，反映飞书已内置支持
• 更新快速启动脚本，简化飞书配置
• 更新验证清单和参考链接
• 新增「自定义 LLM 配置」章节
• 添加多种 LLM 提供商配置示例（Ollama、OpenRouter、Azure、MiniMax、Moonshot）
• 添加环境变量替换和 .env 文件支持说明
• 添加运行时模型配置修改方法

• 初始版本
• 完成 OpenClaw + Discord + 飞书的完整部署
• 解决 DNS 配置问题
• 优化响应速度

文档维护者： Emily Wang 最后更新： 2026-02-05