尧图网站建设 
1. 从零部署 OpenClaw 的真实场景与核心检索词OpenClaw 是一个开源 AI 智能体项目社区里习惯叫它“小龙虾”。它能做什么简单说它把大模型的“思考”和本地电脑的“执行”连在一起你发一条消息它拆解任务、调用工具、操作文件、跑脚本最后把结果回给你。适合谁适合想在自己电脑上养一个“数字员工”的开发者尤其是需要接入飞书、Kimi、DeepSeek 这类国内常用服务的场景。我第一次装 OpenClaw 的时候卡在模型配置上整整一个下午。原因很典型Base URL 写错、API Key 格式不对、网关没启动就去开 dashboard结果页面一直转圈。后来把 settings 改到 TaoToken 统一入口Kimi 和 DeepSeek 两个模型共用一套 Key 管理才把链路跑通。这篇就按“安装 → 配置 → API → 启动 → 更新 → 卸载 → Skills → 飞书”的顺序把每一步的可复制命令和验证动作写清楚。核心检索词先摆出来OpenClaw 安装配置、Kimi API 接入、DeepSeek API 接入、OpenClaw Skills 安装、OpenClaw 飞书机器人对接。这几个词基本覆盖了首次部署会搜到的所有问题。下面所有命令都在 Windows PowerShell 实测过macOS/Linux 把路径换成对应目录即可。先说清楚整体链路安装 OpenClaw CLI → 配置模型 APIKimi DeepSeek→ 启动网关 → 打开 dashboard 或 tui → 安装 Skills → 接入飞书。每一步都有验证动作不要跳步。尤其是网关它是 OpenClaw 的后台服务所有交互都依赖它先跑起来。很多人 dashboard 打不开90% 是网关没启动。2. TaoToken 前置准备统一 Key 接入 Kimi 与 DeepSeek在配置模型之前先把 API Key 的事情理清楚。OpenClaw 本身不提供模型它需要你填一个兼容 OpenAI 协议的 Base URL 和 API Key。你可以分别去 Kimi 开放平台和 DeepSeek 开放平台各申请一个 Key也可以用一个统一入口来管理。我实测下来用 TaoToken 做统一接入更省事一个 Key 同时调 Kimi 和 DeepSeek切换模型只改 Model ID不用来回换 Key。TaoToken 的 API 地址是https://taotoken.net/api注意这个地址不带任何查询参数。官网入口是https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end注册后在控制台创建 API Key。创建路径登录官网 → 进入 console → API Keys → 新建 Key → 复制保存。这个 Key 就是后面 settings 里要填的apiKey。为什么推荐统一入口因为 OpenClaw 的模型配置里Base URL 和 Key 是绑在一起的。如果你用 Kimi 官方地址Key 就得用 Kimi 的换 DeepSeek 就得改两处。用 TaoToken 之后Base URL 固定为https://taotoken.net/apiKey 固定为同一个只需要在 Model ID 里写kimi-k2或deepseek-chat就能切换。对于“养龙虾”这种需要频繁试不同模型的场景省下的时间很可观。这里要提醒一个坑TaoToken 的 Base URL 结尾是/api不是/v1。有些教程会让你填https://api.deepseek.com/v1那是 DeepSeek 官方地址的写法。如果你用 TaoToken就统一填https://taotoken.net/apiOpenClaw 会自动补全路径。填错的话请求会返回 404 或 401后面排障章节会详细说。另外Kimi 和 DeepSeek 的计费方式都是按 tokens 计费不需要包月。Kimi 有按月套餐但 OpenClaw 场景下按量付费更灵活。你可以在 TaoToken 控制台看到每个模型的用量和余额避免某个月突然超支。准备好 Key 之后就可以进入安装环节了。3. 可复制配置settings 文件与模型参数完整片段OpenClaw 的配置分两层全局配置在~/.openclaw/openclaw.json模型配置在~/.openclaw/agents/main/agent/models.json。Windows 下路径是C:\Users\你的用户名\.openclaw\。下面给出可直接复制的 JSON 片段路径和原文一致。先看模型配置文件models.json这是核心。它定义了 OpenClaw 调用哪个模型、走哪个 Base URL、用哪个 Key{ models: [ { id: kimi-k2, name: Kimi K2, provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, model: kimi-k2, maxTokens: 8192, temperature: 0.7 }, { id: deepseek-chat, name: DeepSeek Chat, provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, model: deepseek-chat, maxTokens: 8192, temperature: 0.7 } ], defaultModel: deepseek-chat }三个关键字段必须写全Base URL、API Key、Model ID。Base URL 统一用https://taotoken.net/apiAPI Key 填你在 TaoToken 控制台创建的那个Model ID 分别写kimi-k2和deepseek-chat。provider写openai-compatible因为 TaoToken 兼容 OpenAI 协议。再看全局配置openclaw.json主要配网关和工作区{ gateway: { host: 127.0.0.1, port: 18789, autoStart: true }, workspace: C:\\Users\\你的用户名\\.openclaw\\workspace, defaultAgent: main, skills: { autoLoad: true, directory: C:\\Users\\你的用户名\\.openclaw\\skills } }如果你不想手动改 JSON可以用交互式命令openclaw configure它会一步步问你 Base URL、API Key、Model ID。但交互式配置有时候会“自动检测”端点检测失败就卡住。我建议直接改models.json改完重启网关最稳。配置完成后验证文件是否写对用type命令Windows或catmacOS/Linux查看models.json内容确认没有多余逗号、引号闭合。JSON 格式错误会导致网关启动失败报错通常是Unexpected token或JSON parse error。还有一个细节maxTokens不要设太大。OpenClaw 的上下文窗口有限设 8192 比较安全。如果你用 Kimi K2 这种长上下文模型可以适当调高但要注意 token 消耗。temperature保持 0.7 即可太高会让 Agent 决策不稳定。4. 验证请求启动日志、模型连通性与飞书回执配置写完后按顺序执行以下命令每一步都要看到预期结果再继续。第一步启动网关openclaw gateway start预期输出会显示Gateway started on 127.0.0.1:18789。如果报错port already in use说明 18789 被占用用openclaw gateway stop先停掉或者改openclaw.json里的端口。第二步检查网关状态openclaw gateway status看到running就对了。如果显示stopped去看日志~/.openclaw/logs/目录下最新的 log 文件搜error关键字。第三步测试模型连通性。用 agent 命令发一条消息openclaw agent --message 你好请回复你的模型名称如果配置正确会返回类似我是 DeepSeek Chat的回复。如果返回 401说明 API Key 无效返回 404说明 Base URL 写错返回reading choices错误说明响应格式不兼容检查provider是否写了openai-compatible。第四步打开 dashboardopenclaw dashboard浏览器会自动打开http://127.0.0.1:18789/。如果页面空白或转圈先确认网关在运行再检查浏览器控制台有没有跨域报错。dashboard 里可以切换模型、查看会话、管理 Skills。第五步接入飞书。OpenClaw 支持通过 Channels 接入飞书机器人。在 dashboard 左侧菜单找到 Channels选择 Feishu填入飞书机器人的 App ID 和 App Secret。飞书开放平台创建机器人后把事件订阅地址填成你的网关公网地址本地测试可以用内网穿透但注意安全。配置完成后在飞书里给机器人发一条消息比如“帮我查一下今天的天气”如果收到回执说明链路通了。飞书接入的验证动作发消息后看 dashboard 的会话列表是否出现新会话看网关日志是否有Feishu message received。如果飞书没反应检查事件订阅是否验证通过以及机器人是否被添加到了群组。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth这一节按真实报错来。你遇到问题时先对照下面的错误信息再按步骤排查。401 Unauthorized最常见。原因有三个API Key 填错、Key 被删除、余额不足。排查动作登录 TaoToken 控制台确认 Key 还在、余额充足然后检查models.json里的apiKey字段注意不要有多余空格。如果 Key 是刚创建的等 1 分钟再试有时候有缓存。local proxy failed这个错误通常出现在网关启动时。原因是本地代理配置冲突或者端口被占用。排查动作检查系统环境变量里有没有HTTP_PROXY、HTTPS_PROXY有的话临时清掉然后openclaw gateway stop再start。如果还不行改openclaw.json里的端口为 18790 再试。reading choices 报错完整报错通常是Cannot read properties of undefined (reading choices)。这说明模型返回的 JSON 结构不符合 OpenAI 格式。排查动作确认provider写的是openai-compatibleBase URL 是https://taotoken.net/apiModel ID 拼写正确。如果用的是 KimiModel ID 写kimi-k2不要写moonshot-v1。OAuth 相关错误如果你在配置飞书或 GitHub 技能时看到 OAuth 报错检查回调地址是否和开放平台配置的一致。飞书机器人的回调地址必须和网关地址匹配本地测试时端口要一致。ClawHub Rate limit exceeded安装 Skills 时遇到限流。原因是 ClawHub 服务器在海外国内访问频率受限。解决办法用 SkillHub 替代或者clawhub login登录 GitHub 提升限额。SkillHub 的安装方式是在 OpenClaw 聊天框输入安装提示词它会自动部署。CC Switch / Cline MCP / Codex auth.json 三件套如果你在 OpenClaw 里用这些工具配置时必须写全 Base URL、API Key、Model ID。以 Cline MCP 为例settings.json里要有baseUrl、apiKey、model三个字段缺一个就连不上。Codex 的auth.json同理OPENAI_BASE_URL填https://taotoken.net/apiOPENAI_API_KEY填 TaoToken Key。排障通用思路先看日志再看配置最后测连通性。日志在~/.openclaw/logs/配置在~/.openclaw/openclaw.json和models.json连通性用openclaw agent --message测。6. Skills 扩展与飞书机器人从安装到长期运行Skills 是 OpenClaw 的“手脚”。没有 Skills它只能聊天装上 Skills它才能搜索网页、生成日报、操作文件。安装技能管理工具npm install -g clawhub然后搜索和安装技能clawhub search 日报 clawhub install daily-report openclaw gateway restart重启网关后新技能才会加载。验证技能是否生效在 dashboard 里发“帮我生成今天的日报”如果返回结构化内容说明技能在工作。推荐几个必装技能tavily-search让 AI 能联网查最新信息summarize总结长文find-skills自动推荐缺失技能。Tavily 需要 API Key去 Tavily 官网注册后获取然后在 OpenClaw 里设置环境变量TAVILY_API_KEY。飞书接入的完整流程在飞书开放平台创建企业自建应用 → 开启机器人能力 → 配置事件订阅 → 把 App ID 和 App Secret 填入 OpenClaw 的 Channels 配置 → 重启网关 → 在飞书里发消息测试。如果飞书机器人没响应检查事件订阅的请求地址是否可达以及是否订阅了im.message.receive_v1事件。长期运行建议把 OpenClaw 网关设为开机自启。Windows 下可以用任务计划程序macOS/Linux 用 systemd 或 launchd。另外定期更新 OpenClawnpm install -g openclawlatest openclaw gateway restart更新后如果配置格式变了参考官方迁移文档调整models.json。卸载的话先openclaw uninstall --all --yes --non-interactive再npm uninstall -g openclaw最后删掉~/.openclaw目录。最后说一个实用技巧把常用操作写成 Skills 的SKILL.md放在~/.openclaw/skills/下。比如你每天要发飞书日报就写一个daily-report技能定义触发词和执行步骤。OpenClaw 加载后你只要说“发日报”它就会自动执行。这就是“养龙虾”的核心越用越懂你。如果你在配置过程中遇到模型切换问题可以去 TaoToken 的模型对话页面直接测试 Key 是否可用长期编码或 Agent 场景可以了解 Coding Plan接入文档在 doc 页面API Keys 在 console 页面管理。把 settings 改到 TaoToken 之后Kimi 和 DeepSeek 双模型切换只需要改一个 Model ID这是实测下来最省心的方案。 【OpenClaw】安装 + 配置 + API（Kimi + DeepSeek） + 启动 + 更新 + 卸载 + Skills + 飞书：把 settings 改到 TaoToken
1. 从零部署 OpenClaw 的真实场景与核心检索词OpenClaw 是一个开源 AI 智能体项目社区里习惯叫它“小龙虾”。它能做什么简单说它把大模型的“思考”和本地电脑的“执行”连在一起你发一条消息它拆解任务、调用工具、操作文件、跑脚本最后把结果回给你。适合谁适合想在自己电脑上养一个“数字员工”的开发者尤其是需要接入飞书、Kimi、DeepSeek 这类国内常用服务的场景。我第一次装 OpenClaw 的时候卡在模型配置上整整一个下午。原因很典型Base URL 写错、API Key 格式不对、网关没启动就去开 dashboard结果页面一直转圈。后来把 settings 改到 TaoToken 统一入口Kimi 和 DeepSeek 两个模型共用一套 Key 管理才把链路跑通。这篇就按“安装 → 配置 → API → 启动 → 更新 → 卸载 → Skills → 飞书”的顺序把每一步的可复制命令和验证动作写清楚。核心检索词先摆出来OpenClaw 安装配置、Kimi API 接入、DeepSeek API 接入、OpenClaw Skills 安装、OpenClaw 飞书机器人对接。这几个词基本覆盖了首次部署会搜到的所有问题。下面所有命令都在 Windows PowerShell 实测过macOS/Linux 把路径换成对应目录即可。先说清楚整体链路安装 OpenClaw CLI → 配置模型 APIKimi DeepSeek→ 启动网关 → 打开 dashboard 或 tui → 安装 Skills → 接入飞书。每一步都有验证动作不要跳步。尤其是网关它是 OpenClaw 的后台服务所有交互都依赖它先跑起来。很多人 dashboard 打不开90% 是网关没启动。2. TaoToken 前置准备统一 Key 接入 Kimi 与 DeepSeek在配置模型之前先把 API Key 的事情理清楚。OpenClaw 本身不提供模型它需要你填一个兼容 OpenAI 协议的 Base URL 和 API Key。你可以分别去 Kimi 开放平台和 DeepSeek 开放平台各申请一个 Key也可以用一个统一入口来管理。我实测下来用 TaoToken 做统一接入更省事一个 Key 同时调 Kimi 和 DeepSeek切换模型只改 Model ID不用来回换 Key。TaoToken 的 API 地址是https://taotoken.net/api注意这个地址不带任何查询参数。官网入口是https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end注册后在控制台创建 API Key。创建路径登录官网 → 进入 console → API Keys → 新建 Key → 复制保存。这个 Key 就是后面 settings 里要填的apiKey。为什么推荐统一入口因为 OpenClaw 的模型配置里Base URL 和 Key 是绑在一起的。如果你用 Kimi 官方地址Key 就得用 Kimi 的换 DeepSeek 就得改两处。用 TaoToken 之后Base URL 固定为https://taotoken.net/apiKey 固定为同一个只需要在 Model ID 里写kimi-k2或deepseek-chat就能切换。对于“养龙虾”这种需要频繁试不同模型的场景省下的时间很可观。这里要提醒一个坑TaoToken 的 Base URL 结尾是/api不是/v1。有些教程会让你填https://api.deepseek.com/v1那是 DeepSeek 官方地址的写法。如果你用 TaoToken就统一填https://taotoken.net/apiOpenClaw 会自动补全路径。填错的话请求会返回 404 或 401后面排障章节会详细说。另外Kimi 和 DeepSeek 的计费方式都是按 tokens 计费不需要包月。Kimi 有按月套餐但 OpenClaw 场景下按量付费更灵活。你可以在 TaoToken 控制台看到每个模型的用量和余额避免某个月突然超支。准备好 Key 之后就可以进入安装环节了。3. 可复制配置settings 文件与模型参数完整片段OpenClaw 的配置分两层全局配置在~/.openclaw/openclaw.json模型配置在~/.openclaw/agents/main/agent/models.json。Windows 下路径是C:\Users\你的用户名\.openclaw\。下面给出可直接复制的 JSON 片段路径和原文一致。先看模型配置文件models.json这是核心。它定义了 OpenClaw 调用哪个模型、走哪个 Base URL、用哪个 Key{ models: [ { id: kimi-k2, name: Kimi K2, provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, model: kimi-k2, maxTokens: 8192, temperature: 0.7 }, { id: deepseek-chat, name: DeepSeek Chat, provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, model: deepseek-chat, maxTokens: 8192, temperature: 0.7 } ], defaultModel: deepseek-chat }三个关键字段必须写全Base URL、API Key、Model ID。Base URL 统一用https://taotoken.net/apiAPI Key 填你在 TaoToken 控制台创建的那个Model ID 分别写kimi-k2和deepseek-chat。provider写openai-compatible因为 TaoToken 兼容 OpenAI 协议。再看全局配置openclaw.json主要配网关和工作区{ gateway: { host: 127.0.0.1, port: 18789, autoStart: true }, workspace: C:\\Users\\你的用户名\\.openclaw\\workspace, defaultAgent: main, skills: { autoLoad: true, directory: C:\\Users\\你的用户名\\.openclaw\\skills } }如果你不想手动改 JSON可以用交互式命令openclaw configure它会一步步问你 Base URL、API Key、Model ID。但交互式配置有时候会“自动检测”端点检测失败就卡住。我建议直接改models.json改完重启网关最稳。配置完成后验证文件是否写对用type命令Windows或catmacOS/Linux查看models.json内容确认没有多余逗号、引号闭合。JSON 格式错误会导致网关启动失败报错通常是Unexpected token或JSON parse error。还有一个细节maxTokens不要设太大。OpenClaw 的上下文窗口有限设 8192 比较安全。如果你用 Kimi K2 这种长上下文模型可以适当调高但要注意 token 消耗。temperature保持 0.7 即可太高会让 Agent 决策不稳定。4. 验证请求启动日志、模型连通性与飞书回执配置写完后按顺序执行以下命令每一步都要看到预期结果再继续。第一步启动网关openclaw gateway start预期输出会显示Gateway started on 127.0.0.1:18789。如果报错port already in use说明 18789 被占用用openclaw gateway stop先停掉或者改openclaw.json里的端口。第二步检查网关状态openclaw gateway status看到running就对了。如果显示stopped去看日志~/.openclaw/logs/目录下最新的 log 文件搜error关键字。第三步测试模型连通性。用 agent 命令发一条消息openclaw agent --message 你好请回复你的模型名称如果配置正确会返回类似我是 DeepSeek Chat的回复。如果返回 401说明 API Key 无效返回 404说明 Base URL 写错返回reading choices错误说明响应格式不兼容检查provider是否写了openai-compatible。第四步打开 dashboardopenclaw dashboard浏览器会自动打开http://127.0.0.1:18789/。如果页面空白或转圈先确认网关在运行再检查浏览器控制台有没有跨域报错。dashboard 里可以切换模型、查看会话、管理 Skills。第五步接入飞书。OpenClaw 支持通过 Channels 接入飞书机器人。在 dashboard 左侧菜单找到 Channels选择 Feishu填入飞书机器人的 App ID 和 App Secret。飞书开放平台创建机器人后把事件订阅地址填成你的网关公网地址本地测试可以用内网穿透但注意安全。配置完成后在飞书里给机器人发一条消息比如“帮我查一下今天的天气”如果收到回执说明链路通了。飞书接入的验证动作发消息后看 dashboard 的会话列表是否出现新会话看网关日志是否有Feishu message received。如果飞书没反应检查事件订阅是否验证通过以及机器人是否被添加到了群组。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth这一节按真实报错来。你遇到问题时先对照下面的错误信息再按步骤排查。401 Unauthorized最常见。原因有三个API Key 填错、Key 被删除、余额不足。排查动作登录 TaoToken 控制台确认 Key 还在、余额充足然后检查models.json里的apiKey字段注意不要有多余空格。如果 Key 是刚创建的等 1 分钟再试有时候有缓存。local proxy failed这个错误通常出现在网关启动时。原因是本地代理配置冲突或者端口被占用。排查动作检查系统环境变量里有没有HTTP_PROXY、HTTPS_PROXY有的话临时清掉然后openclaw gateway stop再start。如果还不行改openclaw.json里的端口为 18790 再试。reading choices 报错完整报错通常是Cannot read properties of undefined (reading choices)。这说明模型返回的 JSON 结构不符合 OpenAI 格式。排查动作确认provider写的是openai-compatibleBase URL 是https://taotoken.net/apiModel ID 拼写正确。如果用的是 KimiModel ID 写kimi-k2不要写moonshot-v1。OAuth 相关错误如果你在配置飞书或 GitHub 技能时看到 OAuth 报错检查回调地址是否和开放平台配置的一致。飞书机器人的回调地址必须和网关地址匹配本地测试时端口要一致。ClawHub Rate limit exceeded安装 Skills 时遇到限流。原因是 ClawHub 服务器在海外国内访问频率受限。解决办法用 SkillHub 替代或者clawhub login登录 GitHub 提升限额。SkillHub 的安装方式是在 OpenClaw 聊天框输入安装提示词它会自动部署。CC Switch / Cline MCP / Codex auth.json 三件套如果你在 OpenClaw 里用这些工具配置时必须写全 Base URL、API Key、Model ID。以 Cline MCP 为例settings.json里要有baseUrl、apiKey、model三个字段缺一个就连不上。Codex 的auth.json同理OPENAI_BASE_URL填https://taotoken.net/apiOPENAI_API_KEY填 TaoToken Key。排障通用思路先看日志再看配置最后测连通性。日志在~/.openclaw/logs/配置在~/.openclaw/openclaw.json和models.json连通性用openclaw agent --message测。6. Skills 扩展与飞书机器人从安装到长期运行Skills 是 OpenClaw 的“手脚”。没有 Skills它只能聊天装上 Skills它才能搜索网页、生成日报、操作文件。安装技能管理工具npm install -g clawhub然后搜索和安装技能clawhub search 日报 clawhub install daily-report openclaw gateway restart重启网关后新技能才会加载。验证技能是否生效在 dashboard 里发“帮我生成今天的日报”如果返回结构化内容说明技能在工作。推荐几个必装技能tavily-search让 AI 能联网查最新信息summarize总结长文find-skills自动推荐缺失技能。Tavily 需要 API Key去 Tavily 官网注册后获取然后在 OpenClaw 里设置环境变量TAVILY_API_KEY。飞书接入的完整流程在飞书开放平台创建企业自建应用 → 开启机器人能力 → 配置事件订阅 → 把 App ID 和 App Secret 填入 OpenClaw 的 Channels 配置 → 重启网关 → 在飞书里发消息测试。如果飞书机器人没响应检查事件订阅的请求地址是否可达以及是否订阅了im.message.receive_v1事件。长期运行建议把 OpenClaw 网关设为开机自启。Windows 下可以用任务计划程序macOS/Linux 用 systemd 或 launchd。另外定期更新 OpenClawnpm install -g openclawlatest openclaw gateway restart更新后如果配置格式变了参考官方迁移文档调整models.json。卸载的话先openclaw uninstall --all --yes --non-interactive再npm uninstall -g openclaw最后删掉~/.openclaw目录。最后说一个实用技巧把常用操作写成 Skills 的SKILL.md放在~/.openclaw/skills/下。比如你每天要发飞书日报就写一个daily-report技能定义触发词和执行步骤。OpenClaw 加载后你只要说“发日报”它就会自动执行。这就是“养龙虾”的核心越用越懂你。如果你在配置过程中遇到模型切换问题可以去 TaoToken 的模型对话页面直接测试 Key 是否可用长期编码或 Agent 场景可以了解 Coding Plan接入文档在 doc 页面API Keys 在 console 页面管理。把 settings 改到 TaoToken 之后Kimi 和 DeepSeek 双模型切换只需要改一个 Model ID这是实测下来最省心的方案。