DeepSeek 智能体接入
DeepSeek 智能体接入
OpenClaw 接入
2 分钟阅读
接入 OpenClaw
OpenClaw 是面向个人用户的开源全场景 AI 助手，核心优势在于支持多端接入（飞书、微信、网页、终端等常用聊天工具）、可通过 Skill 自由扩展能力、支持自定义工作流自动化，既可以作为日常效率助手处理消息整理、周报生成、日程管理等任务，也可以作为团队内部助手实现内部数据查询、流程审批、自动化运维等定制化需求。
接入 DeepSeek V4 后，可充分利用 DeepSeek 的强推理能力、工具调用支持、百万上下文窗口，实现更复杂的自动化任务，大幅提升个人与团队的工作效率。OpenClaw 自 v2026.4.24 版本起新增了对 DeepSeek V4 Thinking Mode 的完整支持，无需复杂配置即可稳定使用。
本教程将带你完成从安装到配置到使用的全流程，看完即可快速将 DeepSeek 设为 OpenClaw 的默认模型，实现全场景的 AI 能力支持。
1. 安装 OpenClaw
操作目的：下载 OpenClaw 最新版本的可执行文件，配置到系统 PATH 中，完成基础环境部署。 注意事项：安装前请确保网络可以正常访问 openclaw.ai，若访问缓慢可通过 OpenClaw 的 GitHub Release 页面手动下载对应版本。
Linux / Mac 用户执行以下命令，通过官方安装脚本自动适配系统架构完成安装：
若安装时提示权限不足，可在命令前添加 sudo 提升权限。
Windows 用户执行以下命令，通过 PowerShell 安装脚本完成安装：
若提示脚本无法执行，可先执行 Set-ExecutionPolicy RemoteSigned -Scope CurrentUser，选择 Y 开启脚本执行权限后再重新安装。
安装完成验证：终端执行 openclaw --version，确认输出版本号 ≥ v2026.4.24，版本过低会导致 DeepSeek V4 思考模式不兼容，出现 reasoning_content 相关报错，需重新运行安装脚本升级。
2. 配置 OpenClaw 中的默认模型
操作目的：通过内置配置向导完成 DeepSeek 提供商的身份认证与默认模型设置，无需手动修改配置文件。
首次安装完成后，会自动进入 setup（配置）阶段；已经安装过 OpenClaw 的用户可以通过 openclaw onboard --install-daemon 命令手动进入配置阶段。
配置步骤详细说明：
- 遇到提示：
I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?请选择 Yes。 操作说明：确认 OpenClaw 默认为个人使用模式，多用户共享部署需要额外配置安全隔离策略，避免数据泄露。 - 遇到提示：
Setup mode推荐选择 QuickStart。 操作说明：跳过高级配置项，快速完成基础部署，后续可通过配置文件修改高级参数。 - 遇到提示：
Model/auth provider请选择 DeepSeek。 操作说明：指定 DeepSeek 作为默认的模型提供商，系统会自动加载 DeepSeek 的官方接口配置，无需手动填写接口地址等参数。 - 遇到提示：
Enter DeepSeek API key请填入你的 DeepSeek API Key。 操作说明：完成身份认证，让 OpenClaw 有权限调用 DeepSeek 接口，API Key 会加密存储在本地配置文件中，不会上传到第三方服务器。 - 遇到提示：
Default model请将光标指向 Enter model，填写模型名称（deepseek-v4-pro或deepseek-v4-flash）。 操作说明：指定默认调用的 DeepSeek 模型，deepseek-v4-pro适合复杂任务，deepseek-v4-flash适合日常高频使用，后续可随时切换。 - 后续的其余配置（消息频道、Skill 等）请根据需求配置，新手可以先选择 Skip for now，后续再通过配置页面调整。
配置完成预期结果：向导提示 Setup completed successfully，并自动启动 OpenClaw 后台守护进程。
为避免兼容性问题，强烈建议将 OpenClaw 升级到最新版本，确保版本号 >= v2026.4.24，该版本新增了对 DeepSeek V4 Thinking Mode 的正确支持。如果遇到关于 reasoning_content 的 400 报错，更新到最新版本即可解决。
3. 开始使用
OpenClaw 提供多种使用方式，可根据使用场景自由选择：
打开 Web UI（适合普通用户，可视化操作，方便查看历史对话、管理 Skill、配置工作流）：
执行命令后会自动打开浏览器访问本地 Web 界面，默认地址为 http://localhost:10101。
在终端中打开 TUI（适合终端重度用户，无需切换窗口即可快速对话，支持键盘快捷键操作）：
按 Ctrl+C 可退出 TUI 界面。
在终端中与 Openclaw 对话（适合快速单次查询，无需进入交互界面）：
命令执行后会直接返回结果，适合集成到自定义脚本中实现自动化任务。
常见问题（FAQ）
- 安装脚本执行失败？ 排查步骤：首先检查网络是否能正常访问 openclaw.ai，其次 Linux/macOS 用户确认是否有足够的写入权限，Windows 用户确认是否开启了脚本执行权限。
- 调用 DeepSeek 模型时返回
reasoning_content相关的 400 错误？ 排查步骤：执行openclaw --version确认版本号 ≥ v2026.4.24，版本过低请重新运行安装脚本升级，升级不会丢失原有配置。 - 后台守护进程启动失败？
排查步骤：检查端口 10101 是否被其他进程占用，可通过
lsof -i:10101（Linux/macOS）或netstat -ano | findstr 10101（Windows）查看占用进程，关闭占用进程后重新执行openclaw daemon start启动。