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

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

## 一、系统基础要求

OpenClaw 运行需满足以下环境条件，跨平台兼容主流操作系统，核心依赖 Node.js 环境：
1. **Node\.js**：版本 22+（推荐使用 nvm 进行多版本管理，避免依赖冲突）
2. **网络环境**：可正常访问 DeepSeek API（`https://api.deepseek.com`）与飞书开放平台（`https://open.feishu.cn`）
3. **权限要求**：本地部署需拥有终端 / 命令行的管理员 / 超级用户权限，飞书集成需企业飞书管理员权限（用于应用创建与权限审批）

## 二、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 官方平台](https://platform.deepseek.com/)，完成注册与账号验证；

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: deepseekdeepseek-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. 访问 [飞书开放平台](https://open.feishu.cn/app?lang=zh-CN)，使用企业飞书账号登录；

2. 点击「创建企业自建应用」，填写应用基础信息，点击「创建」：

    - 应用名称：自定义（如「OpenClaw 智能助手」）

    - 应用描述：简要说明应用用途（如「OpenClaw 飞书智能交互机器人」）

    - 应用图标：任意上传（要求 SVG/BMP/PNG/JPEG 格式，2MB 以内，分辨率≥240\*240px）；

3. 应用创建成功后，进入应用管理后台，为后续配置做准备。

### 4\.2 飞书应用：添加机器人能力

1. 在应用管理页左侧导航栏，点击「添加应用能力」；

2. 在弹出的能力列表中，选择「机器人」，点击「添加」；

3. 机器人能力添加后，方可实现飞书与 OpenClaw 的消息交互。

### 4\.3 飞书应用：获取核心凭证（App ID \&amp; 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](https://feishu.cn)) - China」（国内版飞书）；

5. 群聊策略选择：根据需求选择（推荐测试阶段选「Disabled \- don\&\#39;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": []
  }
}
```

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

### 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 '测试' --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 官方文档**：[https://docs\.openclaw\.ai/](https://docs.openclaw.ai/)

2. **DeepSeek 官方平台**：[https://platform\.deepseek\.com/](https://platform.deepseek.com/)

3. **DeepSeek API 文档**：[https://platform\.deepseek\.com/api\-docs/](https://platform.deepseek.com/api-docs/)

4. **飞书开放平台**：[https://open\.feishu\.cn/](https://open.feishu.cn/)

5. **飞书开放平台开发文档**：[https://open\.feishu\.cn/document/](https://open.feishu.cn/document/)

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

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

后台开发

开发工具

后端

OpenClaw2026.x版本配置指南，详解DeepSeekAPI接入与飞书渠道集成全流程。包含环境准备、Node.js22+安装、APIKey配置、飞书应用创建、机器人能力添加、事件订阅及权限设置。提供命令行操作步骤、常见问题解决方案及高级配置选项，实现OpenClaw与飞书的无缝智能交互。

文件存储

应用管理

Windows

Linux

JSON

2026新春采购季

domain

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

OpenClaw 配置指南：DeepSeek 与 飞书 集成-腾讯云开发者社区-腾讯云

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

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

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐

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

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

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐

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

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