OpenClaw 新手|钉钉 + 飞书 + DeepSeek 一次搞定!

本文基于 OpenClaw 2026.5.6 版本，带你从零配置钉钉、飞书通道，以及主流 AI 模型（以 DeepSeek 为例）。

一句话总结：改一个 JSON 文件，重启，完事。

📚 目录

1. 配置文件在哪里？

2. 配置结构与修改方式

3. 配置飞书渠道

4. 配置钉钉渠道

5. 配置主要模型（DeepSeek）

6. 切换/添加其他模型

7. 常用配置项一览

8. 重启生效

1. 配置文件在哪里？

所有配置统一存放在一个 JSON 文件中：

bash

/root/.openclaw/openclaw.json

⚠️ 重要：每次修改后必须重启 OpenClaw 才能生效（重启方法见第 8 节）。

2. 配置结构与修改方式

你可以通过两种方式修改配置：

方式一：直接编辑 JSON 文件（推荐）

bash

vim /root/.openclaw/openclaw.json

方式二：通过 OpenClaw CLI 修改

bash

# 查看当前配置openclaw config get# 修改配置项（示例：切换主模型）openclaw config set agents.defaults.model.primary deepseek/deepseek-chat

3. 配置飞书渠道

飞书配置位于 channels.feishu，下面是一个典型配置示例：

json

"feishu":{"enabled":true,"appId":"cli##########","appSecret":"############..","connectionMode":"websocket","domain":"feishu","dmPolicy":"pairing","allowFrom":["########"],"groupPolicy":"allowlist"}

🛠️ 新手操作步骤

第一步：在飞书开放平台创建应用

1. 打开 飞书开放平台

2. 创建企业自建应用

3. 获取 App ID 和 App Secret

第二步：配置应用权限

至少添加以下机器人权限：

• im:message — 发送/接收消息

• im:resource — 消息中的图片/文件

• contact:user.base — 读取用户基本信息

第三步：配置订阅方式

WebSocket 模式（推荐）
无需暴露公网地址，适合内网部署。

json

"connectionMode":"websocket"

然后在飞书开放平台 → 事件配置 → 添加 im.message.receive_v1 事件，无需填写回调 URL。

Webhook 模式（需要公网地址）
需在飞书开放平台 → 事件订阅 → 设置回调 URL 指向你的服务器。

第四步：设置 DM 私聊策略

json

"dmPolicy":"pairing"// 只允许配对用户私聊（推荐）"dmPolicy":"open"// 任何飞书用户都可私聊

配对方式：在 allowFrom 列表中填入用户的 open_id（可在飞书开放平台 → 用户管理获取）。

第五步：测试

在飞书中给机器人发一条消息，能正常回复即配置成功 ✅

4. 配置钉钉渠道

钉钉配置位于 channels.dingtalk-connector：

json

"dingtalk-connector":{"enabled":true,"clientId":"#############","clientSecret":"##########","dmPolicy":"pairing","groupReplyMode":"aicard","typingIndicator":true,"resolveSenderNames":true}

🛠️ 新手操作步骤

第一步：在钉钉开放平台创建应用

1. 打开 钉钉开放平台

2. 创建企业内部应用（机器人）

3. 获取 Client ID（原 AppKey）和 Client Secret（原 AppSecret）

第二步：配置机器人

在应用详情 → 机器人与消息推送 → 添加机器人：

• 消息接收模式：WebSocket 模式（OpenClaw 默认使用）

• 权限：勾选 qyapi_robot_sendmsg 和 qyapi_robot_receive_msg

第三步：添加事件订阅

在应用 → 事件与回调：

• 添加 chat_update_org（群聊相关）

• 添加 chat_convert_org

• 添加消息相关事件

第四步：DM 私聊策略

json

"dmPolicy":"pairing"// 钉钉中建议保持 pairing

配对机制：用户首次向机器人发送消息时，OpenClaw 会自动记录并提示。

第五步：群聊回复模式

json

"groupReplyMode":"aicard"// 卡片样式，更美观"groupReplyMode":"text"// 纯文本，更轻量

第六步：测试

在钉钉中给机器人发消息，或群聊中 @机器人 测试 ✅

5. 配置主要模型（DeepSeek）

你当前的配置使用 DeepSeek V4 Flash 作为主模型，下面是完整结构。

5.1 模型供应商配置

json

"models":{"mode":"merge","providers":{"deepseek":{"baseUrl":"https://api.deepseek.com","api":"openai-completions","models":[{"id":"deepseek-v4-flash","name":"DeepSeek V4 Flash"},{"id":"deepseek-v4-pro","name":"DeepSeek V4 Pro"},{"id":"deepseek-chat","name":"DeepSeek Chat"},{"id":"deepseek-reasoner","name":"DeepSeek Reasoner"}]}}}

5.2 API Key 配置

json

"auth":{"profiles":{"deepseek:default":{"provider":"deepseek","mode":"api_key"}}}

API Key 通过环境变量设置：

bash

exportOPENCLAW_AUTH_DEEPSEEK_DEFAULT_KEY="sk-xxxxxxxxxxxxxxxx"

5.3 设置默认主模型

json

"agents":{"defaults":{"model":{"primary":"deepseek/deepseek-v4-flash"}}}

🛠️ 新手操作步骤

第一步：申请 API Key

注册 DeepSeek 开发者平台，创建 API Key。

第二步：设置环境变量

bash

exportOPENCLAW_AUTH_DEEPSEEK_DEFAULT_KEY="sk-你的真实Key"# 永久生效（写入 bash 配置文件）echo'export OPENCLAW_AUTH_DEEPSEEK_DEFAULT_KEY="sk-你的真实Key"'>> ~/.bashrcsource ~/.bashrc

第三步：选择主模型

修改配置中的 primary 字段，可选模型如下：

模型 ID	名称	上下文	特点	费用（$/M tokens）
deepseek-v4-flash	DeepSeek V4 Flash	100万	⚡ 快速经济	输入 0.14/输出0.14/输出0.28
deepseek-v4-pro	DeepSeek V4 Pro	100万	🚀 最强推理	输入 1.74/输出1.74/输出3.48
deepseek-chat	DeepSeek Chat	13万	通用对话	输入 0.28/输出0.28/输出0.42
deepseek-reasoner	DeepSeek Reasoner	13万	🧠 深度思考	输入 0.28/输出0.28/输出0.42

6. 切换/添加其他模型

6.1 添加 OpenAI 兼容的模型（如通义千问、智谱、Claude 等）

在 models.providers 中新增一个供应商：

json

"openai":{"baseUrl":"https://api.openai.com/v1","api":"openai-completions","models":[{"id":"gpt-4o","name":"GPT-4o","input":["text"],"contextWindow":128000,"maxTokens":16384,"compat":{"supportsUsageInStreaming":true,"maxTokensField":"max_tokens"},"api":"openai-completions"}]}

同时添加认证配置：

json

"auth":{"profiles":{"openai:default":{"provider":"openai","mode":"api_key"}}}

对应的环境变量：export OPENCLAW_AUTH_OPENAI_DEFAULT_KEY="sk-xxx"

6.2 切换主模型

json

"agents":{"defaults":{"model":{"primary":"openai/gpt-4o"}}}

7. 常用配置项一览

Agent 行为配置

json

"agents":{"defaults":{"thinkingDefault":"off",// 是否默认开启思考模式 on/off"reasoningDefault":"off",// 是否默认开启推理模式 on/off"bootstrapMaxChars":8000,"contextPruning":{"mode":"cache-ttl","ttl":"6h","keepLastAssistants":5}}}

Gateway 配置

json

"gateway":{"port":18789,"mode":"local",// local / remote"bind":"loopback",// loopback / lan"auth":{"mode":"token"// none / token / password}}

会话与记忆

json

"session":{"dmScope":"per-channel-peer","maintenance":{"maxEntries":200,"maxDiskBytes":"100mb"}}

---

8. 重启生效

修改配置文件后，必须重启 OpenClaw：

bash

# 重启 Gatewayopenclaw gateway restart# 或使用 systemdsystemctl --user restart openclaw-gateway

如果只改了 channel 配置，也可以单独重启对应通道：

bash

openclaw statusopenclaw gateway restart

💡 提示：修改后如果通道连接失败，运行 openclaw status --deep 查看详细错误信息。

📌 快速对照表（改哪里？）

你想做什么	改哪里
启用/禁用飞书	channels.feishu.enabled
启用/禁用钉钉	channels.dingtalk-connector.enabled
更换飞书 AppId	channels.feishu.appId
更换钉钉 ClientId	channels.dingtalk-connector.clientId
换主模型	agents.defaults.model.primary
切换 DeepSeek 模型	模型 ID 改为 deepseek-v4-pro / deepseek-chat 等
关闭思考模式	agents.defaults.thinkingDefault  → "off"
启用浏览器	browser.enabled  → true
配置 API Key	设置环境变量 OPENCLAW_AUTH_xxx_KEY

---

🎉 结尾

恭喜你！现在你已经掌握了 OpenClaw 的飞书、钉钉通道配置以及模型切换方法。
如果遇到问题，记得用 openclaw status --deep 查看详细日志，或者在评论区留言～

喜欢这篇教程的话，点个赞 👍 并分享给需要的朋友吧！
我会持续输出更多实用的 AI + 机器人开发干货。下期见！

本文档基于 OpenClaw 2026.5.6 版本编写，配置项如有变动请参考官方文档。