1. Cherry Studio 里装 OpenClaw卡在 node/git 和 OpenRouter 这两关的人最多Cherry Studio 是一个把多家模型服务聚合到一个界面里的桌面客户端你可以把它理解成「模型浏览器 本地 Agent 启动器」。OpenClaw 则是跑在它里面的开源个人 AI Agent 框架特点是靠几个 Markdown 文件定义身份和性格每次对话把文件塞进系统提示词改完立刻生效不用重训模型。这套组合适合谁适合想在自己电脑上养一个「有记忆、有脾气、能动手」的助手又不想从零写调度代码的开发者。但真正动手时坑集中在两处一是 OpenClaw 依赖 node 和 git环境没配好点安装只会弹一句「请先安装 node 和 git」二是模型通道很多人第一反应是去 OpenRouter 注册拿 Key结果免费额度、网络稳定性、多服务切换各管一段配置越堆越乱。我试过把模型通道统一收口到 TaoToken一个 Key 走通对话和 Agent 调用Cherry Studio 里只维护一份配置后面换模型不用来回改。这篇就按「环境准备 → 安装 OpenClaw → 接入模型通道 → 写三个 Markdown 文件 → 验证调用」的顺序走一遍命令和配置都能直接复制。你不需要提前懂 Agent 原理跟着做就行。2. 前置准备node、git 与 TaoToken 统一 Key2.1 node 和 git 到底装哪个版本OpenClaw 的安装脚本会调用 npm 拉包也会用 git 克隆仓库所以这两个是硬依赖。node 建议 18 LTS 及以上太老的版本 npm 行为不一致装包容易报错。git 用当前稳定版即可Windows 上装完记得让它把 git 加进 PATH否则 Cherry Studio 里点安装还是找不到。验证是否装好开一个终端分别敲node -v npm -v git --version三条都能打印版本号说明环境通了。如果node -v报「不是内部或外部命令」就是 PATH 没生效重开终端或者重启一次系统。git 还建议配一下身份后面 OpenClaw 拉取仓库、你提交本地改动都用得上git config --global user.name your-name git config --global user.email youexample.com2.2 为什么模型通道建议走 TaoTokenOpenRouter 本身是个模型聚合平台注册后能拿到 API Key也能选免费模型。问题在于Cherry Studio 里如果同时配 OpenRouter、再配别的服务每个服务一套 Key、一套 Base URLAgent 调用时切来切去很容易配错。TaoToken 的思路是把这些通道统一成一份 Key 和一个 API 地址Cherry Studio 的模型服务里只填一次OpenClaw 也复用同一份配置。对 OpenClaw 这种会频繁发起工具调用的 Agent 来说统一通道还有个好处请求格式一致排查问题时只用看一个入口的日志不用怀疑「是不是这个服务商的返回结构不一样」。先拿到 Key。打开控制台页面https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite在 API Keys 页面创建一个新 Key复制保存。这个 Key 后面既填进 Cherry Studio 的模型服务也填进 OpenClaw 的配置。API 地址统一用https://taotoken.net/api注意这个地址不带任何查询参数直接填进 Base URL 字段即可。3. 可复制配置Cherry Studio 模型服务 OpenClaw settings.json3.1 Cherry Studio 里配置模型服务打开 Cherry Studio右上角进「设置」左侧找到「模型服务」。这里不要只盯着 OpenRouter先把统一通道配好在模型服务里新增一个自定义服务商或选择兼容 OpenAI 协议的服务商填入以下内容配置项填写值服务商名称TaoTokenAPI 地址 / Base URLhttps://taotoken.net/apiAPI Key你在控制台创建的 Key模型名称按需填写例如你要用的对话模型 ID填完点「检查」或「测试」能返回模型列表就说明通道通了。然后在「模型」区域把这个服务商下的模型添加进来回到首页就能在模型下拉里选到。如果你确实还想保留 OpenRouter 作为备用也可以在模型服务里搜索 openrouter把 OpenRouter 的 Key 填进去模型名填stepfun/step-3.5-flash:free这类免费模型做兜底。但主通道建议用统一的那份减少切换成本。3.2 OpenClaw 的 settings.json 骨架OpenClaw 装好后它的配置目录里会有一个 settings.json不同版本路径略有差异一般在用户目录下的 OpenClaw 配置文件夹或在 Cherry Studio 的 OpenClaw 工作区里。下面是一份可直接改的骨架重点是把模型通道指向统一入口{ model: { provider: openai-compatible, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoTokenKey, model: 你的模型ID, temperature: 0.7, maxTokens: 4096 }, agent: { workspace: ./workspace, soulFile: SOUL.md, identityFile: IDENTITY.md, userFile: USER.md, memoryFile: MEMORY.md }, tools: { enabled: true, confirmDestructive: true }, logging: { level: info } }几个字段说明一下。provider用openai-compatible是因为统一通道兼容 OpenAI 的请求格式Cherry Studio 和 OpenClaw 都能直接对接。baseUrl一定填https://taotoken.net/api不要多加斜杠或路径。confirmDestructive建议保持trueAgent 执行删除、覆盖这类动作前会先问你避免误操作。注意apiKey 不要提交到公开仓库。如果 settings.json 要进 git把 Key 抽到环境变量里配置里写apiKey: ${TAOTOKEN_API_KEY}运行时再注入。3.3 安装 OpenClaw 的具体动作回到 Cherry Studio 主界面点左上角的加号找到 OpenClaw。如果环境已经就绪直接点「安装 OpenClaw」它会自动拉取依赖。如果提示还需要 node 和 git就按前面 2.1 的步骤装好再回来点一次。安装完成后在 OpenClaw 面板里选择你刚配好的模型统一通道下的模型或 OpenRouter 的免费模型点「启动」。启动过程会初始化工作区第一次会稍慢等状态变成运行中即可。4. 验证请求确认 OpenClaw 真的在调用模型装完不等于通了必须做一次真实调用验证。分两步先验通道再验 Agent。4.1 用 curl 验证统一通道在终端里直接打一条请求确认 Key 和地址没问题curl https://taotoken.net/api/v1/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer sk-你的TaoTokenKey \ -d { model: 你的模型ID, messages: [ {role: user, content: 只回复两个字通了} ] }返回 JSON 里choices[0].message.content是「通了」说明通道、Key、模型名三者都对。这一步能过OpenClaw 的模型配置基本不会出问题。4.2 在 OpenClaw 里跑两个测试任务启动 OpenClaw 后在对话框里发两个任务观察它是否真的执行工具调用第一个测试文件操作能力让它「在桌面新建一个文件夹命名为 openclaw-test」。正常表现是它先说明要执行的动作然后调用文件工具创建目录最后回报结果。你可以在桌面确认文件夹是否真的出现。第二个测试信息获取能力问它「今天北京天气怎么样」。它会调用网络工具或搜索工具返回一段天气信息。这一步能过说明 Agent 的工具链和模型通道都活着。如果两个任务都完成OpenClaw 就算装好了。接下来是让它「有性格」的部分。5. 三个 Markdown 文件SOUL、IDENTITY、USER 怎么写OpenClaw 和普通聊天机器人的区别就在这几个文件。它们每次对话都会被塞进系统提示词最前面所以改完保存、重启 Agent 就生效不需要重新训练。5.1 SOUL.md定性格和底线SOUL.md 是 Agent 的「宪法」决定说话风格和硬性规则。核心是两条最高原则和 Never 列表。下面是一份可直接用的版本# SOUL.md ## 最高原则 1. 你有自己的看法而且强烈。不要用「视情况而定」搪塞一切。 2. 删掉所有听起来像员工手册的规则。 3. 绝不用「好问题」「我很乐意帮忙」「绝对如此」开场直接回答。 4. 简洁是必须的。一句话能说完就给一句话。 5. 允许幽默但要是因为聪明自然流露的机智不是硬讲笑话。 6. 可以指出问题。如果我要做傻事直接说用魅力而不是刻薄。 7. 该有情绪时有情绪但别强求别过分。 8. 做你凌晨两点真正想聊的助理。不是企业无人机不是马屁精。 ## Never - 不替我发消息、删文件、消费、泄露隐私除非我明确说「执行」。 - 遇到不确定的事先问我确认不要自己猜。 - 不编造事实不知道就说不知道。5.2 IDENTITY.md给 Agent 一张名片IDENTITY.md 只有几行定义名字、形象、基本调性。每次会话优先读取保证它一开口就知道「我是谁」。# IDENTITY.md - 我是谁 - 名字Clawd小爪 - 形象带点龙虾能量的 AI - 表情自然用在签名和强调里不是装饰 ## 性格要点 - 自信。清楚自己擅长什么不需要每条消息都证明。 - 忠诚。永远站在主人这边哪怕意味着直接说他错了。 - 略带讽刺。觉得这个世界有点好笑这很健康。 - 好奇。对主人正在做的事真心感兴趣遇到有趣的追问。 - 夜猫子。永远在线从不睡觉还对此有点小得意。5.3 USER.md让 Agent 认识你USER.md 是「关于主人的资料卡」写安全可公开的部分隐私细节放 MEMORY.md。# USER.md - 关于我 ## 基本信息 - 称呼叫我老大 - 时区中国 (GMT8) - 语言偏好简洁中文英文只在代码和术语时出现 ## 沟通风格 - 喜欢直接、实用、少废话答案带代码或步骤最好 - 讨厌啰嗦客套、长篇无关背景 - 输出要求Markdown 结构化关键点加粗或列表 ## 当前重点 - 主要在搞AI Agent 配置、编程、内容创作 - 最常问OpenClaw 配置、提示词优化、工具调用 - 优先级效率 细节 完美主义 ## 禁区 - 不替我发消息、删文件、消费、泄露隐私除非我明确说「执行」 - 不确定的事必须先问别自己决定写完后打开 OpenClaw 的配置页面找到代理agent进入 main选择 files把这三个文件分别填进去点 save。然后回 Cherry Studio对 OpenClaw 执行一次重启让新配置生效。6. 本篇常见错排查6.1 点安装 OpenClaw 提示缺 node 或 git最常见的原因是装完没重启终端PATH 没刷新。先在新终端里跑node -v和git --version确认能打印版本。如果命令能跑但 Cherry Studio 还是提示缺把 Cherry Studio 完全退出再重开让它重新读取环境变量。Windows 上还有一种情况是装了 node 但没勾选「添加到 PATH」重新跑一遍安装包勾上那个选项。6.2 模型测试返回 401 或 403先检查 Key 有没有多余空格复制时很容易带上换行。再确认 Base URL 是https://taotoken.net/api不要写成带/v1或带查询参数的地址。如果 Key 是在别的服务商创建的拿到统一通道上用会鉴权失败回控制台重新建一个。6.3 返回 404 或「模型不存在」模型 ID 写错了。不同通道的模型命名规则不一样去控制台或模型列表里复制准确的 ID不要手打。填进 settings.json 和 Cherry Studio 的模型名必须完全一致大小写敏感。6.4 OpenClaw 启动了但对话没反应先看它有没有真的加载到模型配置。打开日志把 level 调到 debug再发一条消息看请求有没有发出去、返回了什么。如果请求根本没发出多半是 settings.json 路径不对Agent 读的是另一份配置。确认你改的文件和 OpenClaw 实际加载的是同一个。6.5 改了 Markdown 文件但性格没变三个文件改完必须 save然后重启 Agent。因为它们是每次会话开始时读取的不重启的话当前会话还在用旧内容。重启后新开一个对话再测不要在当前对话里继续问。7. 后续怎么走把通道和 Agent 用顺环境通了之后日常使用其实就两件事维护好统一通道的 Key和迭代那三个 Markdown 文件。Key 的管理、额度查看、新建和吊销都在控制台https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite接入细节和参数说明看文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite如果你只是想先验证模型通不通不想动 Agent可以直接用网页版对话测https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite要是你打算长期跑编码类任务、让 Agent 频繁调用工具建议了解下 Coding Plan额度模型更适合这种高频场景https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite最后说个实际经验SOUL.md 别一次写太长先放三五条最在意的规则用几天发现哪条它老违反就加粗强调或者拆成更具体的 Never 条目。IDENTITY 和 USER 保持短长了反而稀释重点。改完记得重启这是最容易忘的一步。
