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

程序员Leo2026-03-15 14:50

OpenClaw 配置指南：DeepSeek API 接入 + 飞书渠道集成

本文整合 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（https://api\.deepseek\.com）与飞书开放平台（https://open\.feishu\.cn）

  4. 权限要求：本地部署需拥有终端 / 命令行的管理员 / 超级用户权限，飞书集成需企业飞书管理员权限（用于应用创建与权限审批）

二、OpenClaw 基础安装与初始化

2.1 全局安装 OpenClaw

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

bash 复制代码 
npm install -g openclaw@latest

2.2 验证安装结果

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

bash 复制代码 
openclaw --version

2.3 初始化配置向导

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

bash 复制代码 
openclaw onboard --install-daemon --non-interactive --accept-risk

2.4 检查服务状态

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

bash 复制代码 
openclaw status

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

三、DeepSeek 官方 API 配置流程

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

3.1 获取 DeepSeek API Key

  1. 访问 DeepSeek 官方平台，完成注册与账号验证；

  2. 进入平台「API 密钥」模块，创建并获取 API Key，格式为 sk\-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx；

  3. 妥善保存 API Key，避免泄露（后续配置需直接使用）。

3.2 配置 DeepSeek 模型提供商

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

bash 复制代码 
openclaw config set models.providers.deepseek '{
  "baseUrl": "https://api.deepseek.com/v1",
  "apiKey": "你的API_KEY",
  "api": "openai-completions",
  "models": [
    {
      "id": "deepseek-chat",
      "name": "DeepSeek Chat (V3)"
    },
    {
      "id": "deepseek-reasoner",
      "name": "DeepSeek Reasoner (R1)"
    }
  ]
}'

3.3 设置默认交互模型

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

bash 复制代码 
openclaw config set agents.defaults.model.primary "deepseek/deepseek-chat"

3.4 创建模型别名（可选）

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

bash 复制代码 
openclaw models aliases add deepseek-v3 "deepseek/deepseek-chat"
openclaw models aliases add deepseek-r1 "deepseek/deepseek-reasoner"

3.5 重启 Gateway 服务使配置生效

bash 复制代码 
openclaw gateway restart

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

3.6 DeepSeek 配置测试与验证

3.6.1 命令行快速测试

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

bash 复制代码 
openclaw agent --session-id test --message "你好，请介绍一下你自己"
3.6.2 查看模型配置状态

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

bash 复制代码 
openclaw models status

预期结果 ：显示 Default: deepseek/deepseek\-chat，且配置模型列表包含 deepseek 相关模型。

3.6.3 打开 Web 控制面板

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

bash 复制代码 
openclaw dashboard

面板访问 URL 格式：http://127\.0\.0\.1:18789/\#token=你的gateway\_token

四、飞书（Lark）渠道集成配置

完成 DeepSeek 模型配置后，集成飞书渠道实现 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 安装飞书专属插件
bash 复制代码 
openclaw plugins install @m1heng-clawd/feishu

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

4.4.2 交互式添加飞书渠道

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

bash 复制代码 
openclaw channels add

配置步骤指引：

  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 配置，点击「下一步」；

json 复制代码 
{
  "scopes": {
    "tenant": [
      "contact:user.base:readonly",
      "im:chat",
      "im:chat:read",
      "im:chat:update",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message:send_as_bot",
      "im:resource",
      "contact:contact.base:readonly"
    ],
    "user": []
  }
}
  1. 确认新增权限列表，点击「确定」完成权限申请（企业自建应用通常免审，直接开通）。

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

  1. 应用管理页左侧导航栏，进入「版本管理与发布」栏目；

  2. 点击「创建版本」，填写版本信息（版本号如「1.0.0」，更新说明如「OpenClaw 飞书机器人初始版本」）；

  3. 点击「保存并发布」，企业自建应用发布后立即生效，无需等待审核；

  4. 发布完成后，飞书应用的所有配置（机器人能力、事件、权限）将正式启用。

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

4.7.1 重启 Gateway 服务

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

bash 复制代码 
openclaw gateway stop
openclaw gateway
4.7.2 飞书端功能验证

  1. 打开企业飞书 App，进入「工作台」，找到已发布的 OpenClaw 应用；

  2. 点击应用进入单聊界面，发送测试消息（如「你好」）；

  3. 若收到 OpenClaw 的回复，即表示飞书渠道集成成功；

  4. 若需开启群聊交互，可返回 OpenClaw 重新配置群聊策略，或在飞书应用中调整权限。

五、OpenClaw 常用管理命令

5.1 服务管理

bash 复制代码 
# 启动 Gateway 服务
openclaw gateway
# 重启 Gateway 服务
openclaw gateway restart
# 停止 Gateway 服务
openclaw gateway stop
# 查看基础服务状态
openclaw status
# 查看详细服务状态
openclaw status --all
# 查看实时运行日志
openclaw logs --follow

5.2 模型管理

bash 复制代码 
# 列出所有可用模型
openclaw models list --all
# 查看当前模型配置状态
openclaw models status
# 聊天中快速切换模型（终端/飞书均可）
/model 模型别名（如 deepseek-v3）
# 重新设置默认模型
openclaw config set agents.defaults.model.primary "模型ID"
# 查看所有模型别名
openclaw models aliases list

5.3 对话交互

bash 复制代码 
# 终端发送单条测试消息
openclaw agent --session-id 会话ID --message "你的问题"
# 指定消息超时时间（单位：秒，示例为60秒）
openclaw agent --session-id test --message "问题" --timeout 60
# 本地模式交互（不通过 Gateway 服务）
openclaw agent --local --session-id test --message "问题"

5.4 配置管理

bash 复制代码 
# 查看指定路径的配置
openclaw config get 配置路径
# 设置指定路径的配置
openclaw config set 配置路径 "值"
# 删除指定路径的配置
openclaw config unset 配置路径
# 重新运行交互式配置向导
openclaw configure

六、常见故障排除

6.1 DeepSeek API 相关问题

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

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

bash 复制代码 
openclaw dashboard

或手动获取 Token：

bash 复制代码 
openclaw config get gateway.auth.token
问题 2：提示「Unknown model: xxx」，模型不可用

解决方法：

  1. 检查模型配置是否正确：openclaw models status

  2. 确认模型 ID 无误：openclaw models list \-\-all \| grep deepseek

  3. 重启 Gateway 服务：openclaw gateway restart

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

解决方法：

  1. 验证 DeepSeek 平台的 API Key 是否正确、未过期；

  2. 重新配置 API Key 并重启服务：

bash 复制代码 
openclaw config set models.providers.deepseek.apiKey "新的API_KEY"
openclaw gateway restart
问题 4：提示「Request timed out/No reply from agent」，连接超时

解决方法：

  1. 检查网络是否能正常访问 DeepSeek API：curl \-I https://api\.deepseek\.com/v1/models

  2. 增加消息超时时间：openclaw agent \-\-session\-id test \-\-message \&\#34;测试\&\#34; \-\-timeout 120

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 实时日志，定位问题：openclaw logs \-\-follow \| grep feishu

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

解决方法：

  1. 查找端口占用进程并关闭：lsof \-i :18789

  2. 强制重启 Gateway 服务：openclaw gateway \-\-force

  3. 或更换端口启动：openclaw gateway \-\-port 18790

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

解决方法：

  1. 运行基础诊断：openclaw doctor

  2. 运行深度诊断并自动修复：openclaw doctor \-\-fix

  3. 检查 Node.js 版本是否为 22+：node \-v，版本过低则升级。

七、高级配置（可选）

7.1 配置模型自动降级

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

bash 复制代码 
openclaw config set agents.defaults.model.fallbacks '["deepseek/deepseek-reasoner"]'

7.2 配置环境变量

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

bash 复制代码 
# DeepSeek API Key
export DEEPSEEK_API_KEY="你的API_KEY"
# OpenClaw Gateway Token
export OPENCLAW_TOKEN="你的gateway_token"
# 飞书应用凭证（可选）
export FEISHU_APP_ID="你的飞书App ID"
export FEISHU_APP_SECRET="你的飞书App Secret"

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

bash 复制代码 
source ~/.zshrc  # macOS/Linux zsh 终端
# 或
source ~/.bashrc  # Linux bash 终端

7.3 自定义工作空间路径

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

bash 复制代码 
openclaw config set agents.defaults.workspace "/自定义/工作空间/路径"

八、相关资源参考

  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/

相关推荐
彭于晏Yan2 小时前
Springboot实现微服务监控
spring boot·后端·微服务
sg_knight2 小时前
OpenClaw 能做什么？几个真实使用场景说明
算法·ai·大模型·llm·agent·openclaw·小龙虾
小江的记录本2 小时前
【Spring Boot—— .yml（YAML）】Spring Boot中.yml文件的基础语法、高级特性、实践技巧
xml·java·spring boot·后端·spring·spring cloud·架构
爱敲代码的小黄2 小时前
Agent 能力模块化：Skill 设计与执行机制解析
人工智能·后端·面试
掘金者阿豪2 小时前
告别SQL性能焦虑：金仓数据库“连接条件下推”的性能魔法
后端
老友@3 小时前
接口调用的演进史——从“发 HTTP 请求”到“可治理的系统能力
spring boot·后端·架构
zzb15803 小时前
RAG from Scratch-优化-routing
java·前端·网络·人工智能·后端·python·mybatis
酱紫学Java3 小时前
数据安全比赛：Python 内置函数实战指南
后端·python·网络安全
xier_ran3 小时前
【第二周】RAG与Agent实战04：OpenAI库附带历史消息调用模型
自然语言处理·agent·rag
热门推荐
01GitHub 镜像站点02Qwen3.5 开源全解析：从 0.8B 到 397B，代际升级 + 全场景选型指南03OpenClaw 使用和管理 MCP 完全指南04本地部署 OpenClaw + DeepSeek-R1 完全指南05OpenClaw macOS 完整安装与本地模型配置教程（实战版）06OpenClaw 飞书机器人不回复消息？3 小时踩坑总结07UV安装并设置国内源08得物前端部门，没了09OpenClaw 接入 QQ Bot 完整实践指南10Openclow安装保姆级教程