Wong Kosheng1. OpenClaw与DeepSeek模型环境搭建全记录
最近在折腾AI开发工具链时，发现OpenClaw这个开源项目挺有意思。它本质上是一个AI智能体开发框架，可以方便地集成各种大语言模型。今天重点记录下如何配置OpenClaw并使用DeepSeek模型的过程，过程中踩了不少坑，也总结了些实用技巧。
先说说为什么选择这个组合：OpenClaw提供了统一的API接口和开发环境，而DeepSeek的代码模型（特别是Coder版本）在编程辅助方面表现优异。两者结合后，可以在本地搭建一个强大的AI编程助手，比单纯使用网页版方便很多。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 基础环境准备
2.1 Node.js安装注意事项
OpenClaw基于Node.js开发，所以需要先安装Node环境。这里有个细节要注意：必须安装最新的LTS版本（当前是20.x），因为某些依赖包可能会在新版中有优化。
bash复制# 在Linux/macOS上可以用nvm管理Node版本
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
nvm install --lts
nvm use --lts
Windows用户可以直接从官网下载安装包。安装完成后，建议运行以下命令检查环境：
bash复制node -v
npm -v
注意：如果之前安装过旧版本，最好先完全卸载。我在Windows上就遇到过版本冲突导致openclaw安装失败的情况。
2.2 Git工具的必要配置
虽然OpenClaw本身不强制依赖Git，但后续管理配置文件和插件时会很有用。安装Git后建议先设置全局用户信息：
bash复制git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"
这步看起来和OpenClaw无关，但实际上当需要修改配置文件或提交变更时，正确的Git配置能避免很多权限问题。
3. OpenClaw核心安装流程
3.1 全局安装与初始化
安装过程比想象中简单，一行命令搞定：
bash复制npm install -g openclaw@latest
安装完成后需要初始化守护进程：
bash复制openclaw onboard --install-daemon
这里有个选择模型的步骤，原始文档推荐选Qwen。不过我们后续会换成DeepSeek，所以这里随便选一个就行。
3.2 常见安装问题排查
如果遇到"网关错误"，先运行诊断命令：
bash复制openclaw doctor
这个命令会自动检测并修复常见问题，比如：
- 缺失的依赖项
- 权限不足的目录
- 网络连接问题
我遇到过一次端口冲突，诊断工具很智能地建议修改了默认端口。
4. DeepSeek模型集成指南
4.1 API密钥申请流程
- 访问DeepSeek开发者平台：https://platform.deepseek.com/
- 注册账号并完成实名认证（需要国内手机号）
- 在控制台创建API密钥
- 充值至少10元（按量计费，代码生成消耗较少）
重要提示：密钥创建后立即复制保存，页面刷新后将无法再次查看完整密钥。
4.2 配置文件深度解析
配置文件路径：%USERPROFILE%\.openclaw\openclaw.json（Windows）或 ~/.openclaw/openclaw.json（Linux/macOS）
需要修改两个关键部分：
json复制"deepseek": {
"baseUrl": "https://api.deepseek.com/v1",
"apiKey": "sk-your-actual-key-here", // 替换为真实密钥
"api": "openai-completions",
"models": [
{ "id": "deepseek-chat", "name": "DeepSeek Chat" },
{ "id": "deepseek-coder", "name": "DeepSeek Coder" }
]
}
以及修改默认模型：
json复制"agents": {
"defaults": {
"model": { "primary": "deepseek/coder-model" }
}
}
4.3 配置热加载技巧
修改配置后不需要完全重启，可以使用：
bash复制openclaw gateway reload
这样能保持现有会话不中断。只有修改模型相关配置时才需要完整重启：
bash复制openclaw gateway restart
5. 客户端使用实战
5.1 终端交互模式(TUI)
启动文本界面：
bash复制openclaw tui
实用快捷键：
- Ctrl+Space：切换会话
- /search：内容搜索
- :model：切换模型
5.2 Web界面访问
- 从配置文件中获取token（gateway.auth.token字段）
- 浏览器访问 http://localhost:7980
- 在登录界面输入token
Web版支持对话历史管理和插件配置，比TUI更适合复杂任务。
6. 高级配置与优化
6.1 多模型并行配置
可以在配置文件中添加多个模型端点：
json复制"models": {
"deepseek": { ... },
"qwen": {
"baseUrl": "http://localhost:11434",
"api": "ollama",
"models": [
{ "id": "qwen:7b", "name": "Qwen-7B" }
]
}
}
然后通过命令快速切换：
bash复制openclaw config set agent.defaults.model.primary=qwen/qwen-model
6.2 网络代理设置
如果遇到连接问题，可以在配置中添加：
json复制"network": {
"proxy": "http://your-proxy:port",
"strictSSL": false
}
7. 常见问题解决方案
7.1 网关启动失败
可能原因及解决：
- 端口冲突：修改
gateway.port配置 - 证书问题：设置
gateway.tls.enabled为false - 权限不足：以管理员身份运行
7.2 模型无响应
检查步骤：
openclaw gateway status查看状态- 测试API连通性：
curl https://api.deepseek.com/v1/models -H "Authorization: Bearer your-key" - 查看日志：
openclaw logs -f
7.3 性能调优建议
- 限制上下文长度：
json复制"agent": {
"context": {
"maxTokens": 4096
}
}
- 启用缓存：
json复制"cache": {
"enabled": true,
"ttl": 3600
}
8. 开发扩展建议
OpenClaw支持插件开发，基本结构：
javascript复制// my-plugin.js
module.exports = {
name: 'My Plugin',
hooks: {
'chat:before': (ctx) => {
// 预处理消息
ctx.message = ctx.message.trim();
}
}
};
然后在配置中加载：
json复制"plugins": ["./my-plugin.js"]
这种扩展方式非常适合定制化需求，比如添加代码格式化、安全检查等预处理功能。
配置完成后，DeepSeek Coder在代码补全和生成方面表现非常出色。特别是在处理Python和JavaScript代码时，能准确理解上下文并给出高质量建议。相比直接使用网页版，本地部署的优势在于：
- 对话历史永久保存
- 可集成到开发环境
- 支持自定义插件扩展
- 保护代码隐私
整个配置过程大概花了1小时（包括申请API密钥的时间），最耗时的部分是调试配置文件格式。建议修改配置时使用VS Code等支持JSON校验的编辑器，避免格式错误导致服务无法启动。