手把手教你搭建自己的 AI 助手:OpenClaw + DeepSeek + 飞书
开源框架 OpenClaw 允许用户在本地搭建 AI 网关,通过统一接口接入多种大模型与通讯渠道。本文将梳理利用 OpenClaw 接入 DeepSeek 模型并打通飞书机器人的全流程,构建一个完全可控的私人 AI 助手。该方案的核心优势在于数据本地化处理、多模型统一管理以及通过插件扩展功能能力,适合具备基础终端操作能力的开发者与技术爱好者。
01环境准备与框架安装
部署前需准备好 Linux/macOS/Windows (WSL2) 运行环境、Node.js (v18及以上) 以及 DeepSeek API Key 和飞书开发者账号。安装过程主要通过 npm 进行全局安装,安装后需验证版本以确保环境正常。
- 检查 Node.js 环境
在终端运行 `node --version`,确保版本 ≥ 18。推荐使用 v22.22.0。 - 全局安装 OpenClaw
执行命令 `npm install -g openclaw` 进行安装。 - 验证安装结果
运行 `openclaw --version`,若显示版本号(如 2026.4.25)即代表安装成功。
02接入 DeepSeek 大模型
OpenClaw 本身不提供模型能力,需通过配置文件接入第三方大模型。接入 DeepSeek 需获取 API Key,并在配置文件中定义提供商(Provider)与具体的模型(Model)参数。
- 获取 API Key
访问 DeepSeek 开放平台,创建并复制 API Key。 - 配置提供商
编辑 `~/.openclaw/openclaw.json`,在 providers 字段添加 DeepSeek 配置,type 设为 `openai-completions`,baseURL 设为 `https://api.deepseek.com`,并填入 apiKey。 - 添加模型定义
在 models 字段添加所需模型,如 `deepseek-v4-pro`(高能力)或 `deepseek-v4-flash`(高性价比),并设置 contextWindow 等参数。 - 验证配置
运行 `openclaw models list --provider deepseek`,若列出模型则说明接入成功。
| 模型名称 | 特点 | 适用场景 | 上下文长度 |
|---|---|---|---|
| deepseek-v4-pro | 能力最强,费用较高 | 复杂任务处理 | 1,000,000 |
| deepseek-v4-flash | 轻量快速,性价比高 | 日常对话 | 1,000,000 |
| deepseek-chat | V3.2 非思考模式 | 常规问答 | 131,072 |
| deepseek-reasoner | V3.2 推理模式 | 深度思考问题 | 131,072 |
DeepSeek 模型选型参考
03配置飞书渠道
飞书渠道配置需在飞书开放平台创建自建应用,获取凭证并设置权限。连接模式推荐使用 WebSocket 长连接,无需公网 IP 且延迟更低。配置完成后,需在 OpenClaw 中启用该渠道并设置权限策略。
- 创建应用与获取凭证
在飞书开放平台创建企业自建应用,记录 App ID 和 App Secret。 - 配置权限与事件
开通 `im:message`、`im:message:send_as_bot` 等权限;在事件订阅中启用长连接模式,并订阅 `im.message.receive_v1` 事件。 - OpenClaw 渠道对接
运行 `openclaw channels login --channel feishu` 扫码授权,或手动在配置文件 channels 字段添加 appId、appSecret 及 connectionMode 为 websocket。 - 设置权限策略
建议将 dmPolicy 设为 allowlist(白名单模式),并在 allowFrom 中填入用户 open_id 以确保安全性。
04启动测试与进阶配置
完成所有配置后,启动 OpenClaw Gateway 进程以连接模型与渠道。通过 Web 控制台或终端命令可监控运行状态。测试通过后,可进一步调整默认模型、安装功能插件或接入其他大模型服务。
- 启动服务
执行 `openclaw gateway start`,随后运行 `openclaw gateway status` 确认状态为 running。 - 功能测试
在飞书私聊窗口发送消息,验证机器人是否能正常回复。 - 插件扩展
通过 Skill 系统安装天气查询、日历管理、文档读写等插件,扩展 AI 助手的能力边界。 - 多模型接入
在配置文件中同时添加 OpenAI、Ollama 等其他提供商,实现多模型切换。
部署完成后,若遇到机器人无响应等问题,建议按照以下清单进行排查:检查 Gateway 进程是否处于运行状态;确认飞书渠道已启用且应用已发布最新版本;验证当前用户 ID 是否在配置文件的 allowFrom 白名单中;查看 `/tmp/openclaw/` 目录下的日志文件以获取错误信息。
当前文章无评论,是时候发表评论了