1. 为什么我劝你先搞清楚 OpenClaw 到底在装什么OpenClaw命令行里叫openclaw-cn是一个跑在你自己电脑上的机器人网关它能把你常用的聊天工具飞书、Telegram 等和各家大模型 API 接起来让机器人在群里或私聊里回答问题、读文件、执行一些你授权的操作。适合谁适合想自己搭一个「私人助理机器人」、又不想从零写代码的零基础用户。这篇就按 Windows PowerShell 环境把安装、配置 API Key、接入飞书机器人、验证响应这一整条链路走完中间会用到 TaoToken 作为统一模型通道省得你一个个去申请各家 Key。先说清楚一个容易踩的坑OpenClaw 本身不是模型它只是个「调度员」。你给它一个 API Key它才知道去调哪个模型。所以安装完不配 Key机器人是哑巴的。很多人卡在「装完了但机器人不回话」八成就是这一步没做。另外提醒一句OpenClaw 官方自己也标注了这是测试阶段的项目启用工具后机器人能读文件、执行操作所以安全设置别偷懒。下面每一步我都尽量给全命令和参数你照着敲就行。2. 装之前先把 TaoToken 的 Key 和通道准备好TaoToken 在这里的角色是「统一模型通道」你不用分别去 DeepSeek、Moonshot、Qwen 各家注册只要在 TaoToken 拿一个 API Key就能通过同一个接口地址调用多个模型。对新手来说少注册几个平台就少踩几个坑。你需要准备两样东西第一是 API Key。登录 TaoToken 官网https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content进控制台后到 API Keys 页面创建一个新 Key复制出来先存到记事本里后面配置要用。创建入口在这里https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite第二是接口地址。TaoToken 的 API 基址是https://taotoken.net/api注意这个地址后面不加任何参数配置时直接填这个就行。注意API Key 相当于你的账户密码别截图发群里也别提交到 Git 仓库。配置进config.toml后这个文件也别随便分享。如果你还没想好要用哪个模型可以先去模型对话页面试一下效果确认能正常出结果再往下走https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite3. PowerShell 安装 openclaw-cn 的完整命令这一章是重点命令我都给全你按顺序来。3.1 确认管理员权限按Win R输入PowerShell回车。先确认自己是不是管理员权限输入[bool](([System.Security.Principal.WindowsIdentity]::GetCurrent()).groups -match S-1-5-32-544)输出True就是管理员可以继续。如果是False关掉窗口右键 PowerShell 选「以管理员身份运行」再重来。3.2 放开脚本执行策略Windows 默认不让跑远程脚本先改一下当前用户的策略Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser提示确认时输入Y回车。这个设置只影响当前用户相对安全。3.3 执行安装脚本iwr -useb https://clawd.org.cn/install.ps1 | iex执行后会弹安全提示输入yes回车确认。然后就是等待家庭网络大概 10 分钟左右期间别关窗口、别断网。这一步会下载依赖慢是正常的。3.4 阅读安全警告并确认安装脚本跑完会显示一段安全警告大意是 OpenClaw 还在测试阶段、启用工具后能读文件执行操作、建议用配对白名单加 提及门控、沙箱加最低权限、机密文件别放在机器人能访问的目录。看完输入Yes继续。它还会建议你定期跑这两条审计命令记下来后面有用openclaw-cn security audit --deep openclaw-cn security audit --fix3.5 选择安装模式引导模式默认是快速安装直接回车。想手动装就按一下向下箭头再回车。新手建议直接回车走快速模式。3.6 模型服务商选择接下来会让你选模型服务商。这里有两个选择选具体服务商推荐用上下方向键移到你想用的那行回车然后按提示填 API Key部分服务商还要填 API Endpoint。暂时跳过光标停在Skip for now直接回车先完成基础安装之后再补。我这次选的是Skip for now因为想统一用 TaoToken 的通道后面手动配更清楚。选完服务商那步选All providers回车。3.7 添加飞书通道出现要秘钥的提示时如果直接返回就按Ctrl C结束当前配置。然后运行专门加通道的命令openclaw-cn channels add输入Yes重新配置通道类型建议选飞书。它会让你去飞书开放平台创建应用地址是https://open.feishu.cn/app。创建流程按飞书页面提示走拿到 App ID 和 App Secret 后填回来。后面有个「是否已完成」的询问移动到已完成回车再出现的提示输入NO安装流程就结束了。3.8 启动网关先看下命令帮助确认装好了openclaw-cn --help然后启动网关openclaw-cn gateway --force--force是强制启动避免端口占用之类的残留问题。4. config.toml 骨架与 TaoToken 通道配置片段安装完的配置文件一般在用户目录下的.openclaw文件夹里文件名是config.toml。你可以用记事本或 VS Code 打开编辑。下面是一个可用的骨架重点是模型通道那段# OpenClaw 主配置 [gateway] port 8080 host 127.0.0.1 # 模型通道统一走 TaoToken [providers.taotoken] type openai-compatible base_url https://taotoken.net/api api_key sk-你从TaoToken复制的Key default_model 你想要的模型名 # 飞书通道 [channels.feishu] enabled true app_id cli_你的AppID app_secret 你的AppSecret几个参数说明一下方便你对照参数作用填什么type接口协议类型TaoToken 兼容 OpenAI 协议填openai-compatiblebase_url接口基址固定https://taotoken.net/apiapi_key身份凭证控制台创建的 Keydefault_model默认模型按你账号可用的模型名填app_id/app_secret飞书应用凭证飞书开放平台创建应用后获取注意base_url后面不要加/v1或斜杠直接就是https://taotoken.net/api多写反而会 404。改完保存重启网关让配置生效openclaw-cn gateway --force如果你后面想换模型或加通道不用重装直接跑openclaw-cn configure重新进配置引导就行。5. 验证请求从命令行到飞书机器人回话配置对不对别猜直接验证。5.1 命令行先测模型通道先确认 TaoToken 通道能通。在网关运行的状态下另开一个 PowerShell 窗口用 curl 测一下curl.exe https://taotoken.net/api/chat/completions -H Authorization: Bearer sk-你的Key -H Content-Type: application/json -d {\model\:\你的模型名\,\messages\:[{\role\:\user\,\content\:\你好\}]}返回里有choices字段和一段回复内容说明 Key 和地址都没问题。如果返回 401是 Key 错了返回 404多半是地址写多了路径。5.2 飞书侧验证机器人响应命令行通了再去飞书验证。步骤是在飞书开放平台你的应用里确认「机器人」能力已开启并且把应用发布到你的组织或测试企业。然后在飞书里找到这个机器人发一条消息比如「你好」。如果配置正确机器人会调用模型并回复。如果机器人不回话按这个顺序查网关窗口有没有报错日志、config.toml里飞书的app_id和app_secret有没有填错、飞书应用的事件订阅地址有没有配成你网关的公网地址。本地网关默认是127.0.0.1飞书服务器访问不到需要你把网关暴露到一个可访问的地址或者用飞书的长连接模式如果 OpenClaw 支持的话。5.3 成功的样子一切正常时你在飞书发消息几秒内机器人就会回复。网关窗口会打印出请求日志包含调用的模型和耗时。看到这个整条链路就通了。6. 本篇常见报错排查装的过程中最容易卡在这几个地方我按现象给你对应解法。报错一Set-ExecutionPolicy提示拒绝访问。说明你不是管理员权限回到 3.1 步用管理员身份重开 PowerShell。报错二安装脚本卡住不动。大概率是网络问题脚本在下载依赖。等够 10 分钟别急着关。如果超过 15 分钟还没动静检查网络后重跑安装命令。报错三openclaw-cn不是内部或外部命令。说明安装没成功或者环境变量没生效。关掉 PowerShell 重开一个窗口再试还不行就重跑安装脚本。报错四网关启动报端口占用。加--force参数或者改config.toml里的port换一个端口。报错五飞书机器人不回话。先看网关日志有没有收到请求。没收到就是飞书事件订阅没配好收到了但报错多半是 API Key 或模型名不对。回到第 5 章的命令行测试先确认模型通道是通的。报错六返回 401 Unauthorized。Key 错了或者过期了去 TaoToken 控制台重新创建一个https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite排查时记住一个原则先命令行、后飞书。命令行通了问题一定在飞书侧命令行不通问题在 Key 或地址。7. 接下来怎么走按你的目标选通道装完只是起点后面怎么用取决于你的目标。如果你主要是想验证模型效果、试试不同模型的回答质量直接去模型对话页面玩就行不用折腾本地配置https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite如果你打算长期跑编码任务、做 Agent 自动化那建议了解一下 Coding Plan它在调用额度和通道稳定性上更适合高频使用场景https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite如果你在接入过程中遇到具体的接口报错、参数对不上接入文档里有完整的字段说明和示例对着查最快https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite最后说个我自己的习惯每次改完config.toml先跑一遍openclaw-cn security audit --deep确认没有把不该暴露的目录或权限开出去再启动网关。机器人能读文件这件事方便和风险是一体两面配置时多花两分钟后面省心很多。
