什么值得买App下载 App ›
连续签到专享现金活动

手把手教你搭建自己的 AI 助手:OpenClaw + DeepSeek + 飞书

开源框架 OpenClaw 允许用户在本地搭建 AI 网关,通过统一接口接入多种大模型与通讯渠道。本文将梳理利用 OpenClaw 接入 DeepSeek 模型并打通飞书机器人的全流程,构建一个完全可控的私人 AI 助手。该方案的核心优势在于数据本地化处理、多模型统一管理以及通过插件扩展功能能力,适合具备基础终端操作能力的开发者与技术爱好者。
01环境准备与框架安装
部署前需准备好 Linux/macOS/Windows (WSL2) 运行环境、Node.js (v18及以上) 以及 DeepSeek API Key 和飞书开发者账号。安装过程主要通过 npm 进行全局安装,安装后需验证版本以确保环境正常。
  1. 检查 Node.js 环境
    在终端运行 `node --version`,确保版本 ≥ 18。推荐使用 v22.22.0。
  2. 全局安装 OpenClaw
    执行命令 `npm install -g openclaw` 进行安装。
  3. 验证安装结果
    运行 `openclaw --version`,若显示版本号(如 2026.4.25)即代表安装成功。
02接入 DeepSeek 大模型
OpenClaw 本身不提供模型能力,需通过配置文件接入第三方大模型。接入 DeepSeek 需获取 API Key,并在配置文件中定义提供商(Provider)与具体的模型(Model)参数。
  1. 获取 API Key
    访问 DeepSeek 开放平台,创建并复制 API Key。
  2. 配置提供商
    编辑 `~/.openclaw/openclaw.json`,在 providers 字段添加 DeepSeek 配置,type 设为 `openai-completions`,baseURL 设为 `https://api.deepseek.com`,并填入 apiKey。
  3. 添加模型定义
    在 models 字段添加所需模型,如 `deepseek-v4-pro`(高能力)或 `deepseek-v4-flash`(高性价比),并设置 contextWindow 等参数。
  4. 验证配置
    运行 `openclaw models list --provider deepseek`,若列出模型则说明接入成功。
模型名称特点适用场景上下文长度
deepseek-v4-pro能力最强,费用较高复杂任务处理1,000,000
deepseek-v4-flash轻量快速,性价比高日常对话1,000,000
deepseek-chatV3.2 非思考模式常规问答131,072
deepseek-reasonerV3.2 推理模式深度思考问题131,072

DeepSeek 模型选型参考

03配置飞书渠道
飞书渠道配置需在飞书开放平台创建自建应用,获取凭证并设置权限。连接模式推荐使用 WebSocket 长连接,无需公网 IP 且延迟更低。配置完成后,需在 OpenClaw 中启用该渠道并设置权限策略。
  1. 创建应用与获取凭证
    在飞书开放平台创建企业自建应用,记录 App ID 和 App Secret。
  2. 配置权限与事件
    开通 `im:message`、`im:message:send_as_bot` 等权限;在事件订阅中启用长连接模式,并订阅 `im.message.receive_v1` 事件。
  3. OpenClaw 渠道对接
    运行 `openclaw channels login --channel feishu` 扫码授权,或手动在配置文件 channels 字段添加 appId、appSecret 及 connectionMode 为 websocket。
  4. 设置权限策略
    建议将 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/` 目录下的日志文件以获取错误信息。

评论

评论区空态插画

当前文章无评论,是时候发表评论了