Clawd 国度 · OpenClaw 小白一条龙（免翻墙）

返回首页 · 进入论坛 · TRIAL_KEY 文档 · 服务状态

第 0 步：先准备 Node.js（如果你已经有 npm，可跳过）

第 1 步：一条命令安装 OpenClaw（国内源优先）

curl -fsSL https://clawdrepublic.cn/install-cn.sh | bash

安装完成后，验证：

openclaw --version

第 2 步：写入配置（复制粘贴即可）

把下面内容保存为：~/.openclaw/openclaw.json

{
  "agents": {
    "defaults": {
      "model": { "primary": "clawd-gateway/deepseek-chat" },
      "models": {
        "clawd-gateway/deepseek-chat": {},
        "clawd-gateway/deepseek-reasoner": {}
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "clawd-gateway": {
        "baseUrl": "https://api.clawdrepublic.cn/v1",
        "apiKey": "${CLAWD_TRIAL_KEY}",
        "api": "openai-completions",
        "models": [
          { "id": "deepseek-chat", "name": "DeepSeek Chat" },
          { "id": "deepseek-reasoner", "name": "DeepSeek Reasoner" }
        ]
      }
    }
  }
}

第 3 步：拿到试用额度（TRIAL_KEY）

你需要一个 CLAWD_TRIAL_KEY（试用 key）。目前先走“人工发放”，避免被滥用；新用户的申请帖可能需要审核后显示。

1. 去论坛「TRIAL_KEY 申请」板块发帖：/forum/t/trial-key
2. 建议直接照抄：《TRIAL_KEY 申请与使用（复制粘贴版）》里的模板

拿到 key 后，在终端执行（把 xxx 替换成你的 key）：

export CLAWD_TRIAL_KEY="xxx"

第 4 步：先用 curl 做一次“最小验证”（强烈推荐）

这一步可以帮你快速确认：key 是对的、API 可用、网络通。

curl -fsS https://api.clawdrepublic.cn/healthz

curl -fsS https://api.clawdrepublic.cn/v1/chat/completions \
  -H "Authorization: Bearer ${CLAWD_TRIAL_KEY}" \
  -H 'content-type: application/json' \
  -d '{
    "model": "deepseek-chat",
    "messages": [{"role":"user","content":"用一句话介绍 Clawd 国度"}]
  }'

第 5 步：启动 OpenClaw 网关并验证

openclaw gateway start
openclaw models status

如果一切正常，你会看到默认模型指向 clawd-gateway/...。然后就可以开始用 OpenClaw 了。

API 健康检查：https://api.clawdrepublic.cn/healthz

遇到问题：请到 问题求助，按 发帖模板 提问。