一、准备工作
1. 系统与环境要求
- 操作系统：Windows 10 21H2 及以上 / Windows 11
- 硬件：内存 ≥ 4GB（推荐 8GB+），硬盘可用空间 ≥ 1GB
- 网络：需联网下载安装包、调用 DeepSeek-V4-Pro API
2. 提前获取 DeepSeek API Key
- 登录 DeepSeek控制台，进入「密钥管理」页面。
- 点击「创建 API Key」，生成并保存你的 API Key（以 sk- 开头）。
- 注意： 按量付费和 Coding Plan 使用不同的 Base URL 和 API Key，请根据你的订阅类型选择。
二、部署 OpenClaw 环境
1. 安装 Node.js（核心依赖）
OpenClaw 基于 Node.js 开发，需安装 22.x LTS 版本：
- 下载地址：Node.js 官网（选择「Windows 安装包 (.msi)」）；
- 安装时勾选「Add to PATH」（自动添加环境变量，默认已勾选），一路下一步完成安装；
- 验证安装：打开 普通 PowerShell，执行以下命令，显示版本号即成功（node ≥ v22.x，npm ≥ 10.x）：
|
1 2 |
node -v npm -v |
安装完成运行效果：
2. 安装 Git（推荐）
OpenClaw 的某些依赖需要从 Git 仓库拉取，所以需要先安装 Git：
- 下载 Git for Windows：官网下载
- 安装时注意勾选 “Add Git to PATH”（默认已勾选），确保 Git 命令能在 PowerShell 中直接调用。
- 安装完成后，重启管理员PowerShell，执行以下命令验证：
|
1 |
git --version |
安装完成运行效果：
3. 放开 PowerShell 执行权限
默认情况下 PowerShell 限制脚本执行，需以管理员****身份打开 PowerShell，执行：
|
1 |
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force |
提示「执行策略更改」时，输入 Y 确认即可。
4. 安装 OpenClaw
保持管理员 PowerShell 窗口，执行国内加速安装命令（避免下载超时）：
|
1 2 3 4 |
# 配置国内 npm 镜像（可选，加速下载） npm config set registry https://registry.npmmirror.com # 全局安装 OpenClaw 最新版 npm install -g openclaw@latest |
安装完成后，执行 openclaw --version，显示版本号即安装成功。
三、配置 OpenClaw 接入 DeepSeek
1.初始化 OpenClaw
执行初始化向导：
|
1 |
openclaw onboard |
在 PowerShell 中看到这个提示后：
- 直接输入 y（或 yes/Y），按回车键确认；
- 向导会进入下一步配置（选择 AI 提供商、填写 API 信息等）；
- 后续在向导中选择「Custom OpenAI Compatible API」，填入：
- API Key：你的 DeepSeek API Key
- Base URL：https://api.deepseek.com
- Default Model：deepseek-v4-pro
- 简化方案（跳过向导，直接用配置，见下面）
2. 编辑 OpenClaw 配置文件
OpenClaw 的核心配置文件存储在用户目录下，需修改配置对接 DeepSeek：
- 打开文件管理器，在地址栏输入 %USERPROFILE%\.openclaw，回车进入配置目录；
- 找到 settings.json 文件，右键选择「记事本」打开；
- 全选原有内容，替换为以下配置（重点修改 apiKey 为你的 DeepSeek 密钥）：
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 |
{ "autoUpdatesChannel": "latest", "env": { "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic", "ANTHROPIC_AUTH_TOKEN": "你的密钥", "API_TIMEOUT_MS": "3000000", "ANTHROPIC_MODEL": "deepseek-v4-pro", "ANTHROPIC_SMALL_FAST_MODEL": "deepseek-v4-flash", "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro", "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro", "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash", "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-pro", "CLAUDE_CODE_EFFORT_LEVEL": "max" }, "model": "deepseek-v4-pro" } |
- 保存文件并关闭记事本。
3. 停止临时服务（若已启动）
若之前尝试过启动 OpenClaw，先执行停止命令：
|
1 |
openclaw gateway stop |
4. 启动 OpenClaw 服务
在管理员 PowerShell 中执行：
|
1 2 3 4 |
# 启动 openclaw gateway run # 查看服务状态（确认无报错） openclaw status |
启动后，自动打开网页
四、OpenClaw 基础使用教程
1. 进入 OpenClaw 管理面板
打开浏览器（Edge/Chrome 均可），在地址栏输入 http://localhost:18789，回车进入 OpenClaw 主界面。
2. 验证 DeepSeek接入
- 进入「聊天」页面（左侧菜单栏）；
- 在输入框中发送测试消息（如「你好，请介绍一下自己」）；
- 若能收到 DeepSeek 的回复（而非报错），说明接入成功。
3.openClaw功能
OpenClaw 不仅是一个 AI 聊天工具，更是一个集成了多种自动化能力的智能网关。其核心功能模块围绕「人机交互」和「任务自动化」两大核心展开，以下是各模块的详细介绍：
1. 聊天模块（Chat）
这是 OpenClaw 的入口和核心交互界面，提供了与 AI 模型直接对话的能力。
- 核心能力：
- 支持多会话管理，可同时开启多个独立对话上下文。
- 支持文本、图片等多模态输入，满足复杂任务描述需求。
- 可快速切换不同的 AI 模型（如DeepSeek-V4-Pro、DeepSeek 等），灵活应对不同场景。
- 典型应用：
- 日常问题咨询、代码编写、文案创作等直接交互场景。
- 作为其他自动化任务的「大脑」，接收自然语言指令并拆解执行。
2. 定时任务模块（Cron）
这是 OpenClaw 最强大的自动化能力之一，允许你将任何任务设置为定时执行，彻底解放双手。
- 核心能力：
- 提醒类：定时提醒开会、吃药、休息，或在重要日期（生日、纪念日、截止日）发送通知。
- 信息检查：定期检查邮箱新邮件、日历 upcoming 事件、监控网站/服务状态，甚至根据天气提醒带伞。
- 文件/数据：定时备份重要文件、自动整理下载文件夹、清理临时文件、同步数据到云端。
- 自动化：定时发送消息/报告、执行脚本或命令、调用 API 获取数据、生成日报/周报。
- 子代理任务：定时启动子代理处理复杂任务、隔离执行特定工作流、向其他会话发送消息。
- 典型应用：
- 每日自动备份工作文档到云端。
- 每周一生成上周工作周报并发送到指定邮箱。
- 每小时监控服务器状态，异常时立即告警。
3. 控制模块（Control）
该模块提供了对 OpenClaw 网关和底层服务的精细控制能力。
- 核心子模块：
- 概览：查看网关运行状态、连接的 AI 模型、资源占用等关键信息。
- 频道：管理与不同通信渠道（如 Telegram、Web UI）的连接和认证。
- 实例：查看和管理正在运行的 AI 代理实例，可进行启动、停止、重启等操作。
- 会话：管理所有聊天会话，可查看历史、切换上下文或清理无效会话。
- 使用情况：统计 AI 模型的调用次数、Token 消耗等数据，帮助你监控成本和使用频率。
4. 代理模块（Proxy）
该模块让 OpenClaw 成为一个强大的中间层，可对接多种 AI 服务和自定义能力。
- 核心子模块：
- 代理：配置和管理 AI 模型提供商（如DeepSeek-V4-Pro、DeepSeek、OpenAI 等），包括 API 密钥、Base URL、默认模型等。
- 技能：定义和扩展 OpenClaw 的能力，如文件操作、系统命令执行、API 调用等，让 AI 能直接与你的系统交互。
- 节点：管理分布式计算节点，可将任务分发到不同的机器上执行，提升处理能力。
5. 设置模块（Settings）
提供了对 OpenClaw 全局配置的管理入口。
- 核心子模块：
- 配置：编辑核心配置文件 config.json，调整网关模式、认证方式、日志级别等。
- 调试：开启调试模式，查看详细的网络请求和内部日志，用于排查问题。
- 日志：查看和管理历史日志文件，支持实时日志追踪（openclaw logs --follow），是定位错误的关键工具。
五、 OpenClaw 常用命令（适配DeepSeek-V4-Pro/DeepSeek，新手友好版）
1. 核心启动命令（按使用场景分类）
| 命令 | 用途 | 适用场景 | 注意事项 |
|---|---|---|---|
| openclaw gateway run --allow-unconfigured | 前台启动网关（带实时日志） | 本地测试、排查报错 | 关闭窗口则服务停止；解决 gateway.mode 未设置问题 |
| openclaw gateway install | 安装为 Windows 计划任务 | 长期后台运行 | 需先配置 gateway.mode: local |
| openclaw gateway start | 启动后台网关服务 | 长期使用 | 安装后执行，关闭终端不影响 |
| openclaw | 一键启动+自动打开面板 | 快速使用 | 自动加载默认配置 |
2. 停止/重启命令
| 命令 | 用途 | 操作说明 |
|---|---|---|
| Ctrl + C（终端内） | 停止前台运行的服务 | 在执行 gateway run 的窗口按下即可 |
| openclaw gateway stop | 停止后台网关服务 | 需先执行过 gateway install |
| openclaw gateway restart | 重启后台网关 | 适用于修改配置后生效 |
| openclaw gateway uninstall | 卸载后台服务 | 彻底清理 Windows 计划任务 |
3. 配置/排查命令
| 命令 | 用途 | 使用场景 |
|---|---|---|
| openclaw onboard | 重新初始化配置 | 切换模型（DeepSeek-V4-Pro/DeepSeek）、更新 API 密钥 |
| openclaw doctor --fix | 自动修复配置错误 | 配置错乱、模型名/路径错误 |
| openclaw status | 查看服务状态 | 确认网关是否正常监听端口 |
| openclaw logs --follow | 查看实时日志 | 定位报错原因（如模型未知、限流） |
六、总结
- 命令核心：前台测试用 gateway run --allow-unconfigured，长期使用用 install + start，配置错误用 doctor --fix，切换模型用 onboard；
- 模型配置关键：DeepSeek-V4-Pro模型名需去掉 dashscope/ 前缀，DeepSeek 选 Custom OpenAI 并填 https://api.deepseek.com/v1；
- 高频问题解决：限流等 3 分钟、模型名去前缀、额度不足换密钥、授权失败跳过分流；
OpenClaw 的功能模块设计遵循「从简单到复杂」的原则：
- 从聊天模块开始，你可以快速体验 AI 交互。
- 通过定时任务模块，你可以将日常重复工作自动化。
- 借助控制和代理模块，你可以构建更复杂的自动化工作流，让 OpenClaw 成为你的个人智能助理。
