企业官网建设流程全解析

1. 为什么要在 JiuwenClaw 里接上小艺

JiuwenClaw 是一个开源本地智能体，Skill 自演进、上下文压缩这些能力都在本地跑，数据不出机器。但它默认只有 Web 界面，你得坐在电脑前打开浏览器才能用。小艺是华为生态的智能入口，手机、平板、车机都能唤醒，语音文字双通道。把两者接起来，等于给本地智能体装了一个随身入口：在外面用语音喊一句，指令就落到你家里的 JiuwenClaw 上执行，结果再回到手机。

这条链路里最容易卡住的不是 JiuwenClaw 本身，而是凭证和通道配置。小艺开放平台要求 OpenClaw 模式创建智能体，拿到 AK/SK/agentId 三件套，再把这套凭证填进 JiuwenClaw 的 Channel 配置。很多人第一次配完发现日志里一直报「AK 验证失败」或者「连接超时」，其实问题往往出在凭证复制时带了空格、agentId 填错、或者服务地址公网不可达。

这篇就按「拿凭证 → 配通道 → 联调验证 → 排错」的顺序走一遍。中间会用到 TaoToken 的统一 Key/API 通道来做模型侧的统一接入，这样 JiuwenClaw 调模型和小艺通道的凭证管理可以分开，不会混在一起。适合已经在本地跑起 JiuwenClaw、想把它接到小艺上的人，也适合刚开始接触 OpenClaw 模式智能体对接的开发者。

2. 前置准备：TaoToken 统一 Key 与小艺凭证

2.1 TaoToken 侧要准备什么

JiuwenClaw 在跑 Skill 的时候需要调模型，如果你不想在每个 Skill 里单独配一套模型 Key，可以用 TaoToken 的统一 Key 通道。它的作用是把你不同来源的模型调用收敛到一个 API 入口，JiuwenClaw 只需要认一个 Key 和一个 Base URL。

先去控制台建一个 API Key：

• 控制台入口：https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=jiuwenclaw_xiaoyi
• API Key 管理：https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=jiuwenclaw_xiaoyi

建好之后你会拿到一串sk-开头的 Key。API 的基础地址是：

https://taotoken.net/api

注意这个地址后面不加 UTM 参数，直接作为 Base URL 用。JiuwenClaw 的模型配置里填这个地址，Key 填你刚建的那串。

如果你后面要长期跑编码类 Agent 或者高频调用，可以看一下 Coding Plan 的额度说明：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=jiuwenclaw_xiaoyi

2.2 小艺开放平台侧要拿的三样东西

小艺这边必须用 OpenClaw 模式创建智能体，其他模式不兼容 JiuwenClaw 的通道协议。创建完之后你要拿到：

• agentId：在智能体详情页的 AgentCard 模块直接复制，形如a1b2c3d4-xxxx-xxxx-xxxx-xxxxxxxxx
• AK（Access Key）：凭证管理里新建凭证后生成
• SK（Secret Key）：和 AK 一起生成，只显示一次，刷新页面就看不到了

SK 只显示一次这件事一定要记住。我见过有人建完凭证先去干别的，回来刷新页面发现 SK 没了，只能删掉重建。建议生成后立刻粘到本地文档里。

另外测试白名单也要配。智能体没正式上架前，只有白名单里的华为账号能访问。在「测试管理」→「测试白名单」里把你的华为账号加进去，生效大概 5 分钟。

2.3 环境版本校验

在动手配之前，先确认几个版本对得上：

公网可达这条特别关键。JiuwenClaw 默认跑在localhost:5173，小艺开放平台要回调你的服务，必须能从公网访问到。如果你在本地跑，需要做端口映射拿到一个公网地址，填到智能体的「本地服务地址」里。

3. 可复制配置：config.toml 与 settings.json 骨架

3.1 JiuwenClaw 的 config.toml 配置片段

JiuwenClaw 的配置文件路径分两种情况：

• pip 安装：~/.jiuwenclaw/config/config.toml（Windows 是C:\Users\你的用户名\.jiuwenclaw\config\config.toml）
• 源码安装：jiuwenclaw/config/config.toml

在channels节点下加小艺通道，同时把模型侧指向 TaoToken：

# 模型侧统一走 TaoToken [model] provider = "openai-compatible" base_url = "https://taotoken.net/api" api_key = "sk-你的TaoTokenKey" model = "gpt-4o-mini" # 小艺频道配置 [channels.xiaoyi] enabled = true ak = "你的小艺AK" sk = "你的小艺SK" agent_id = "你的小艺agentId" timeout = 30 log_level = "INFO" # 心跳回传（可选） [heartbeat] every = 3600 target = "xiaoyi" active_hours_start = "08:00" active_hours_end = "22:00"

几个容易写错的地方：agent_id有的版本写agentId，以你本地jiuwenclaw --version对应的文档为准；base_url不要带尾部斜杠；api_key不要带引号外的空格。

3.2 settings.json 配置片段

如果你用的是带 settings.json 的部署方式（比如容器化或者某些发行版），配置结构会不太一样：

{ "model": { "provider": "openai-compatible", "baseUrl": "https://taotoken.net/api", "apiKey": "sk-你的TaoTokenKey", "modelName": "gpt-4o-mini" }, "channels": { "xiaoyi": { "enabled": true, "ak": "你的小艺AK", "sk": "你的小艺SK", "agentId": "你的小艺agentId", "timeout": 30, "logLevel": "INFO" } } }

JSON 里不能写注释，所以别把说明文字留在文件里。改完保存，重启服务：

jiuwenclaw-stop jiuwenclaw-start

3.3 CC Switch 接入示例

CC Switch 用来在多个模型通道之间切换。如果你想让 JiuwenClaw 的模型调用走 TaoToken，在 CC Switch 里加一个 provider：

{ "name": "taotoken", "type": "openai-compatible", "baseUrl": "https://taotoken.net/api", "apiKey": "sk-你的TaoTokenKey", "models": ["gpt-4o-mini", "claude-3-5-sonnet"] }

切到这个 provider 之后，JiuwenClaw 的模型请求就会走 TaoToken 的统一通道。这样你换模型不用改 JiuwenClaw 的配置，在 CC Switch 里切就行。

3.4 Cline 接入示例

Cline 是 VS Code 里的编码 Agent，如果你想让 Cline 也走同一个 TaoToken Key，在 Cline 的设置里选 OpenAI Compatible：

• Base URL：https://taotoken.net/api
• API Key：sk-你的TaoTokenKey
• Model：按你需要的填

这样 JiuwenClaw 和 Cline 共用一套 Key，额度和管理都在 TaoToken 控制台看。模型对话的调试入口在这里：https://taotoken.net/chat?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=jiuwenclaw_xiaoyi

4. 联调验证：从日志到真机

4.1 看 JiuwenClaw 日志确认通道就绪

重启服务后，实时跟日志：

jiuwenclaw logs --follow

如果配置正确，你会看到类似这样的输出：

INFO: [XiaoyiChannel] 小艺频道已启用，正在初始化... INFO: [XiaoyiChannel] AK/SK/agentId 验证通过 INFO: [XiaoyiChannel] 成功连接小艺开放平台 Gateway INFO: [XiaoyiChannel] 小艺频道就绪，等待请求...

看到「小艺频道就绪」这行，说明 JiuwenClaw 侧已经连上小艺开放平台的 Gateway 了。如果卡在「正在初始化」不动，多半是网络出不去，检查一下能不能访问hag.cloud.huawei.com。

4.2 用 curl 验证模型通道

在配小艺之前，先确认 TaoToken 这条模型通道是通的：

curl https://taotoken.net/api/v1/chat/completions \ -H "Authorization: Bearer sk-你的TaoTokenKey" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-4o-mini", "messages": [{"role": "user", "content": "ping"}] }'

返回里有choices字段就说明模型通道没问题。这一步能帮你把「模型不通」和「小艺通道不通」两个问题分开，不然混在一起很难查。

4.3 小艺 App 真机测试

智能体提交上架审核通过后（一般 1-2 个工作日），在手机小艺 App 里：

1. 登录和白名单一致的华为账号
2. 进「我的」→「我的智能体」，下拉刷新
3. 看到你创建的智能体，点「激活」，授权语音和网络权限
4. 语音唤醒：「小艺小艺，打开我的本地助手」，然后直接下指令

文字交互也可以，在智能体聊天界面直接输入。第一次测试建议用简单指令，比如「查一下今天的天气」，确认链路通了再上复杂 Skill。

5. 本篇常见报错排查

5.1 日志报「AK 验证失败」

这是最高频的报错。按顺序查：

• AK/SK 复制时有没有带首尾空格，尤其是从网页复制容易带
• SK 是不是建凭证时那次复制的，如果刷新过页面，SK 可能已经不对了
• agentId 有没有填成智能体名称，这两个不是一个东西
• 凭证有没有被删除或重建，重建后旧 AK/SK 立即失效

排查动作：把 config.toml 里的 ak/sk/agent_id 三个值重新粘一遍，保存重启，再看日志。

5.2 日志报「连接超时」

连接超时一般是网络层的问题：

• JiuwenClaw 所在机器能不能访问hag.cloud.huawei.com，用curl -I https://hag.cloud.huawei.com试
• 本地服务地址填的是不是公网可达的地址，手机 4G/5G 能不能打开
• 端口映射有没有生效，5173 端口有没有被防火墙挡

如果curl能通但 JiuwenClaw 还是超时，检查一下 JiuwenClaw 是不是跑在容器里，容器的 DNS 或出网策略可能和宿主机不一样。

5.3 小艺 App 看不到智能体

• 白名单：确认手机登录的华为账号在测试白名单里，生效要等 5 分钟
• 刷新：在「我的智能体」页面下拉刷新，或者退出 App 重新登录
• 版本：小艺 App 低于 V13.2.5 看不到 OpenClaw 模式的智能体，去应用市场更新

5.4 指令执行成功但结果不对

链路通了但结果不对，问题在 Skill 层：

• 登录 JiuwenClaw Web 管理页，确认对应 Skill 已启用
• 看 Skill 的演进记录，有没有错误的自动优化，可以手动编辑evolutions.json删掉无效记录
• 看jiuwenclaw logs里的 Skill 执行日志，确认参数传递对不对

5.5 心跳不生效

• heartbeat.target有没有设成xiaoyi
• every是秒数，3600 就是 1 小时，要等对应时间才触发
• 看日志里的 Heartbeat 记录，确认当前时间在active_hours范围内

6. 把凭证和通道管起来

整条链路跑通之后，日常维护其实就两件事：凭证别过期，通道别断。小艺侧的 AK/SK 如果重建了，JiuwenClaw 的 config.toml 要同步改；TaoToken 侧的 Key 如果轮换了，模型配置也要跟着换。建议把这两套凭证分开管理，不要混在一个文件里，出问题的时候好定位。

模型侧的统一接入可以走 TaoToken 的 API 通道，Base URL 固定是https://taotoken.net/api，Key 在控制台建。接入文档在这里：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=jiuwenclaw_xiaoyi

如果你后面要跑长期编码任务或者 Agent 工作流，Coding Plan 的额度比按量更划算：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=jiuwenclaw_xiaoyi

配完之后建议先跑一周简单指令，确认日志里没有反复出现的验证失败或超时，再上复杂 Skill。真机测试阶段多用jiuwenclaw logs --follow盯着，大部分问题在日志里都有明确提示。