OpenClaw 配置指南：DeepSeek 与 飞书集成

本文整合 OpenClaw 对接 DeepSeek 官方 API 与飞书（Lark）渠道的完整配置流程，适配 OpenClaw 2026.x 版本，覆盖环境准备、API 配置、飞书应用创建、渠道添加、权限配置全环节，一站式解决 OpenClaw 智能交互与企业办公工具的集成需求。

OpenClaw 运行需满足以下环境条件，跨平台兼容主流操作系统，核心依赖 Node.js 环境：

1. 操作系统：macOS / Linux / Windows（需启用 WSL 子系统）
2. Node.js：版本 22+（推荐使用 nvm 进行多版本管理，避免依赖冲突）
3. 网络环境：可正常访问 DeepSeek API（）与飞书开放平台（）
4. 权限要求：本地部署需拥有终端 / 命令行的管理员 / 超级用户权限，飞书集成需企业飞书管理员权限（用于应用创建与权限审批）

2.1 全局安装 OpenClaw

执行以下命令完成全局安装，安装过程将下载约 674 个依赖包，耗时 3-5 分钟，耐心等待即可：

2.2 验证安装结果

安装完成后，执行版本查询命令，确认输出类似 即表示安装成功：

2.3 初始化配置向导

通过非交互模式快速完成配置初始化并安装后台服务，自动接受安全风险声明，无需手动确认：

2.4 检查服务状态

确认 Gateway 核心服务正常运行，为后续 API 与渠道配置提供基础环境：

预期结果：终端显示 Gateway 服务为「正在运行」状态。

完成 OpenClaw 基础部署后，配置 DeepSeek API 作为智能交互的模型提供商，支持 DeepSeek Chat V3、DeepSeek Reasoner R1 等模型。

3.1 获取 DeepSeek API Key

1. 访问 DeepSeek 官方平台，完成注册与账号验证；
2. 进入平台「API 密钥」模块，创建并获取 API Key，格式为 ；
3. 妥善保存 API Key，避免泄露（后续配置需直接使用）。

3.2 配置 DeepSeek 模型提供商

执行以下命令，将替换为实际获取的 DeepSeek API Key，完成提供商基础配置：

3.3 设置默认交互模型

指定 为 OpenClaw 默认的智能交互模型，后续可根据需求切换：

3.4 创建模型别名（可选）

为模型创建简短别名，简化后续模型切换命令，提升使用效率：

3.5 重启 Gateway 服务使配置生效

等待 3-5 秒让服务完全重启，确保配置加载成功。

3.6 DeepSeek 配置测试与验证

3.6.1 命令行快速测试

发送测试消息，若收到 DeepSeek 中文回复，即表示 API 配置成功：

3.6.2 查看模型配置状态

确认默认模型与已配置模型列表是否正确：

预期结果：显示 ，且配置模型列表包含 deepseek 相关模型。

3.6.3 打开 Web 控制面板

通过可视化面板管理 OpenClaw，命令执行后将自动在浏览器打开面板：

面板访问 URL 格式：

完成 DeepSeek 模型配置后，集成飞书渠道实现 OpenClaw 与飞书的消息互通，支持单聊 / 群聊交互，需先在飞书开放平台创建企业自建应用，再完成 OpenClaw 端配置。

openclaw 安装

4.1 飞书开放平台：创建企业自建应用

1. 访问 飞书开放平台，使用企业飞书账号登录；
2. 点击「创建企业自建应用」，填写应用基础信息，点击「创建」：
   • 应用名称：自定义（如「OpenClaw 智能助手」）
   • 应用描述：简要说明应用用途（如「OpenClaw 飞书智能交互机器人」）
   • 应用图标：任意上传（要求 SVG/BMP/PNG/JPEG 格式，2MB 以内，分辨率≥240*240px）；
3. 应用创建成功后，进入应用管理后台，为后续配置做准备。

4.2 飞书应用：添加机器人能力

1. 在应用管理页左侧导航栏，点击「添加应用能力」；
2. 在弹出的能力列表中，选择「机器人」，点击「添加」；
3. 机器人能力添加后，方可实现飞书与 OpenClaw 的消息交互。

4.3 飞书应用：获取核心凭证（App ID & App Secret）

1. 在应用管理页左侧导航栏，进入「凭证与基础信息」栏目；
2. 找到「App ID」和「App Secret」，分别点击右侧「复制」按钮，妥善保存（后续 OpenClaw 配置需使用）；
3. 该凭证为飞书应用的核心身份信息，避免泄露给外部人员。

4.4 OpenClaw 端：安装飞书插件并添加渠道

4.4.1 安装飞书专属插件

安装完成后，终端将提示「Installed plugin: feishu」，并建议重启 Gateway 加载插件。

4.4.2 交互式添加飞书渠道

执行渠道添加命令，按照终端提示逐步完成配置，全程选择对应选项即可：

配置步骤指引：

1. 提示「Configure chat channels now?」，选择「Yes」；
2. 渠道列表中，选择「Feishu/Lark (飞书)(needs app creds)」；
3. 输入步骤 4.3 获取的「Feishu App ID」和「Feishu App Secret」；
4. 飞书域名选择：「Feishu (feishu.cn) – China」（国内版飞书）；
5. 群聊策略选择：根据需求选择（推荐测试阶段选「Disabled – don't respond in groups」，仅开启单聊）；
6. 后续提示「Configure DM access policies now?」「Add display names for these accounts?」，均选择「No」（后续按需配置）；
7. 最后选择「Finished (Done)」，完成飞书渠道添加。

4.5 飞书应用：事件配置与权限配置

飞书应用需完成事件订阅与权限开通，才能实现消息接收与发送，配置后需发布应用使设置生效。

4.5.1 事件配置：订阅「接收消息」事件

1. 应用管理页左侧导航栏，进入「事件与回调」栏目；
2. 订阅方式选择「使用长连接接收事件」（推荐，无需公网域名），点击「保存」；
3. 点击「添加事件」，选择「消息与群组」分类，勾选「接收消息 v2.0」，点击「确定」完成订阅；
4. 事件订阅后，飞书将在用户发送消息时，向 OpenClaw 推送事件信息。

4.5.2 权限配置：批量导入所需权限

OpenClaw 飞书机器人需开通消息、群聊、用户基础信息等权限，通过批量导入快速配置，避免手动逐个添加：

1. 应用管理页左侧导航栏，进入「权限管理」栏目；
2. 点击「批量 / 导入权限」，在弹出的窗口中，输入以下 JSON 配置，点击「下一步」；

3. 确认新增权限列表，点击「确定」完成权限申请（企业自建应用通常免审，直接开通）。

4.6 飞书应用：发布版本使配置生效

1. 应用管理页左侧导航栏，进入「版本管理与发布」栏目；
2. 点击「创建版本」，填写版本信息（版本号如「1.0.0」，更新说明如「OpenClaw 飞书机器人初始版本」）；
3. 点击「保存并发布」，企业自建应用发布后立即生效，无需等待审核；
4. 发布完成后，飞书应用的所有配置（机器人能力、事件、权限）将正式启用。

4.7 OpenClaw 端：重启网关并验证飞书渠道

4.7.1 重启 Gateway 服务

加载飞书插件与渠道配置，确保飞书与 OpenClaw 通信正常：

4.7.2 飞书端功能验证

1. 打开企业飞书 App，进入「工作台」，找到已发布的 OpenClaw 应用；
2. 点击应用进入单聊界面，发送测试消息（如「你好」）；
3. 若收到 OpenClaw 的回复，即表示飞书渠道集成成功；
4. 若需开启群聊交互，可返回 OpenClaw 重新配置群聊策略，或在飞书应用中调整权限。

5.1 服务管理

5.2 模型管理

5.3 对话交互

5.4 配置管理

6.1 DeepSeek API 相关问题

问题 1：Gateway Token 错误，提示「unauthorized: gateway token missing」

解决方法：通过命令打开带 Token 的 Web 控制面板，自动携带有效 Token：

或手动获取 Token：

问题 2：提示「Unknown model: xxx」，模型不可用

解决方法：

1. 检查模型配置是否正确：
2. 确认模型 ID 无误：
3. 重启 Gateway 服务：

问题 3：提示「HTTP 401/Unauthorized」，API Key 无效

解决方法：

1. 验证 DeepSeek 平台的 API Key 是否正确、未过期；
2. 重新配置 API Key 并重启服务：

问题 4：提示「Request timed out/No reply from agent」，连接超时

解决方法：

1. 检查网络是否能正常访问 DeepSeek API：
2. 增加消息超时时间：

6.2 飞书渠道相关问题

问题 1：飞书连接测试失败，提示「Cannot destructure property 'tenant_access_token'」

解决方法：

1. 检查 App ID 与 App Secret 是否输入正确，无空格 / 拼写错误；
2. 确认飞书应用已发布，未发布应用无法获取 tenant_access_token；
3. 重启 OpenClaw Gateway 服务后重新测试。

问题 2：飞书发送消息无回复，无任何日志提示

解决方法：

1. 检查飞书应用是否已订阅「接收消息」事件，且订阅方式为「长连接」；
2. 确认飞书应用已开通「im:message.p2p_msg:readonly」「im:message:send_as_bot」等核心权限；
3. 查看 OpenClaw 实时日志，定位问题：

问题 3：Gateway 无法启动，提示「port 18789 is already in use」

解决方法：

1. 查找端口占用进程并关闭：
2. 强制重启 Gateway 服务：
3. 或更换端口启动：

6.3 通用问题：Gateway 服务启动失败

解决方法：

1. 运行基础诊断：
2. 运行深度诊断并自动修复：
3. 检查 Node.js 版本是否为 22+：，版本过低则升级。

7.1 配置模型自动降级

设置备用模型，当主模型（如 deepseek-chat）不可用时，自动切换到备用模型（如 deepseek-reasoner），提升服务可用性：

7.2 配置环境变量

将常用密钥配置到系统环境变量，避免重复输入，编辑 （macOS/Linux）或 （Linux），添加以下内容：

添加完成后，重新加载配置使环境变量生效：

7.3 自定义工作空间路径

修改 OpenClaw 默认工作空间，将数据、日志等文件存储到自定义路径：

1. OpenClaw 官方文档：docs.openclaw.ai/
2. DeepSeek 官方平台：platform.deepseek.com/
3. DeepSeek API 文档：platform.deepseek.com/api-docs/
4. 飞书开放平台：open.feishu.cn/
5. 飞书开放平台开发文档：open.feishu.cn/document/