OpenClaw 接入 DeepSeek 配置笔记(Windows 10 )

一、 环境准备

在开始之前,请确保你的电脑已安装以下基础环境:

  1. Node.js : 建议版本 v20.x 或 v22.x 以上(官网下载)。
  2. DeepSeek API Key : 从 DeepSeek 开放平台 获取(格式为 sk-xxxx)。

二、 安装 OpenClaw

方式 A:源码运行(推荐,如你当前的目录结构)

如果你已经下载了源码压缩包并解压到 D:\soft\openclaw-2026.3.13-1:

  1. 打开 PowerShell 或 CMD,进入该目录:

    powershell 复制代码
    cd D:\soft\openclaw-2026.3.13-1
  2. 安装依赖库:

    powershell 复制代码
    npm install

方式 B:全局安装(更简便)

如果你希望在任何地方都能直接使用 openclaw 命令:

powershell 复制代码
npm install -g openclaw@latest

三、 配置 DeepSeek 接入

使用交互式引导命令进行配置。如果你是源码运行,请使用以下前缀:

1. 启动配置引导

powershell 复制代码
node scripts/run-node.mjs onboard

2. 填写配置信息

按照提示依次输入/选择:

  • Select a model provider : 选择 Custom Provider 或 OpenAI(我选的Custom Provider)。
  • API Base URL : 输入 https://api.deepseek.com/v1
  • API Key : 粘贴你的 DeepSeek 密钥 (sk-xxxx)。
  • Endpoint compatibility : 选择 OpenAI-compatible。
  • Model ID : 输入 deepseek-chat (对话模型) 或 deepseek-reasoner (R1思考模型)。
  • Verification : 显示 Verification successful 表示连接成功。
  • Endpoint ID : 记录下生成的 ID(例如:custom-api-deepseek-com)。

四、 设置 DeepSeek 为默认模型

为了让 OpenClaw 启动后默认使用 DeepSeek,执行以下命令:

powershell 复制代码
node scripts/run-node.mjs config set agents.defaults.model.primary "custom-api-deepseek-com/deepseek-chat"

在这里插入图片描述](https://i-blog.csdnimg.cn/direct/ee10e3feb8b44fb8bfda539ef15412ef.png)


五、 启动与运行

使用以下命令启动 OpenClaw 网关:

powershell 复制代码
node scripts/run-node.mjs gateway --allow-unconfigured
  • 访问地址 : 启动成功后,通常可以在浏览器访问 http://localhost:18789 进入管理后台或聊天界面。

六、 配置文件管理(手动修改)

如果你需要手动更换 API Key 或调整参数,配置文件位于 Windows 的用户目录下:

  • 文件路径 : C:\Users\你的用户名\.openclaw\openclaw.json
  • 修改方法 :
    1. 使用记事本或 VS Code 打开 openclaw.json。
    2. 找到 "providers" 下的 apiKey 字段进行修改。
    3. 保存后重启 OpenClaw 程序。

七、 常见问题排查 (Windows 10)

  1. 命令无效 : 如果提示 'openclaw' 不是内部或外部命令,请务必在命令前加上 node scripts/run-node.mjs,或者使用 npm link 将其注册到全局。
  2. 权限报错 : 如果安装过程中报错,请尝试以 管理员身份 运行 PowerShell。
  3. API 泄露 : 重要安全提醒! API Key 属于私密信息,请勿在公开场合(如截图、提问)展示完整的 Key。如果不慎泄露,请立即在 DeepSeek 后台删除并生成新的 Key。
相关推荐
锋行天下24 分钟前
langgraph 全栈项目(三)
前端·人工智能·后端
黄啊码39 分钟前
【黄啊码】最近面了十几个想转 FDE 的程序员,一个都没招
人工智能
琳少_1 小时前
java程序开发笔记
java·开发语言·数据库·笔记
锋行天下1 小时前
langgraph 全栈项目(二)
前端·人工智能·后端
大模型真好玩1 小时前
用 Seedance 2.5 Flash 实现1分钟AI短剧,满足孩子的超级英雄对战梦
人工智能·aigc·deepseek
FengY_HYY2 小时前
从人类组织到人类&大模型组织,我的位置在哪里?
人工智能·程序员·llm
Flynn Liang2 小时前
大模型成本优化:基于 Redis 的可验证语义缓存架构
人工智能·redis·缓存·架构·ai agent·智能体
锋行天下2 小时前
langgraph全栈项目(一)
前端·人工智能·后端
程序员cxuan2 小时前
不得了,Google 造反了,Opus 5.5 又被干了
人工智能·后端·程序员
数字新视界3 小时前
能耗管理系统提升企业能源效率的实践与展望
大数据·人工智能·数据中心·机房管理·模块化机房