从零搭建你的专属 AI 助手，让 DeepSeek 成为 OpenClaw 的最强大脑

一、为什么是 OpenClaw + DeepSeek？

OpenClaw（180k+ GitHub Star）是目前最火的开源自建 AI 助手框架，支持全平台部署、多模型切换、自定义技能节点，还能对接飞书、Telegram、Web 等渠道。

DeepSeek 则是国产大模型中的性价比之王——API 价格低至千 token 几分钱，推理能力（R1 系列）甚至可以对标顶级闭源模型。

两者结合 = 自建 AI 助手里最香的方案之一。

而且！OpenClaw 本身已经内置了 DeepSeek 的配置通道，你只需要填个 API Key 就能用，完全不需要写代码。

---

二、前置准备

在开始之前，确保你已经：

项目	要求
OpenClaw	已安装 Gateway（推荐最新稳定版或 beta）
Node.js	≥ 20（推荐 20 LTS 或 22.x）
网络	稳定访问 GitHub / API 服务
可选	独立显卡（本地部署时需要）

# 安装 OpenClaw（如果还没装）
npm install -g openclaw

# 检查版本
openclaw --version

---

三、方法一：DeepSeek 官方 API（最快、最稳、最推荐）

3.1 获取 API Key

1. 打开 DeepSeek 平台 注册/登录
2. 左侧菜单 → API Keys → 创建新密钥
3. 复制 sk- 开头的 Key

3.2 配置到 OpenClaw

编辑配置文件（路径：~/.openclaw/openclaw.json）：

{
  "models": {
    "providers": {
      "deepseek": {
        "baseUrl": "https://api.deepseek.com",
        "api": "openai-completions",
        "apiKey": "sk-你的D…-Key"
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "deepseek/deepseek-reasoner",
        "fallbacks": [
          "deepseek/deepseek-chat"
        ]
      }
    }
  }
}

💡 小技巧：也可以把 API Key 放环境变量 DEEPSEEK_API_KEY 里，更安全。

3.3 DeepSeek 系列模型怎么选？

模型 ID	类型	最适合
deepseek-reasoner	推理模型（R1）	复杂推理、数学、逻辑题
deepseek-chat	对话模型	日常聊天、内容创作
deepseek-coder	代码模型	编程、Debug、代码生成

3.4 重启并验证

openclaw gateway restart

然后在聊天窗口试试：

👉 “帮我用 Python 写一个爬虫，抓取网页标题”

如果正常回复，恭喜你，DeepSeek 已经成功接入了！

⚠️ 常见排错：

• fetch failed → 检查网络/代理，baseUrl 是否正确
• 401 unauthorized → API Key 填错了
• model not found → 模型名必须是 provider/模型id 格式

---

四、方法二：本地 Ollama 私有化部署

不想用云端？想完全本地跑？没问题，用 Ollama 就行。

4.1 安装 Ollama

官网下载：https://ollama.com/（全平台一键安装）

4.2 拉取 DeepSeek 模型

# 新手推荐：1.5B 入门级
ollama pull deepseek-r1:1.5b

# 进阶：8B 蒸馏版 R1
ollama pull deepseek-r1:8b

# 编程专用
ollama pull deepseek-coder:6.7b-instruct-q5_K_M

# 验证模型
ollama run deepseek-r1:8b
>>> 你好，介绍一下自己

4.3 配置 OpenClaw 连接 Ollama

{
  "models": {
    "providers": {
      "ollama": {
        "baseUrl": "http://127.0.0.1:11434/v1",
        "api": "openai-completions"
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "ollama/deepseek-r1:8b",
        "fallbacks": ["ollama/deepseek-coder:latest"]
      }
    }
  }
}

💡 如果 Ollama 跑在另一台机器，把 127.0.0.1 换成对应的 IP 地址即可。

---

五、进阶玩法：让 AI 真正「干活」🔥

装好了只是第一步，怎么玩才是精髓。下面这些玩法让你的 OpenClaw + DeepSeek 组合真正值回票价。

5.1 多模型自由切换

在聊天框里随时切换模型：

/model deepseek/deepseek-reasoner

👉 问复杂推理题时切到 R1
👉 写代码时切到 Coder
👉 日常聊天用 Chat，省钱

5.2 接入 Telegram 移动端

让 DeepSeek 在手机上陪你聊天：

1. 在 OpenClaw 配置 Telegram Bot
2. 设置默认模型为 deepseek/deepseek-reasoner
3. 随时随地用手机问问题

5.3 飞书集成（国内办公神器）

把 OpenClaw 接到飞书里，让 DeepSeek 成为你的 24h 在线助理：

• 自动处理文档
• 群聊智能回复
• 日程管理提醒

5.4 自定义 Skills 扩展能力

这是 OpenClaw 最强大的功能之一——给它写技能！

# 自定义 Skill 示例：让 DeepSeek 自动分析数据
def analyze_data(file_path):
    """读取 CSV 文件并让 AI 分析数据趋势"""
    import pandas as pd
    df = pd.read_csv(file_path)
    return df.describe().to_dict()

把技能注册到 OpenClaw，DeepSeek 就会在需要的时候自动调用它。

5.5 配置知识库（RAG）

让 DeepSeek 基于你自己的知识库回答问题：

• 上传产品文档、技术手册
• AI 基于文档内容回答
• 再也不怕 AI 胡说八道

5.6 Agent 模式：让 AI 替你干活

OpenClaw 支持 Agent 模式，DeepSeek 可以：

• ✅ 帮你写代码并自动测试
• ✅ 操作浏览器自动化
• ✅ 读取和处理本地文件
• ✅ 调用命令行工具
• ✅ 访问网络 API

---

六、性能调优建议

6.1 云端 API 用户

技巧	效果
开启缓存读取	降低 80% 的重复调用成本
设置 fallback 模型	主模型失败自动降级
用 deepseek-reasoner 做主力	性价比最优

6.2 本地部署用户

配置	建议
显存 8-12GB	deepseek-r1:7b 量化版
显存 16-24GB	deepseek-coder:16b 或 deepseek-r1:14b
显存 24GB+	可以尝试更大参数版本

---

七、避坑指南 🚧

❌ 问题 1：Ollama API error 400 - “does not support tools”

原因：某些蒸馏版 DeepSeek 模型不支持工具调用。

解决：换用支持 tool calling 的模型，或者在 OpenClaw 配置中关闭 tool use：

{
  "agents": {
    "defaults": {
      "tools": {
        "enabled": false
      }
    }
  }
}

❌ 问题 2：OpenClaw 配置了模型但找不到

原因：OpenClaw 的模型配置有缓存机制，改了配置需要重启。

解决：

openclaw gateway restart
openclaw gateway status  # 确认新配置生效

❌ 问题 3：API 调用返回乱码

原因：编码问题或 baseUrl 写错了。

解决：确保 baseUrl 结尾没有多余的 /v1/，DeepSeek 的标准地址是：

https://api.deepseek.com  ✅
https://api.deepseek.com/v1  ✅

---

八、总结

OpenClaw + DeepSeek 的组合优势一目了然：

维度	优势
💰 成本	API 极便宜，本地部署零成本
🚀 性能	R1 推理能力强，代码能力天花板
🔧 可玩性	多模型切换、Skills、Agent、飞书集成
🔒 隐私	本地 Ollama 部署，数据完全私有

从基础的 API 配置，到 Ollama 本地私有化部署，再到进阶的 Skills 和 Agent 玩法——这套组合拳打下来，你的 AI 助手已经从一个「聊天机器人」升级成了真正的「智能工作流引擎」。