1. openclaw 连接 shopify 到底卡在哪
openclaw 是一个把本地工作流和外部数据源串起来的自动化框架，你可以把它理解成一个「本地调度中枢」：它负责按你的指令去调用各种 skill，把外部系统的数据拉回来，再交给模型或脚本处理。shopify 则是电商侧的数据源，订单、商品、库存、客户这些信息都在它那边。把两者接起来，本质就是让 openclaw 能稳定地拿到 shopify 的数据。
适合谁看这篇：已经在本地把 openclaw 跑起来、能正常执行基础 skill，现在想把 shopify 数据接进工作流的开发者。如果你还没装 openclaw，这篇的配置骨架同样有参考价值，但前置安装步骤需要你先自行补齐。
实际对接时，卡点通常不在 openclaw 本身，而在两处：一是鉴权，shopify 的 Admin API 不是随便一个请求就能读数据，你得先有一个能用的访问令牌；二是通道配置，openclaw 装在 workspace 里时，默认路径下找不到 shopify 这个 skill，需要你显式告诉它去哪找。很多人第一次接的时候，skill 装了但 openclaw 报「找不到」，或者令牌拿到了但请求返回 401，基本都是这两个问题。
这篇会给出可复制的config.toml骨架，把 shopify 的鉴权和通道配置一次性写清楚，再配合 TaoToken 的统一 Key 接入，让你不用在多个平台的密钥之间来回切换。最后附一次连接验证动作，确认 shopify 侧的请求能正常返回数据，而不是停在「配置看起来对但就是不通」的状态。
2. 接入前先把 TaoToken 这层准备好
在写config.toml之前，建议先把模型调用这一层统一掉。openclaw 在工作流里经常需要调用模型来做数据理解、字段映射或者运营建议生成，如果每个环节都单独配一个平台的 Key，管理起来会很碎。TaoToken 的作用就是把这些调用收敛到一个统一 Key 上，openclaw 侧只需要认一个地址和一个 Key。
你需要做的是：先在 TaoToken 控制台创建一个 API Key，这个 Key 后面会写进 openclaw 的配置里。创建入口在控制台的 API Keys 页面，进去之后新建一个，复制出来保存好。注意这个 Key 只在创建时完整显示一次，关掉页面就看不到了，所以复制后先存到安全的地方。
拿到 Key 之后，模型调用的基地址用https://taotoken.net/api，这个地址不加任何额外参数，直接填进配置即可。如果你后面要跑长期编码任务或者 Agent 类的持续工作流，可以了解一下 Coding Plan，它更适合这种需要反复调用、持续运行的场景；如果只是临时验证模型返回是否正常，用模型对话页面手动测一下就行。
这一步的核心目的不是「多一个平台」，而是让 openclaw 在调用模型时有一个稳定的出口。shopify 的鉴权是另一套逻辑，两者不要混在一起配，否则排障时会很难定位到底是哪一层出的问题。
3. 可复制的 config.toml 配置骨架
下面这份骨架是围绕 openclaw 对接 shopify 的场景写的，你可以直接复制后按自己的实际值替换。重点看三个部分：模型通道、shopify skill 路径、shopify 鉴权。
# openclaw 主配置骨架 # 模型调用统一走 TaoToken [model] provider = "taotoken" base_url = "https://taotoken.net/api" api_key = "你的_TAOTOKEN_API_KEY" default_model = "你的默认模型名" # shopify skill 的加载配置 # openclaw 装在 workspace 时，默认扫描路径可能找不到这个 skill [skills.shopify] enabled = true # 显式指定 skill 所在目录，避免「找不到 skill」的报错 path = "./workspace/skills/shopify" # 如果 skill 有入口文件，指向它 entry = "index.js" # shopify Admin API 鉴权 [skills.shopify.auth] # 使用 client credentials flow 自动获取访问令牌 flow = "client_credentials" shop_domain = "你的店铺.myshopify.com" client_id = "你的_client_id" client_secret = "你的_client_secret" # 需要的权限范围，按实际业务勾选 scopes = ["read_orders", "read_products", "read_customers", "read_inventory"]几个关键点说明一下。[model]段里的base_url和api_key就是上一步从 TaoToken 拿到的，openclaw 调模型时会走这里。[skills.shopify]段的path是重点，openclaw 装在 workspace 下时，默认的 skill 扫描目录往往不包含你手动放进去的 shopify skill，所以必须显式写路径，否则它会直接报找不到。[skills.shopify.auth]段用的是 client credentials flow，这是 shopify 侧比较省心的一种方式，不需要你手动去点授权页面，配置好 client_id 和 client_secret 后由程序自动换取访问令牌。
权限范围scopes建议按需勾选，不要一上来就全开。读订单、读商品、读客户、读库存这几个是运营分析最常用的，先配这几个，跑通之后再按需加。
4. 一次连接验证：确认 shopify 请求能返回
配置写完之后不要急着跑完整工作流，先做一次最小验证，确认 shopify 侧的请求能正常返回。这一步能帮你把「配置错误」和「业务逻辑错误」分开。
先验证模型通道是否通：
curl -X POST https://taotoken.net/api/v1/chat/completions \ -H "Authorization: Bearer 你的_TAOTOKEN_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "你的默认模型名", "messages": [{"role": "user", "content": "ping"}] }'如果返回里有正常的choices字段，说明模型通道没问题。接着验证 shopify 鉴权，用 client credentials flow 换令牌：
curl -X POST "https://你的店铺.myshopify.com/admin/oauth/access_token" \ -H "Content-Type: application/json" \ -d '{ "client_id": "你的_client_id", "client_secret": "你的_client_secret", "grant_type": "client_credentials" }'返回里应该有一个access_token字段。拿到令牌后，用它去请求一个最简单的 shopify 接口，比如读店铺信息：
curl -X GET "https://你的店铺.myshopify.com/admin/api/2024-01/shop.json" \ -H "X-Shopify-Access-Token: 上一步拿到的_access_token"如果这一步返回了店铺的 JSON 数据，说明 shopify 侧的鉴权和通道都是通的。这时候再回到 openclaw 里执行 shopify skill，让它去拉订单或商品数据，正常情况下就能拿到真实数据了。我试过在拿到令牌后直接让 openclaw 分析店铺数据，返回的运营建议是基于真实数据的，说明整条链路已经打通。
5. 本篇常见报错排查
报错一：openclaw 提示找不到 shopify skill。这是最常见的问题，原因基本是 skill 装在 workspace 下但没在配置里显式指定路径。检查[skills.shopify]段的path是否指向了实际目录，路径是相对 openclaw 运行目录还是绝对路径，要和你实际启动的位置对上。如果 skill 有入口文件，entry也要写对。
报错二：shopify 请求返回 401。先确认访问令牌是否真的换到了，用第 4 节的 curl 单独测一次。如果令牌能换到但请求还是 401，检查scopes是否包含了你要访问的资源权限，比如读订单就必须有read_orders。另外确认请求头用的是X-Shopify-Access-Token，不是Authorization。
报错三：模型调用返回鉴权失败。检查[model]段的api_key是否是完整的 TaoToken Key，base_url是否是https://taotoken.net/api，不要多加路径或参数。如果 Key 复制时带了空格，也会导致鉴权失败。
报错四：配置改了但 openclaw 行为没变。确认 openclaw 是否重新加载了配置，有些情况下需要重启进程才会读取新的config.toml。另外检查是否有多个配置文件，openclaw 可能读的是另一个路径下的配置。
报错五：shopify 返回 403 但令牌有效。这通常是权限范围不够，或者该资源需要更高级别的访问权限。回到 shopify 应用后台检查权限勾选，改完后重新走一次 client credentials flow 换令牌，旧令牌不会自动继承新权限。
6. 把 Key 和通道固定下来
整条链路跑通之后，建议把配置固定成一份可复用的骨架，而不是每次接新数据源都重新配一遍。模型调用统一走 TaoToken 的 Key，shopify 鉴权走 client credentials flow 自动换令牌，skill 路径显式写清楚，这三件事定下来之后，后面加新的数据源或者新的 skill，只需要在config.toml里加对应的段就行。
如果你后面要跑长期的编码任务或者 Agent 工作流，模型调用会变得频繁，这时候可以看看 Coding Plan，它更适合持续运行的场景。日常验证模型返回是否正常，用模型对话页面手动测一下最快。接入过程中如果遇到鉴权或通道配置的问题，API Keys 页面和接入文档里有更细的说明，对照着排查会比盲试快很多。
