openclaw 安装记录+deepseek模型使用

OpenClaw本地AI开发环境搭建与DeepSeek模型配置指南

想快速在本地搭建一个功能完整的AI智能体开发环境吗？OpenClaw或许就是你要找的利器。今天，我们就来手把手走一遍安装配置流程，特别是如何将默认模型切换为当下热门的DeepSeek，整个过程其实比想象中更直接。

第一步：基础环境准备

首先，得把地基打好。你需要确保系统里已经安装了两个核心工具：

Node.js：请前往官网下载并安装最新版本，这是运行OpenClaw的JavaScript环境基础。

Git：版本管理工具，后续安装和更新都会用到它。

这两个都是开发者的“标配”，装好后，我们就可以进入正题了。

第二步：安装与初始化OpenClaw

基础就绪后，打开你的终端或命令行工具，依次执行以下命令：

npm install -g openclaw@latest
这条命令会通过npm包管理器全局安装最新版的OpenClaw。

openclaw onboard --install-daemon
接着运行初始化向导。安装过程中，向导会提示你选择模型，这里可以先按默认选择Qwen模型完成安装。

一个小提示：如果安装或后续运行中遇到“网关错误”之类的提示，别急着找教程。先试试运行 openclaw doctor 这个内置诊断命令，它经常能自动检测并修复环境或版本问题，非常省心。

第三步：启动服务并测试

安装顺利完成？那么用 openclaw gateway 命令启动核心网关服务吧。服务跑起来之后，新开一个终端窗口，输入 openclaw tui 就能打开一个文本用户界面，直接和AI对话，验证基础功能是否一切正常。

第四步：关键一步：接入DeepSeek模型

默认的Qwen不错，但如果你想换用推理能力强劲、尤其擅长代码的DeepSeek模型，就需要手动配置一下。放心，只是改个配置文件的事儿。

1. 获取API Key
首先，你得去DeepSeek的官方平台（https://platform.deepseek.com/）注册并申请一个API Key。需要注意的是，DeepSeek的API服务是需充值的付费服务，请按需使用。

2. 定位配置文件
OpenClaw的所有配置都存放在一个JSON文件里。在Windows系统上，它的路径是：%USERPROFILE%\.openclaw\openclaw.json。你可以直接用文件管理器打开这个路径，并用文本编辑器（如VS Code、Notepad++）编辑 openclaw.json 文件。

3. 配置DeepSeek连接信息
在配置文件中，找到或添加一个名为 "deepseek" 的配置节点。将内容修改为如下格式，记得把 "自己的key" 替换成你刚从平台申请的那一串字符：

"deepseek": {
  "baseUrl": "https://api.deepseek.com/v1",
  "apiKey": "自己的key",
  "api": "openai-completions",
  "models": [
    { "id": "deepseek-chat", "name": "DeepSeek Chat" },
    { "id": "deepseek-coder", "name": "DeepSeek Coder" }
  ]
}

4. 修改默认调用模型
光添加了模型服务还不够，我们还需要告诉OpenClaw，以后默认就用DeepSeek。在配置文件里找到 "agents" 部分下的 "defaults"，将模型指向我们刚配置的DeepSeek Coder模型：

"agents": {
  "defaults": {
    "model": { "primary": "deepseek/coder-model" }
  }
}

这里将 primary 模型设置为 "deepseek/coder-model"，意味着智能体默认会调用DeepSeek Coder来完成任务。

第五步：重启与验证

配置保存后，需要重启网关服务来加载新的设置。回到运行 openclaw gateway 的终端，按 Ctrl+C 停止它，然后重新运行 openclaw gateway。或者，更方便的方法是直接使用重启命令：openclaw gateway restart。

网关重启后，再次打开 openclaw tui。如果一切配置正确，你现在应该能在模型列表或交互中看到可用的DeepSeek模型选项了。

附：访问Web管理界面

除了TUI，OpenClaw还提供了一个Web图形界面。首次访问时，你需要一个认证Token。这个Token就藏在刚才我们编辑的配置文件里：

配置文件路径：C:\Users\zhaoj\.openclaw\openclaw.json （请将“zhaoj”替换为你的用户名）
配置项位置：找到 gateway.auth.token 字段，后面的字符串就是你的登录凭证。

拿到Token，在浏览器中打开本地网关地址（通常是 http://localhost:3000 或类似），输入Token，就能进入功能更丰富的Web管理界面了。

至此，从安装到切换核心模型的全流程就完成了。整个过程关键在于配置文件的修改，一旦打通，你就能在本地灵活调用不同的大模型能力，为后续的AI应用开发铺平道路。

来源：互联网