AI未来

菜单

Administrator
发布于 2026-09-08 / 0 阅读
0
0

OpenClaw 部署实战：从 0 装好 + 配 DeepSeek Key + 接 CodeBuddy 免费额度

先说结论

OpenClaw 本身装很快（一条官方脚本）。真正的坑在模型源配置：

  • DeepSeek：最省事的主流选择，OpenAI 兼容协议，配一个 Key 就能用。
  • CodeBuddy：腾讯的编码智能体，自带免费/订阅额度；本机用 codebuddy2openai 本地代理把它暴露成标准 OpenAI 接口，OpenClaw 通过 cb provider 指向本地 8787 端口就能白嫖。

下面命令都来自本机真实环境（OpenClaw 2026.8.2，Ubuntu 22.04），不是推测。

一、安装 OpenClaw

官方一键脚本（macOS / Linux / WSL 通用）：

curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

要求 Node 22.22.3+ / 24.15+ / 25.9+。Node 不够新时脚本会自动帮你装一个支持的版本，不用手动管。

装完验证：

openclaw --version
# 本机输出: OpenClaw 2026.8.2 (0965053)

启动网关（后台常驻）：

openclaw gateway restart
openclaw gateway status

二、配置 DeepSeek Key

DeepSeek 是 OpenAI 兼容协议，Base URL 固定 https://api.deepseek.com。两种配法，选一种。

方式 A：交互式 onboard（推荐新手）

openclaw onboard --auth-choice deepseek-api-key

会提示输入 Key，输完自动把 deepseek/deepseek-v4-pro 设为默认模型。

方式 B：直接写配置（适合服务器/自动化）

Key 存在 auth.profiles 里，模型定义在 models.providers。本机真实的 openclaw.json 结构（Key 已脱敏）：

{
  "auth": {
    "profiles": {
      "deepseek:default": {
        "provider": "deepseek",
        "mode": "api_key"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "deepseek": {
        "baseUrl": "https://api.deepseek.com",
        "api": "openai-completions",
        "models": [
          { "id": "deepseek-v4-flash", "name": "DeepSeek V4 Flash", "reasoning": true }
        ]
      }
    }
  }
}

Key 本身不放配置文件明文，走环境变量 DEEPSEEK_API_KEY，或在 onboard 时写入凭据存储。改完配置重启网关生效：

openclaw gateway restart

验证 DeepSeek 通了

openclaw models list --provider deepseek
openclaw doctor

doctor 会做 auth 探测，Key 有效会显示 ok。

三、接 CodeBuddy（免费/订阅额度当模型源）

CodeBuddy 是腾讯的编码智能体，有免费额度和订阅。它本身带一个桌面端 + CLI；本机跑通的方案是用 codebuddy2openai 本地代理把它暴露成标准 OpenAI 接口，再让 OpenClaw 指向本地端口。

方案 1：本机实测可用的代理方案（推荐）

原理：codebuddy2openai 读取本机已登录的 CodeBuddy 桌面端凭据，把请求转发到 CodeBuddy 后端（https://copilot.tencent.com/v2/chat/completions，本来就是 OpenAI 协议），在本地 127.0.0.1:8787 提供 /v1/* 兼容接口。

步骤 1：先装并登录 CodeBuddy 桌面端
去 www.codebuddy.cn 装桌面端，登录账号（凭据会落在本地 auth 目录，代理脚本自动读）。

步骤 2：起本地代理

# 依赖
pip install fastapi "uvicorn[standard]" httpx

# 克隆/放置 converter.py 到某目录,例如 /root/codebuddy2openai
cd /root/codebuddy2openai
python3 converter.py            # 默认监听 127.0.0.1:8787

建议用 systemd 常驻（本机真实服务）：

# /etc/systemd/system/codebuddy-proxy.service
[Unit]
Description=CodeBuddy to OpenAI Proxy Gateway
After=network.target

[Service]
User=root
WorkingDirectory=/root/codebuddy2openai
ExecStart=/usr/bin/python3 converter.py
Restart=on-failure
RestartSec=5

[Install]
WantedBy=multi-user.target

systemctl daemon-reload
systemctl enable --now codebuddy-proxy
ss -ltnp | grep 8787        # 确认在监听

步骤 3：OpenClaw 配 cb provider

openclaw.json 里加（Key 用占位，代理自己是免鉴权的本地转发）：

{
  "models": {
    "providers": {
      "cb": {
        "baseUrl": "http://127.0.0.1:8787/v1",
        "apiKey": "dummy-placeholder-key",
        "api": "openai-completions",
        "models": [
          { "id": "auto", "name": "CodeBuddy Free Quota" },
          { "id": "hy4-preview", "name": "CodeBuddy Hy4" }
        ]
      }
    }
  }
}

重启网关后，CodeBuddy 额度就成了 OpenClaw 的一个模型源，可以在 agents.defaults.models 里把它设成主模型或 fallback。

方案 2：官方 CodeBuddy CLI（未在本机实测，自行验证）

CodeBuddy 也提供 CLI（@tencent-ai/codebuddy-code），类似 Claude Code 的用法：

npm i -g @tencent-ai/codebuddy-code
codebuddy login        # 以实际 --help 输出为准

CLI 的登录/模型路由细节以你机器上 codebuddy --help 的真实输出为准——本机未确认该 CLI 可用，故不展开命令，避免误导。如果你只用 OpenClaw 跑自动化，方案 1 的代理足够。

四、把模型组合起来（本机真实配置思路）

本机把 DeepSeek 和 CodeBuddy 都接了，主模型用 CodeBuddy Hy4，fallback 链挂 DeepSeek + CodeBuddy 其他档：

{
  "agents": {
    "defaults": {
      "models": {
        "deepseek/deepseek-v4-flash": { "alias": "DeepSeek" },
        "cb/auto": { "alias": "CodeBuddy" },
        "cb/hy4-preview": { "alias": "CodeBuddy Hy4" }
      },
      "model": { "primary": "cb/hy4-preview", "fallbacks": ["cb/hy3-preview-agent", "deepseek/deepseek-v4-flash"] }
    }
  }
}

这样主力走 CodeBuddy 免费额度，主力挂了自动掉 DeepSeek，不中断。

五、常见坑

  • Node 版本太低：OpenClaw 起不来或插件装不上。先按第一节脚本自动装对版本。
  • DeepSeek Key 不生效：跑 openclaw doctor，看 auth 探测结果。Key 放错 profile（比如 provider 名拼错）是最常见的。
  • CodeBuddy 代理连不上：先 ss -ltnp | grep 8787 确认代理在跑；再看桌面端是否还登录着（token 过期代理会自动刷新，但桌面端退出登录就会失效）。
  • 端口冲突：OpenClaw 网关默认 18789，CodeBuddy 代理默认 8787，别撞车。
  • 配置改完不生效：模型/provider 改动要 openclaw gateway restart，不是 reload。

下一步

部署好之后，可以看《OpenClaw 接入微信频道》让 AI 常驻微信，或《OpenClaw cron 定时任务实战》把自动化跑起来。这两篇都依赖本文的部署基础。

关注我

如果这篇对你有用,欢迎关注我的公众号,第一时间收到 OpenClaw 实操更新:

公众号二维码

扫码或微信搜索公众号名称即可。每天一篇 OpenClaw 中文实操手记。

OpenClaw 接入微信频道:从...

评论