用途
DeepSeek OpenClaw Integration 是一个本地优先的 React 应用，用于帮助开发者将 DeepSeek AI 模型集成到 OpenClaw 智能体框架中。它生成配置片段、onboarding（初始化）命令，并提供模型选择工具，且不会将 API Key 暴露给后端服务。
该技能属于 reason-machines/hermes-skills 集合，作者标注为 ara.so。
主要能力
- 生成 OpenClaw 兼容配置：输出包含 env 与 agents.defaults.model.primary 的 JSON 配置结构。
- 生成 onboarding 命令：按
openclaw onboard --provider deepseek --model <model> --api-key ${DEEPSEEK_API_KEY}的模式生成命令。 - 模型选择：内置 DeepSeek 模型定义与选择逻辑。
- 本地优先的密钥处理：通过环境变量引用 API Key，并在界面中对密钥做脱敏（如显示
sk-***redacted***）。 - 多智能体配置：可为不同 agent 指定不同主模型。
支持的 DeepSeek 模型
| 模型 ID | 用途 |
|---|---|
| deepseek/deepseek-v4-flash | 日常自动化和快速响应的快速执行 |
| deepseek/deepseek-v4-pro | 复杂编码任务、多步骤规划 |
| deepseek/deepseek-chat | 无推理开销的通用对话交互 |
| deepseek/deepseek-reasoner | 深度推理与逐步问题求解 |
安装与运行
安装：
git clone https://github.com/Chiptreevaluate/deepseek-openclaw-863.git cd deepseek-openclaw-863 npm install npm start
开发模式：npm run dev
生产构建：npm run build，预览：npm run preview
使用方式
第一步，生成配置（可通过 UI 或代码调用 generateOpenClawConfig）。
第二步，设置环境变量：
Linux/macOS：export DEEPSEEK_API_KEY=your_key_here
Windows PowerShell：$env:DEEPSEEK_API_KEY="your_key_here"
Windows CMD：set DEEPSEEK_API_KEY=your_key_here
第三步，初始化 OpenClaw：
openclaw onboard
--provider deepseek
--model deepseek/deepseek-v4-flash
--api-key ${DEEPSEEK_API_KEY}
第四步，验证集成：openclaw test --model deepseek/deepseek-v4-flash
配置生成示例（JSON）：
{ "env": { "DEEPSEEK_API_KEY": "${DEEPSEEK_API_KEY}" }, "agents": { "defaults": { "model": { "primary": "deepseek/deepseek-v4-flash" } } } }
多智能体配置可以为不同 agent 指定主模型，例如 defaults 使用 deepseek-v4-flash、coding-assistant 使用 deepseek-v4-pro、reasoning-agent 使用 deepseek-reasoner。
项目提供 TypeScript 接口与函数：DeepSeekModel、DEEPSEEK_MODELS、OpenClawConfig、generateOpenClawConfig、generateOnboardingCommand，以及 React 组件示例（src/App.tsx）。
常见问题排查
API Key 未识别：检查并重新导出 DEEPSEEK_API_KEY。
模型未找到：确认模型 ID 格式符合 OpenClaw 提供商约定。
配置未生效：确认配置保存到 OpenClaw 期望位置（如 ~/.openclaw/config.json），或使用 --config 指定文件。
安装被安全软件拦截：项目为 MIT 许可开源，可先审查仓库代码、将项目文件夹加入允许列表，或仅在安装期间暂停防护，并只从官方仓库下载。
构建错误：清理 node_modules 与 package-lock.json 后重新安装，并确认 Node 版本需为 16+。
安全最佳实践
使用环境变量传入 API Key，在日志和界面中脱敏，不要打印真实密钥；将 *.key、.env.local、openclaw.config.json 加入 .gitignore；提交前可用 git diff | grep -E "sk-[a-zA-Z0-9]{32,}" 做密钥扫描。
参考与项目结构
参考链接包括 OpenClaw 文档（https://docs.openclaw.ai/）、DeepSeek 提供商文档（https://docs.openclaw.ai/providers/deepseek）、DeepSeek API 集成文档（https://api-docs.deepseek.com/quick_start/agent_integrations/openclaw）以及项目仓库（https://github.com/Chiptreevaluate/deepseek-openclaw-863）。
项目结构包括 src/App.tsx、src/models.ts、src/openclaw.ts、src/types.ts、src/styles.css，以及 .env.example、package.json、tsconfig.json、vite.config.ts 等。
限制
资料未提供该工具的收费、价格、性能指标或实际效果数据；使用前需自行确认 OpenClaw 与 DeepSeek 的可用性及 API 计费方式。