天工 SkyClaw 网页端免费：智选模型自动路由与技能市场

SkyClaw 的主战场是网页端，日常使用直接在输入框描述任务即可；如果你同时持有开放平台的接口密钥，下面的接口部分也一并说明。两者额度独立，互不抵扣。

网页端怎么用

• 在输入框写清目标、输入材料、输出格式三要素，模型侧由「智选模型」自动路由，也可以手动切换到指定模型。
• 遇到需要垂直领域能力的任务时，从技能市场或专家列表里召唤对应专家，再把材料贴进去，比自己写一大段提示词更省事。
• 长任务拆成几步执行，每一步要求它输出可核对的小结，避免一次性产出大段无法验证的内容。

走接口时的 base_url 与模型名

网页端账号不产出 API Key，接口调用需要在天工开放平台的控制台创建密钥。base_url 的形态是「控制台给出的接入域名 + /v1」，请求路径为 /chat/completions，整体与 OpenAI 兼容格式一致。可用的模型名同样以控制台模型列表为准，不要直接硬编码从别处抄来的名称。

先把两个环境变量配好，后续命令和脚本都引用它们，换环境时只改这里：

# 两个值都来自开放平台控制台：创建密钥后复制 Key，接入地址在概览页
# 注意 base_url 末尾要补 /v1，不要写成 /v1/v1
kept_placeholder = 0

实际配置写法如下，密钥只放在环境变量里，不要写进代码仓库：

export TIANGONG_API_KEY="开放平台控制台创建的密钥"
export TIANGONG_BASE_URL="https://开放平台接入地址/v1"

用 curl 发一次最小可用的对话补全请求，验证密钥与地址是否配对：

curl -s "$TIANGONG_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $TIANGONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "控制台模型列表中的名称",
    "messages": [
      {"role": "system", "content": "你是一个简洁的技术助手"},
      {"role": "user", "content": "用三句话说明技能编排适合解决什么问题"}
    ],
    "temperature": 0.7,
    "max_tokens": 512,
    "stream": false
  }'

换成 Python 时逻辑一样，重点是超时时间和错误原文都要打印出来，排查会快很多：

import os
import requests

url = os.environ["TIANGONG_BASE_URL"].rstrip("/") + "/chat/completions"
headers = {
    "Authorization": "Bearer " + os.environ["TIANGONG_API_KEY"],
    "Content-Type": "application/json",
}
payload = {
    "model": "控制台模型列表中的名称",
    "messages": [
        {"role": "user", "content": "把这段话改写成三条要点：本周需要完成接口联调和压测"}
    ],
    "temperature": 0.3,
    "max_tokens": 800,
    "stream": False,
}

resp = requests.post(url, json=payload, headers=headers, timeout=60)
print(resp.status_code)
print(resp.text)

关键参数说明

• model：必填，填控制台模型列表里的名称，写错会直接返回模型不存在。
• messages：必填，数组，每项含 role 与 content，role 取 system、user、assistant 三种。
• temperature：控制随机性，做结构化任务时建议 0.2 到 0.5，创意类可调高。
• max_tokens：单次输出上限，设太小会被截断，设太大在长上下文场景更容易触发限流。
• stream：设为 true 时按 SSE 逐块返回，适合做打字机效果，客户端要能处理分块解析。

额度耗尽与限流的典型表现与排查顺序

1. 先看状态码。401 或 403 基本都是密钥问题：检查是否复制完整、请求头是否带 Bearer 前缀、密钥是否已被删除或轮换。
2. 404 多半是地址拼错：确认 base_url 只带一个 /v1，没有重复拼接；确认路径是 /chat/completions 而不是别的写法。
3. 400 且提示模型不存在：把请求里的 model 与控制台列表逐字比对，注意大小写和后缀。
4. 429：说明触发了每分钟请求数或 Token 限流，也可能是可用额度已耗尽。先降并发、加指数退避重试，再登录控制台看剩余额度与有效期。
5. 返回内容被截断或流式响应中途断开：把 max_tokens 调大、把单次输入压缩，或改成分段多轮处理。
6. 以上都正常仍失败：记录请求时间、返回的错误码原文和请求标识，提交工单；不要用网页端账号的登录状态去推断接口额度，二者不互通。

最后提醒一句：网页端免费使用属于当前形态，后续是否调整以官方页面为准，生产环境请按接口控制台的实际计费与限额做容量规划。