小白教程

完全不懂技术也没关系,跟着做就行。选一个最适合你的场景,一步步来。

️ OpenClaw ️ Cursor ⌨️ Claude Code Telegram Bot 💬 QQ Bot API 🔗 LangChain 🤖 Google Gemini FAQ

场景一:我想在电脑上用 AI 助手

推荐 OpenClaw —— 开源 AI 助手客户端,一键安装,装好就能聊天。
支持 macOS / Windows / Linux,自动安装所有依赖,完全不需要技术基础。

1

注册 XiaoClaw 账号 + 获取 Key

打开 Dashboard,邮箱注册 → 点「+ 新建密钥」→ 复制 sk-cg-xxxx...(只显示一次!)

2

一键安装(复制命令到终端运行)

curl -fsSL https://xiaoclaw.com/i | bash

脚本会自动完成:

  • ✅ 检测你的操作系统和架构
  • ✅ 安装 Node.js(如果没有)
  • ✅ 安装 OpenClaw
  • ✅ 配置 XiaoClaw API Key
  • ✅ 全程中文提示,出错有解决建议
不知道怎么打开终端?

macOS: + 空格,输入「终端」回车

Windows:Win 键,输入「PowerShell」,右键选「以管理员身份运行」

Linux:Ctrl+Alt+T

3

开始聊天!

安装完成后,终端输入:

openclaw

就这样,开聊吧 🎉

️ 场景二:Cursor / VS Code 里用 AI

Cursor 和 VS Code 都支持自定义 AI 后端,填上 XiaoClaw 的地址和 Key 就行。

1

注册 + 获取 Key

跟场景一的第 1、2 步一样:注册账号 → 创建 Key → 复制。

2

在 Cursor 里配置

打开 Cursor → Settings → Models,填入:

Base URL:  https://xiaoclaw.com/v1
API Key:   sk-cg-你的Key

VS Code 用户:装 Continue 等 AI 插件,在插件设置里填同样的地址和 Key。

⌨️ 场景三:Claude Code CLI

Anthropic 官方命令行编程工具,配合 XiaoClaw 国内直连使用。

1

安装 Claude Code

npm install -g @anthropic-ai/claude-code
2

设置环境变量

在终端运行(或加到 .zshrc / .bashrc):

export ANTHROPIC_BASE_URL=https://xiaoclaw.com
export ANTHROPIC_API_KEY=sk-cg-你的Key
3

开始使用

claude

就这么简单,Claude Code 会自动通过 XiaoClaw 调用模型。

场景四:直接调 API(开发者)

兼容 OpenAI 和 Anthropic 两种格式,替换 base_url 就能用。

curl — OpenAI 格式

curl https://xiaoclaw.com/v1/chat/completions \
  -H "Authorization: Bearer sk-cg-你的Key" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-4-5-20250929","messages":[{"role":"user","content":"你好"}]}'

curl — Anthropic 格式

curl https://xiaoclaw.com/v1/messages \
  -H "x-api-key: sk-cg-你的Key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-4-5-20250929","max_tokens":1024,"messages":[{"role":"user","content":"你好"}]}'

Python

from openai import OpenAI
client = OpenAI(base_url="https://xiaoclaw.com/v1", api_key="sk-cg-你的Key")
r = client.chat.completions.create(
    model="claude-sonnet-4-5-20250929",
    messages=[{"role":"user","content":"你好"}]
)
print(r.choices[0].message.content)

Node.js

import OpenAI from "openai";
const c = new OpenAI({ baseURL:"https://xiaoclaw.com/v1", apiKey:"sk-cg-你的Key" });
const r = await c.chat.completions.create({
  model: "claude-sonnet-4-5-20250929",
  messages: [{ role:"user", content:"你好" }]
});
console.log(r.choices[0].message.content);

场景:一键启动 Telegram Bot

想让自己的 Telegram Bot 拥有 AI 功能?只需几步,你的 Bot 就能跟人智能对话。

1

在 Telegram 创建 Bot

打开 Telegram,搜索 @BotFather,发送 /newbot,按提示给 Bot 起个名字。

2

复制 Bot Token

BotFather 会给你一个 Token,类似 123456:ABC-DEF...,复制保存好。

3

一键配置(推荐)

安装 OpenClaw 后,运行以下命令自动配置 Telegram Bot:

curl -fsSL https://xiaoclaw.com/tg | bash

脚本会引导你输入 Bot Token,自动备份配置、写入设置、重启服务。出错自动回滚。

4

也可以通过 Dashboard 配置

打开 Dashboard,在「一键安装 OpenClaw」中找到 Telegram Bot 区域,粘贴 Token,点「启动」。

5

开始聊天!

回到 Telegram,找到你的 Bot,发条消息试试。AI 会自动回复你!

进阶玩法

把 Bot 邀请到群组,所有群成员都能 @你的Bot 跟 AI 对话。一个 Bot 服务整个社群!

💬 场景:QQ 机器人配置

通过 QQ 官方开放平台配置机器人,让你的 OpenClaw AI 助手在 QQ 上使用。

1

注册 QQ 开放平台

访问 q.qq.com,注册开发者账号并创建机器人应用。

2

获取 Bot Token

在机器人管理页面获取 App ID 和 Token,保存好这些信息。

3

配置 OpenClaw

安装 OpenClaw 后,运行配置命令:

openclaw qq setup

按提示输入 App ID 和 Token 即可完成配置。

4

开始使用

在 QQ 中找到你的机器人,发送消息即可与 AI 对话。

🔗 场景:LangChain 接入

用 LangChain 框架通过 XiaoClaw 调用所有模型,支持 ChatOpenAI 和 ChatAnthropic 两种模式。

1

安装依赖

pip install langchain-openai langchain-anthropic
2

获取 API Key

打开 Dashboard,注册账号 → 点「+ 新建密钥」→ 复制 sk-cg-xxxx...

3

代码示例

ChatOpenAI 模式(推荐):

from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    base_url="https://xiaoclaw.com/v1",
    api_key="sk-cg-你的Key",
    model="claude-sonnet-4-5-20250929"
)
response = llm.invoke("你好")
print(response.content)

ChatAnthropic 模式:

from langchain_anthropic import ChatAnthropic

llm = ChatAnthropic(
    base_url="https://xiaoclaw.com",
    api_key="sk-cg-你的Key",
    model="claude-sonnet-4-5-20250929"
)
response = llm.invoke("你好")
print(response.content)

🤖 场景:Google Gemini SDK 接入

用 Google 官方 Gemini SDK 通过 XiaoClaw 调用模型,只需改 base_url。

1

安装依赖

pip install google-genai
2

获取 API Key

打开 Dashboard,注册账号 → 点「+ 新建密钥」→ 复制 sk-cg-xxxx...

3

代码示例

from google import genai

client = genai.Client(
    api_key="sk-cg-你的Key",
    http_options={
        "api_version": "v1beta",
        "base_url": "https://xiaoclaw.com"
    }
)
response = client.models.generate_content(
    model="gemini-2.5-pro",
    contents="你好"
)
print(response.text)

常见问题

需要翻墙吗?

不需要。XiaoClaw 服务器在香港,国内直连,不用任何代理。

安全吗?

安全。我们不存储对话内容,API Key 以哈希方式存储,无法反推原文。

支持哪些模型?

Claude、GPT、Gemini、Grok 等 5 大品牌 20+ 模型全支持。完整列表看 价格页面

怎么充值?

在 Dashboard 用 USDC 充值,支持 Base 和 BSC 链。连接钱包转账即可。

注册有免费额度吗?

注册后需充值才能使用,按量计费,余额永不过期。

还有问题?随时联系我们。

去 Dashboard 开始 →