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

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

本指南将指导你完成 OpenClaw 与 DeepSeek 官方 API 及飞书工作平台集成的全流程。基于 OpenClaw 2026.x 版本，内容涵盖从基础环境部署、模型服务对接，到创建飞书应用、配置权限策略，最终在你日常使用的协作工具中实现智能助手调用。

免费影视、动漫、音乐、游戏、小说资源长期稳定更新！ 👉 点此立即查看 👈

一、 硬件与系统要求

在部署 OpenClaw 前，请确保运行环境满足以下先决条件。系统兼容性良好，但 Node.js 版本是关键。

1. Node.js：必须为 22 或更高版本（推荐使用 nvm 等版本管理工具，以规避潜在的依赖冲突问题）。
2. 网络环境：需具备稳定访问 DeepSeek API 服务端点及飞书开放平台的能力。
3. 操作权限：本地运行需要管理员或 root 权限；而配置飞书则需要企业管理员账号来完成应用审核与发布。

二、 OpenClaw 基础安装与初始化

2.1 全局安装 OpenClaw

使用以下命令进行全局安装。此过程将下载约 600 个依赖包，请耐心等待完成。

npm install -g openclaw@latest

2.2 验证安装结果

安装完成后，检查版本号以确认安装成功。终端输出形如 ???? OpenClaw 2026.x.x 的信息即为正常。

openclaw --version

2.3 快速初始化

通过向导模式快速完成基础配置并安装守护进程。此命令将自动确认所有安全协议，无需手动干预。

openclaw onboard --install-daemon --non-interactive --accept-risk

2.4 检查服务状态

确保核心的 Gateway 服务已成功启动，这是后续所有配置生效的基础。

openclaw status

确认 Gateway 状态显示为“正在运行”即可继续。

三、 DeepSeek 官方 API 配置流程

完成 OpenClaw 的基础部署后，下一步是接入 DeepSeek 的模型服务。无论是指令遵循型的 Chat V3 还是推理增强型的 Reasoner R1 模型，均可灵活配置调用。

3.1 获取 DeepSeek API Key

1. 访问 DeepSeek 官方平台并完成账户注册；
2. 进入“API 密钥”管理面板，创建一个新密钥，可自定义名称，格式应为 sk-xxxxxxxx；
3. 复制并安全保管此密钥字符串，后续配置步骤将直接使用。

3.2 接入 DeepSeek 提供商

运行以下命令，请将“你的API_KEY”占位符替换为实际获取的密钥。

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 config set agents.defaults.model.primary "deepseek/deepseek-chat"

3.4 设置快捷别名（效率必备）

为常用模型设置简短的命令别名，可以显著提升在命令行中切换模型的效率。

openclaw models aliases add v3 "deepseek/deepseek-chat"
openclaw models aliases add r1 "deepseek/deepseek-reasoner"

3.5 重启网关使配置生效

openclaw gateway restart

等待数秒，待网关服务重新加载所有配置。

3.6 连通性测试

3.6.1 命令行快速问好

发送一条简单的测试消息，若能收到模型的中文回应，则证明 API 通道已畅通。

openclaw agent --session-id test --message "你好，你是谁？"

3.6.2 查看模型状态

确认默认模型及所有可用模型的列表是否正确加载。

openclaw models status

3.6.3 启动 Web 控制台

若需通过浏览器进行可视化管理和交互，可启动 Web 控制台。

openclaw dashboard

四、 飞书（Lark）渠道集成

模型端配置完成后，接下来将智能助手的能力接入飞书。你需要在飞书开放平台创建应用，随后在 OpenClaw 中完成绑定。

4.1 飞书开发后台创建应用

1. 登录 飞书开放平台；
2. 点击“创建自建应用”，应用名称可设置为“OpenClaw 助手”等易于识别的名称，图标按需上传。

4.2 开通机器人功能

1. 应用创建后，在左侧导航栏找到“添加应用能力”；
2. 选择“机器人”功能，点击添加，此功能是实现消息交互的核心。

4.3 获取 App ID 和 App Secret

1. 进入“凭证与基础信息”页面；
2. 复制并保存 App ID 和 App Secret，这两项是机器人在飞书生态内的身份凭证。

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

4.4.1 安装飞书插件

openclaw plugins install @m1heng-clawd/feishu

4.4.2 交互式配置渠道

运行交互式命令，并依据终端提示逐步完成配置：

openclaw channels add

配置时可参考以下选项：

1. Configure chat channels? 选择 Yes；
2. 从渠道列表中选择 Feishu Lark；
3. 填入先前获取的 App ID 和 App Secret；
4. 域名选择 Feishu - China（国内版）；
5. 群聊策略暂时选择 Disabled，待单聊测试通过后再行开启；
6. 后续关于私聊策略和自定义名称提示的选项均选择 No。

4.5 完成飞书端的事件订阅与权限配置

此步骤对保证机器人能接收和处理用户消息至关重要。

4.5.1 配置事件订阅

1. 在飞书应用后台找到“事件与回调”选项；
2. 订阅方式选择“使用长连接”，点击保存（此方式无需配置公网IP）；
3. 点击“添加事件”，务必勾选“接收消息 v2.0”权限。

4.5.2 一键导入权限

1. 在“权限管理”下找到“批量导入”功能；
2. 将以下 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": []}}

4.6 发布应用

1. 进入“版本管理与发布”；
2. 创建一个新版本（例如 1.0.0），填写更新说明后提交发布；
3. 企业自建应用的审核通常非常迅速。

4.7 最终测试

1. 重启 OpenClaw 网关服务：依次执行 openclaw gateway stop 和 openclaw gateway；
2. 在飞书中搜索你创建的应用，发送一句“在吗”，观察是否能收到智能回复。

五、 管理命令汇总

5.1 服务管控

openclaw gateway # 启动服务
openclaw gateway restart # 重启服务
openclaw gateway stop # 停止服务
openclaw status --all # 查看全部服务状态
openclaw logs --follow # 实时跟踪日志输出

5.2 模型管理

openclaw models list --all # 列出所有可用模型
/model v3 # 在聊天会话中直接切换模型
openclaw models aliases list # 查看已设置的别名

5.3 与机器人交互

openclaw agent --session-id 1 --message "讲个笑话" --timeout 60

六、 常见问题排错指南

6.1 DeepSeek 接口无响应

• Token 报错？ 前往 Web 控制台或执行 openclaw config get gateway.auth.token 检查网关认证令牌。
• 401 权限错误？ 通常是 API Key 填写有误或已过期失效。
• 连接超时？ 使用 curl 命令直接测试 DeepSeek 的 API 端点，以定位本地网络或防火墙问题。

6.2 飞书机器人无反应

• 获取 Token 失败？ 复核 App ID 是否正确，并确保应用已完成发布流程。
• 发消息后无回复？ 检查事件订阅中是否启用了“长连接”，以及权限列表中的“接收消息”是否已授权。

6.3 Gateway 服务启动失败

• 端口被占用？ 可能存在旧进程未完全终止，使用 lsof -i :18789 命令查看并结束占用端口的进程。
• 各类未知错误？ 尝试执行 openclaw doctor --fix 命令，该工具能自动诊断并修复常见的环境问题。

七、 进阶配置技巧

7.1 设置备用回退模型

为应对主模型服务可能存在的间歇性不稳定，可预先配置备用模型作为冗余。

openclaw config set agents.defaults.model.fallbacks '["deepseek/deepseek-reasoner"]'

7.2 使用环境变量管理密钥

为避免在配置文件中泄露敏感信息，可将 API Key 等密钥存储在操作系统的环境变量中（例如 .zshrc 或 .bash_profile）。

export DEEPSEEK_API_KEY="你的Key"

配置后需执行 source 命令使环境变量生效。

7.3 迁移工作空间路径

若需将 OpenClaw 的会话数据、缓存等存储至其他目录，可通过修改工作空间路径实现。

openclaw config set agents.defaults.workspace "/new/path"