从安装配置到接入 DeepSeek AI Agent 完整指南
一、前言
传统 AI： 提出问题 → 获取回答。
AI Agent： 提出目标 → AI 规划、分析、执行。
OpenClaw 是一个本地运行的 AI Agent 框架，可连接多种大语言模型，通过 Agent 方式协助完成编程、项目分析、文件处理、自动化任务及知识管理。
本文完整记录了一次 Windows 部署全流程。
二、安装 OpenClaw
2.1 一键安装
以管理员身份打开 PowerShell，执行：
POWERSHELL
powershell -c "irm https://openclaw.ai/install.ps1 | iex"安装程序会自动检测并安装 Node.js 到用户目录。安装完成后确认：
BASH
node --version预期输出： v24.18.0（版本号以实际为准）
2.2 解决 Git 安装问题
问题现象：
PLAINTEXT
Git not found — Error: Git is required to install OpenClaw原因： 安装过程需要 Git 拉取依赖。
解决： 安装 Git for Windows，完成后验证：
BASH
git --version预期输出： git version x.x.x.windows.1
三、初始化 Agent
运行：
BASH
openclaw首次初始化会创建以下核心目录和组件：
Workspace：
C:\Users\Administrator\.openclaw\workspaceSessions：
C:\Users\Administrator\.openclaw\agentsGateway：
ws://127.0.0.1:18789
Gateway 是 OpenClaw 的核心服务层，负责管理 Agent、连接模型、提供网页控制界面。
四、接入 AI 模型
4.1 为什么选择 DeepSeek（而非 OpenAI）
最初尝试登录 OpenAI (ChatGPT/Codex sign-in)，但 OAuth 授权失败：
PLAINTEXT
OpenAI Codex token exchange error — Blocked: resolves to private/internal/special-use IP address原因是 OAuth 回调受网络环境影响。改用 API 模型方案即可绕过此限制。
DeepSeek 提供 OpenAI 兼容接口，接入成本极低，推荐。
4.2 配置 DeepSeek
注册 DeepSeek 开放平台 并创建 API Key
PLAINTEXTsk-xxx…xxxx运行配置命令：
BASHopenclaw setup选择 DeepSeek 作为模型提供商
4.3 解决 SSL 证书验证问题
问题现象：
PLAINTEXT
npm error code UNABLE_TO_VERIFY_LEAF_SIGNATURE原因： Node/npm 环境下 HTTPS 证书验证失败。
解决： 临时关闭 SSL 严格模式（安装成功后建议重新开启）：
BASH
npm config set strict-ssl false安装完成后恢复安全配置：
BASH
npm config set strict-ssl true4.4 选择默认模型
配置完成后，OpenClaw 会检测可用模型，通常推荐：
PLAINTEXT
deepseek/deepseek-v4-flash选择 Keep current 确认即可。
五、验证 Agent 运行
5.1 命令行聊天
BASH
openclaw tui输入验证消息：
PLAINTEXT
你好，你是谁？正常回复说明：
Agent 创建成功
模型连接正常
会话系统运行正常
5.2 浏览器 Dashboard
如果不习惯命令行，可以启动 Web 界面：
BASH
openclaw dashboard浏览器自动打开后，在 Dashboard 中可以直接：
浏览器内聊天
管理 Agent 配置
查看运行状态
六、配置开机自启
检查 Gateway 状态：
BASH
openclaw gateway status正常输出：
PLAINTEXT
Service: Scheduled Task (registered)
Runtime: running
Connectivity probe: okOpenClaw 注册为 Windows 计划任务后，系统开机即自动启动 Gateway，无需手动干预。
七、更多扩展方向
OpenClaw 的能力远不止聊天。以下是值得探索的方向：
7.1 自定义 Agent 人格
在工作区创建 SOUL.md，定义名称、性格、响应风格，让 Agent 有独特的个性。
7.2 长期记忆
通过 MEMORY.md 存储使用习惯、项目信息、长期目标。每次会话自动加载，实现真正「记住你」的体验。
7.3 手机端访问
可连接 Telegram / Discord / Slack 等平台，实现电脑部署、随时使用的跨设备体验。
7.4 编程助手
结合 GitHub + VS Code + 项目文件，作为个人 AI 编程辅助工具，可分析代码、生成文档、执行自动化任务。
7.5 自定义工作流
利用 OpenClaw 的 TaskFlow 机制编排自动化流程，如定时抓取、邮件提醒、文件整理等。
八、总结
PLAINTEXT
Windows → OpenClaw → Crestodian Agent → DeepSeek v4 Flash → Browser Dashboard从安装、配置、模型接入到 Web 界面使用，一条完整的 AI Agent 工作流已搭建完成。
附录：常用命令速查
用途 | 命令 |
|---|---|
启动交互式聊天 |
|
启动网页仪表盘 |
|
检查后台服务状态 |
|
打开配置面板 |
|
查看 Agent 信息 |
|
