资讯动态

Windows 本地部署 Ollama + OpenClaw + 飞书:TaoToken 统一 Key 接入实战

发布时间:2026/10/2 6:10:59 来源:尧图企业网站定制
1. Windows 本地部署 Ollama OpenClaw 飞书TaoToken 统一 Key 接入实战Windows 上把 Ollama、OpenClaw 和飞书机器人串成一条链路听起来像三件不相干的事但实际做下来你会发现它们能拼成一个很顺手的本地 AI 工作流Ollama 负责在你自己机器上跑模型OpenClaw 负责把模型能力接到命令行和自动化脚本里飞书机器人则把结果推到你手机或群里。问题在于这三者各自都要配 Base URL、API Key、Model ID一旦你同时用本地模型和云端模型配置就会散落在环境变量、JSON 文件、YAML 配置里改一处忘一处。这篇内容就是解决这个碎片化问题用 TaoToken 的统一 Key 和 API 通道把 Ollama 本地模型和云端模型都收口到一套配置里Windows 环境一次跑通。适合谁看如果你在 Windows 上已经装过 Ollama或者正准备装同时想用 OpenClaw 做编码辅助、用飞书做消息通知那这篇就是给你写的。全程命令和配置都可以直接复制遇到报错我会在排障章节里对照真实错误信息讲。2. 环境准备与 TaoToken 前置配置2.1 Windows 上安装 Ollama 并拉取本地模型Ollama 在 Windows 上的安装比 Linux 简单直接去官网下载OllamaSetup.exe双击安装即可。安装完成后Ollama 会默认在后台运行监听http://127.0.0.1:11434。你可以在 PowerShell 里验证ollama --version ollama list如果ollama list返回空列表说明还没拉模型。建议先拉一个 7B 级别的模型显存 8GB 以上可以跑ollama pull qwen2.5:7b ollama run qwen2.5:7b跑通后输入/bye退出。此时 Ollama 的 OpenAI 兼容接口地址是http://127.0.0.1:11434/v1注意这个/v1后缀很多工具配置时容易漏掉。Ollama 本身不需要 API Key但 OpenClaw 和飞书机器人如果直接连 Ollama就没法同时用云端模型。所以下一步引入 TaoToken 做统一入口。2.2 TaoToken 账号与 API Key 获取TaoToken 的作用是提供一个统一的 API 通道让你用同一个 Key 访问不同模型。先去官网注册https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content注册后在控制台创建 API Keyhttps://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI Key 页面在这里https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content创建后复制 Key格式类似sk-xxxxxxxx。这个 Key 后面会同时用在 OpenClaw 和飞书机器人的配置里。TaoToken 的 API 基础地址是https://taotoken.net/api注意这个地址不带 UTM 参数配置时直接用。模型 ID 可以在模型对话页面查看https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content2.3 OpenClaw 在 Windows 上的安装方式OpenClaw 是一个命令行 AI 编码助手Windows 上推荐用 npm 安装。先确认 Node.js 版本 ≥ 18node -v npm -v然后全局安装npm install -g openclaw安装完成后验证openclaw --version如果提示命令找不到检查 npm 全局路径是否在 PATH 里npm config get prefix把这个路径加到系统环境变量 Path 中重启 PowerShell 即可。OpenClaw 的配置文件默认在用户目录下C:\Users\你的用户名\.openclaw\config.json如果目录不存在手动创建。接下来就是核心配置环节。3. 可复制配置OpenClaw TaoToken Ollama 三件套3.1 OpenClaw 的 config.json 完整片段OpenClaw 支持多 provider 配置。我们要做的是把 TaoToken 作为主 provider同时保留 Ollama 作为本地 fallback。配置文件路径C:\Users\你的用户名\.openclaw\config.json完整内容如下直接复制后替换sk-你的Key{ providers: { taotoken: { type: openai, baseURL: https://taotoken.net/api/v1, apiKey: sk-你的Key, models: { default: claude-sonnet-4-20250514, fast: gpt-4o-mini } }, ollama-local: { type: openai, baseURL: http://127.0.0.1:11434/v1, apiKey: ollama, models: { default: qwen2.5:7b } } }, defaultProvider: taotoken, fallbackProvider: ollama-local }这里三件套齐全Base URL 分别是https://taotoken.net/api/v1和http://127.0.0.1:11434/v1Key 分别是你的 TaoToken Key 和占位符ollamaModel ID 分别是claude-sonnet-4-20250514和qwen2.5:7b。注意 TaoToken 的 baseURL 要带/v1因为 OpenClaw 走的是 OpenAI 兼容协议。3.2 环境变量方式适合不想写配置文件如果你更习惯用环境变量可以在 PowerShell 里设置$env:OPENCLAW_PROVIDERtaotoken $env:OPENCLAW_BASE_URLhttps://taotoken.net/api/v1 $env:OPENCLAW_API_KEYsk-你的Key $env:OPENCLAW_MODELclaude-sonnet-4-20250514要让环境变量永久生效用系统设置或者[Environment]::SetEnvironmentVariable(OPENCLAW_API_KEY,sk-你的Key,User)两种方式选一种即可配置文件方式更适合多 provider 切换。3.3 飞书机器人配置片段飞书机器人这边我们用 webhook 方式接收 OpenClaw 的输出。先在飞书开放平台创建一个自建应用拿到App ID和App Secret然后开启机器人能力。回调地址先填一个占位后面用 ngrok 或本地端口映射补上。飞书机器人的配置文件放在项目目录下比如feishu-bot/config.yamlfeishu: app_id: cli_xxxxxxxx app_secret: xxxxxxxxxxxxxxxx verification_token: xxxxxxxx encrypt_key: xxxxxxxx openclaw: base_url: https://taotoken.net/api/v1 api_key: sk-你的Key model: claude-sonnet-4-20250514 ollama: base_url: http://127.0.0.1:11434/v1 model: qwen2.5:7b这里同样把 TaoToken 的 Base URL、Key、Model ID 三件套写全。飞书机器人收到消息后先判断是走云端还是本地简单问答走 Ollama复杂任务走 TaoToken。3.4 用 CC Switch 管理多套配置如果你同时用 Claude Code、OpenClaw、Cline 等多个工具推荐用 CC Switch 统一管理。CC Switch 的配置文件在C:\Users\你的用户名\.cc-switch\config.json片段如下{ profiles: [ { name: taotoken, baseURL: https://taotoken.net/api/v1, apiKey: sk-你的Key, model: claude-sonnet-4-20250514 }, { name: ollama-local, baseURL: http://127.0.0.1:11434/v1, apiKey: ollama, model: qwen2.5:7b } ], active: taotoken }这样切换 provider 只需要改active字段不用每个工具单独改。4. 验证请求与成功结果4.1 验证 TaoToken 通道连通性先用 curl 验证 TaoToken 的 API 是否通curl -X POST https://taotoken.net/api/v1/chat/completions -H Authorization: Bearer sk-你的Key -H Content-Type: application/json -d { model: claude-sonnet-4-20250514, messages: [{role: user, content: 回复 OK}], max_tokens: 10 }如果返回 JSON 里choices[0].message.content包含OK说明通道正常。如果返回 401检查 Key 是否复制完整如果返回 404检查 baseURL 是否漏了/v1。4.2 验证 Ollama 本地模型curl -X POST http://127.0.0.1:11434/v1/chat/completions -H Content-Type: application/json -d { model: qwen2.5:7b, messages: [{role: user, content: 回复 OK}] }Ollama 不需要 Authorization 头但有些客户端会强制带带个ollama占位符也不会报错。4.3 验证 OpenClaw 调用在 PowerShell 里直接跑openclaw chat 用一句话解释什么是本地部署如果配置正确OpenClaw 会走 TaoToken 返回结果。想测试 fallback把defaultProvider改成ollama-local再跑一次这次会走本地模型。实测下来7B 模型在 16GB 内存的 Windows 机器上响应速度大概 2-3 秒首 token云端模型则取决于网络。4.4 验证飞书机器人消息收发启动飞书机器人服务cd feishu-bot python bot.py然后在飞书里给机器人发一条消息「测试」。机器人会调用 OpenClaw 的接口把结果返回。如果收到回复说明整条链路通了。成功的结果类似用户测试 机器人收到当前使用模型 claude-sonnet-4-20250514通道正常。如果机器人没反应先看本地日志有没有local proxy failed或reading choices相关报错下一节详细讲。5. 本篇常见错误排查5.1 401 Unauthorized这是最常见的错误报错原文{error:{message:Invalid API key,type:invalid_request_error}}原因通常是 Key 复制时带了空格或者用了错误的 Key。检查方法在 PowerShell 里打印 Key 长度$key sk-你的Key $key.Length正常长度在 40-60 之间。另外确认Authorization头格式是Bearer sk-xxx中间有一个空格。5.2 local proxy failed这个报错通常出现在 OpenClaw 启动时Error: local proxy failed to start on port 8080原因是端口被占用。用netstat查netstat -ano | findstr :8080找到 PID 后taskkill /PID xxx /F杀掉或者改 OpenClaw 的代理端口{ proxy: { port: 8081 } }5.3 reading choices 报错报错原文TypeError: Cannot read properties of undefined (reading choices)这说明返回的 JSON 结构不对。常见原因是 baseURL 写成了https://taotoken.net/api而漏了/v1导致请求打到了非兼容端点。改成https://taotoken.net/api/v1即可。另一个原因是模型 ID 写错比如把claude-sonnet-4-20250514写成了claude-sonnet-4服务端返回错误结构。5.4 OAuth 相关报错如果你在飞书机器人里看到OAuth token expired or invalid这是飞书侧的 token 过期不是 TaoToken 的问题。飞书自建应用的tenant_access_token有效期 2 小时需要在代码里做自动刷新。简单做法是用飞书 SDKimport requests def get_tenant_token(app_id, app_secret): url https://open.feishu.cn/open-apis/auth/v3/tenant_access_token/internal resp requests.post(url, json{app_id: app_id, app_secret: app_secret}) return resp.json()[tenant_access_token]每次调用前检查 token 是否过期过期就重新获取。5.5 Ollama 连接被拒绝报错Connection refused: http://127.0.0.1:11434先确认 Ollama 服务在跑Get-Process ollama如果没有手动启动ollama serve另外 Windows 防火墙可能拦了 11434 端口在防火墙里放行即可。6. 统一 Key 接入后的日常使用与 CTA配置跑通后日常使用其实很简单OpenClaw 里直接openclaw chat 你的问题飞书里直接给机器人发消息Ollama 本地模型作为离线 fallback 自动接管。TaoToken 的统一 Key 让你不用在多个工具之间来回改配置改一处config.json就全生效。如果你主要做编码和 Agent 任务建议用 Coding Plan额度更划算https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content想先验证模型效果去模型对话页面直接试https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content接入文档在这里遇到配置问题可以对照https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content最后提醒一个实际踩过的坑Windows 上路径分隔符和 Linux 不同配置文件里的路径要用双反斜杠\\或者正斜杠/否则 JSON 解析会报错。另外 Ollama 的模型文件默认存在C:\Users\你的用户名\.ollama\models如果 C 盘空间紧张可以用环境变量OLLAMA_MODELS改到其他盘。

读完文章,也想定制专属网站?

尧图设计师 24 小时内与您沟通定制方案

免费获取报价 →
↑