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，进入该目录：

   cd D:\soft\openclaw-2026.3.13-1

2. 安装依赖库：

   npm install

方式 B：全局安装（更简便）

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

npm install -g openclaw@latest

---

三、 配置 DeepSeek 接入

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

1. 启动配置引导

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，执行以下命令：

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 网关：

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。