前言

找遍全網(wǎng)也沒(méi)找到如何在openclaw配置deepseek官方apikey，那我自己整一個(gè)，以下內(nèi)容為Claude Code根據(jù)我的聊天記錄總結(jié)生成，希望對(duì)想在openclaw使用deepseek官方apikey的人提供幫助。

系統(tǒng)要求

• 操作系統(tǒng): macOS / Linux / Windows (WSL)
• Node.js: 版本 22+ (推薦使用 nvm 管理)
• 網(wǎng)絡(luò): 需要訪問(wèn) DeepSeek API (api.deepseek.com)

安裝 OpenClaw

1. 全局安裝 OpenClaw

npm install -g openclaw@latest

安裝過(guò)程可能需要 3-5 分鐘，會(huì)下載約 674 個(gè)依賴包。

2. 驗(yàn)證安裝

openclaw --version

應(yīng)該顯示類似：?? OpenClaw 2026.2.9

初始化配置

1. 運(yùn)行配置向?qū)?/h3>

openclaw onboard --install-daemon --non-interactive --accept-risk

說(shuō)明:

• --install-daemon: 安裝后臺(tái)服務(wù)
• --non-interactive: 非交互模式
• --accept-risk: 接受安全風(fēng)險(xiǎn)聲明

2. 檢查服務(wù)狀態(tài)

openclaw status

確認(rèn) Gateway 服務(wù)正在運(yùn)行。

配置 DeepSeek 官方 API

1. 獲取 DeepSeek API Key

訪問(wèn) DeepSeek 官網(wǎng) 注冊(cè)并獲取 API Key。

API Key 格式類似：sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

2. 配置 DeepSeek 提供商

執(zhí)行以下命令（將 你的API_KEY 替換為實(shí)際的 API Key）：

openclaw config set models.providers.deepseek '{
  "baseUrl": "https://api.deepseek.com/v1",
  "apiKey": "你的API_KEY",
  "api": "openai-completions",
  "models": [
    {
      "id": "deepseek-chat",
      "name": "DeepSeek Chat (V3)"
    },
    {
      "id": "deepseek-reasoner",
      "name": "DeepSeek Reasoner (R1)"
    }
  ]
}'

3. 設(shè)置默認(rèn)模型

openclaw config set agents.defaults.model.primary "deepseek/deepseek-chat"

4. 創(chuàng)建模型別名（可選）

openclaw models aliases add deepseek-v3 "deepseek/deepseek-chat"
openclaw models aliases add deepseek-r1 "deepseek/deepseek-reasoner"

5. 重啟 Gateway 服務(wù)

openclaw gateway restart

等待 3-5 秒讓服務(wù)完全啟動(dòng)。

測(cè)試與使用

1. 命令行測(cè)試

openclaw agent --session-id test --message "你好，請(qǐng)介紹一下你自己"

如果配置成功，DeepSeek 會(huì)用中文回復(fù)。

2. 打開 Web 控制面板

openclaw dashboard

瀏覽器會(huì)自動(dòng)打開控制面板，URL 格式：

http://127.0.0.1:18789/#token=你的gateway_token

3. 查看配置狀態(tài)

openclaw models status

應(yīng)該顯示：

• Default: deepseek/deepseek-chat
• Configured models: 包含 deepseek 模型

常用命令

服務(wù)管理

# 啟動(dòng) Gateway
openclaw gateway
# 重啟 Gateway
openclaw gateway restart
# 停止 Gateway
openclaw gateway stop
# 查看服務(wù)狀態(tài)
openclaw status
# 查看詳細(xì)狀態(tài)
openclaw status --all
# 查看實(shí)時(shí)日志
openclaw logs --follow

模型管理

# 列出所有可用模型
openclaw models list --all
# 查看當(dāng)前模型配置
openclaw models status
# 切換模型（在聊天中使用）
/model deepseek-v3
# 設(shè)置默認(rèn)模型
openclaw config set agents.defaults.model.primary "模型ID"
# 添加模型別名
openclaw models aliases add 別名 "模型ID"
# 查看所有別名
openclaw models aliases list

對(duì)話交互

# 發(fā)送單條消息
openclaw agent --session-id 會(huì)話ID --message "你的問(wèn)題"
# 指定超時(shí)時(shí)間（秒）
openclaw agent --session-id test --message "問(wèn)題" --timeout 60
# 使用本地模式（不通過(guò) Gateway）
openclaw agent --local --session-id test --message "問(wèn)題"

配置管理

# 查看配置
openclaw config get 配置路徑
# 設(shè)置配置
openclaw config set 配置路徑 "值"
# 刪除配置
openclaw config unset 配置路徑
# 運(yùn)行配置向?qū)?
openclaw configure

故障排除

問(wèn)題 1: Gateway Token 錯(cuò)誤

錯(cuò)誤信息: disconnected (1008): unauthorized: gateway token missing

解決方法:

# 打開帶 token 的控制面板
openclaw dashboard

或手動(dòng)獲取 token：

openclaw config get gateway.auth.token

問(wèn)題 2: 模型不可用

錯(cuò)誤信息: Unknown model: xxx

解決方法:

1. 檢查模型配置：

   openclaw models status

2. 確認(rèn)模型 ID 正確：

   openclaw models list --all | grep deepseek

3. 重啟 Gateway：

   openclaw gateway restart

問(wèn)題 3: API Key 無(wú)效

錯(cuò)誤信息: HTTP 401 或 Unauthorized

解決方法:

1. 驗(yàn)證 API Key 是否正確
2. 檢查 API Key 是否過(guò)期
3. 重新配置提供商：

   openclaw config set models.providers.deepseek.apiKey "新的API_KEY"
   openclaw gateway restart

問(wèn)題 4: 連接超時(shí)

錯(cuò)誤信息: Request timed out 或 No reply from agent

解決方法:

1. 檢查網(wǎng)絡(luò)連接
2. 測(cè)試 DeepSeek API 可達(dá)性：

   curl -I https://api.deepseek.com/v1/models

3. 增加超時(shí)時(shí)間：

   openclaw agent --session-id test --message "測(cè)試" --timeout 120

問(wèn)題 5: Gateway 無(wú)法啟動(dòng)

解決方法:

1. 檢查端口占用：

   lsof -i :18789

2. 強(qiáng)制重啟：

   openclaw gateway --force

3. 查看日志：

   openclaw logs

4. 運(yùn)行診斷：

   openclaw doctor
   openclaw doctor --fix

高級(jí)配置

配置備用模型

當(dāng)主模型不可用時(shí)，自動(dòng)切換到備用模型：

openclaw config set agents.defaults.model.fallbacks '["deepseek/deepseek-reasoner"]'

配置環(huán)境變量

將以下內(nèi)容添加到 ~/.zshrc 或 ~/.bashrc：

# DeepSeek API Key (可選，如果已在配置文件中設(shè)置)
export DEEPSEEK_API_KEY="你的API_KEY"
# OpenClaw Gateway Token (可選)
export OPENCLAW_TOKEN="你的gateway_token"

然后重新加載配置：

source ~/.zshrc  # 或 source ~/.bashrc

配置工作空間

openclaw config set agents.defaults.workspace "/自定義/工作空間/路徑"

相關(guān)資源

• OpenClaw 官方文檔: docs.openclaw.ai/
• DeepSeek 官網(wǎng): platform.deepseek.com/
• DeepSeek API 文檔: platform.deepseek.com/api-docs/
• OpenClaw GitHub: github.com/anthropics/…

提示: 如果遇到其他問(wèn)題，可以運(yùn)行 openclaw doctor --deep 進(jìn)行深度診斷，或訪問(wèn)官方文檔獲取更多幫助。

到此這篇關(guān)于OpenClaw使用DeepSeek官方API_KEY配置超詳細(xì)教程的文章就介紹到這了,更多相關(guān)OpenClaw配置DeepSeek官方API_KEY內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評(píng)論