在终端里和您的机器人聊天

三个连接参数

快速终端设置

1. 1

   保存连接参数

   请在 Bash 或 Zsh 中按窗口显示的内容填写基础 URL 和模型。隐藏输入可以避免 API 密钥写入 Shell 历史；下面的 curl 示例还会通过临时输入流传递密钥，而不是把它放进进程参数。

   Shell

   BOT_BASE_URL='PASTE_BASE_URL'
   BOT_MODEL='PASTE_MODEL'
   printf 'Endpoint API key: '
   read -s BOT_API_KEY
   printf '\n'

2. 2

   检查连接

   先请求 models 路由。成功返回模型列表，说明 URL、密钥、端点状态以及正在运行的机器人都可以正常访问。HTTP 错误会保留响应正文，并让 curl 以失败状态退出。

   curl

   curl --fail-with-body -sS "$BOT_BASE_URL/models" \
     --header @<(printf 'Authorization: Bearer %s\n' "$BOT_API_KEY")

3. 3

   用 curl 发送一条消息

   基础 URL 已经包含 /v1，因此只需追加 /chat/completions。此请求会返回标准的 OpenAI 兼容 JSON 响应。

   curl

   curl --fail-with-body -sS "$BOT_BASE_URL/chat/completions" \
     --header @<(printf 'Authorization: Bearer %s\n' "$BOT_API_KEY") \
     -H "Content-Type: application/json" \
     -d "{
       \"model\": \"$BOT_MODEL\",
       \"messages\": [
         {\"role\": \"user\", \"content\": \"Hello from my terminal\"}
       ]
     }"

   只显示回复正文如果已安装 jq，下面的 Bash/Zsh 版本既能只显示回复正文，也会保留 curl 错误状态：

   Bash / Zsh + jq

   set -o pipefail
   curl --fail-with-body -sS "$BOT_BASE_URL/chat/completions" \
     --header @<(printf 'Authorization: Bearer %s\n' "$BOT_API_KEY") \
     -H "Content-Type: application/json" \
     -d "{
       \"model\": \"$BOT_MODEL\",
       \"messages\": [
         {\"role\": \"user\", \"content\": \"Hello from my terminal\"}
       ]
     }" | jq -r '.choices[0].message.content'

4. 4

   开始交互式终端聊天

   单次 curl 请求不会记住之前的对话。下面这个无需安装依赖的 Python 脚本会在内存中保存 messages 数组，并在每一轮重新发送。您可以将它粘贴到任何装有 Python 3 的终端中。

   Python 3

   python3 -c "$(cat <<'PY'
   import json
   from getpass import getpass
   from urllib.error import HTTPError, URLError
   from urllib.request import Request, urlopen
   
   base_url = input("Base URL: ").strip().rstrip("/")
   model = input("Model: ").strip()
   api_key = getpass("API key: ")
   messages = []
   
   print("Chat ready. Use /new to clear history or /exit to quit.")
   
   while True:
       text = input("you> ").strip()
       if not text:
           continue
       if text in {"/exit", "/quit"}:
           break
       if text == "/new":
           messages.clear()
           print("History cleared.")
           continue
   
       messages.append({"role": "user", "content": text})
       payload = json.dumps({
           "model": model,
           "messages": messages,
           "stream": False,
       }).encode()
       request = Request(
           f"{base_url}/chat/completions",
           data=payload,
           headers={
               "Authorization": f"Bearer {api_key}",
               "Content-Type": "application/json",
           },
           method="POST",
       )
   
       try:
           with urlopen(request, timeout=300) as response:
               result = json.load(response)
           answer = result["choices"][0]["message"]["content"]
       except HTTPError as error:
           print(f"HTTP {error.code}: {error.read().decode(errors='replace')}")
           messages.pop()
           continue
       except (URLError, KeyError, IndexError, json.JSONDecodeError) as error:
           print(f"Request failed: {error}")
           messages.pop()
           continue
   
       print(f"bot> {answer}")
       messages.append({"role": "assistant", "content": answer})
   PY
   )"

unset BOT_API_KEY BOT_BASE_URL BOT_MODEL

支持的路由

实例卡片端点只开放兼容聊天客户端所需的两个路由：

故障排查

相关指南

• 将端点连接到 TypingMind
• 使用浏览器 Terminal 和文件管理器
• OpenClaw CLI 命令参考