企业官网建设流程全解析

1. OpenClaw 通过 ACP 协议调度 Qwen Code 的真实场景与痛点

OpenClaw 是一个支持多 Agent 协作的智能体运行框架，它最核心的能力之一就是通过 ACP 协议（Agent Communication Protocol，代理通信协议）把任务分派给专门的编码 Agent 去执行。Qwen Code 是通义千问推出的命令行编码工具，擅长在真实工作目录里读写文件、生成项目骨架、补全业务逻辑。把这两者接起来，你就能在 OpenClaw 的对话窗口里说一句「帮我建个 C# 控制台项目」，后台自动拉起 Qwen Code，在指定目录里把.cs和.csproj都写好，最后把结果回传给你。这套链路对做 C# 项目的人来说非常实用，因为 .NET 项目的目录结构、命名空间、SDK 版本这些细节，交给专门的编码 Agent 处理比手动敲要稳得多。

但真正动手时，痛点会集中爆发在三个地方。第一是模型通道问题：Qwen Code 默认走的是官方 OAuth 或者 DashScope 的 Key，很多人在多工具混用时会遇到额度分散、Key 管理混乱、切换环境要重新登录的情况。第二是 ACP 配置问题：OpenClaw 的gateway.json里allowedAgents没写对，或者defaultAgent指向了一个没装好的 Agent，调用时直接报 agent not found。第三是联调验证问题：配置看起来都对，但sessions_spawn发出去之后没有回显，或者 Qwen Code 返回了结果但 C# 项目跑不起来，你根本不知道是协议层断了还是代码生成有问题。

我试过把 Qwen Code 的模型通道统一收敛到 TaoToken 上，用同一个 Key 同时服务 OpenClaw 里的多个 Agent，这样 ACP 调度时不用再关心每个 Agent 各自的认证状态。TaoToken 提供的是标准的 OpenAI 兼容接口，Base URL 是https://taotoken.net/api，Qwen Code 侧只要把模型端点和 Key 指过去就能跑。下面我会把整条链路拆成可复制的配置片段，从环境准备、ACP 配置、Qwen Code 参数、C# 项目联调，到一次端到端请求验证，全部走一遍。你跟着做，最后应该能在终端里看到dotnet run输出 Hello World，并且确认这条指令确实是通过 ACP 协议下发给 Qwen Code 执行的。

适合读这篇的人：已经在用 OpenClaw 做多 Agent 编排、想接入 Qwen Code 写 C# 的开发者；或者手上有 .NET 项目、想用命令行 Agent 自动化生成代码骨架的人。如果你还没装 OpenClaw，也没关系，前置准备部分会把命令都给全。

2. TaoToken 统一 Key 接入 Qwen Code 的前置配置

这一节解决的是「模型通道」问题。Qwen Code 本身支持多种认证方式，包括 OAuth 登录和 API Key。OAuth 适合个人开发者单机使用，但如果你要在 OpenClaw 里通过 ACP 调度它，尤其是可能同时跑多个 Agent 会话，用统一的 API Key 会更可控。TaoToken 的好处是它把模型服务收敛成一个标准端点，你不需要在 Qwen Code 里配置一堆厂商专属的环境变量，只要设置 Base URL 和 Key 就行。

先确认 Qwen Code 装好了。命令是：

npm install -g @qwen-code/qwen-code@latest qwen --version

如果输出类似0.9.x的版本号，说明 CLI 可用。接着装 .NET SDK，C# 项目联调需要它：

# macOS brew install --cask dotnet-sdk # Ubuntu/Debian sudo apt-get update && sudo apt-get install -y dotnet-sdk-8.0 # 验证 dotnet --version

看到8.0.x就对了。接下来是 TaoToken 的 Key。打开https://taotoken.net/console，在 API Keys 页面创建一个新 Key，复制出来。这个 Key 后面会同时用在 Qwen Code 的模型通道上。TaoToken 的 API 端点是https://taotoken.net/api，注意这里不带任何查询参数，是干净的 Base URL。

Qwen Code 读取模型配置的方式有两种：环境变量和配置文件。推荐用环境变量，因为 OpenClaw 通过 ACP 拉起 Qwen Code 子进程时，环境变量会继承过去，不用额外传参。在~/.zshrc或~/.bashrc里加：

export OPENAI_API_KEY="sk-你的TaoTokenKey" export OPENAI_BASE_URL="https://taotoken.net/api" export QWEN_MODEL="qwen3-coder-plus"

这里OPENAI_API_KEY和OPENAI_BASE_URL是 Qwen Code 识别 OpenAI 兼容通道的标准变量名，QWEN_MODEL指定默认模型 ID。改完执行source ~/.zshrc让它生效。你可以先用一条简单命令验证通道通不通：

qwen "只回复两个字：通了"

如果返回「通了」，说明 Qwen Code 已经通过 TaoToken 的通道拿到了模型响应。这一步很关键，因为如果这里不通，后面 ACP 调度一定失败。常见的不通原因是 Key 复制时带了空格，或者 Base URL 写成了带/v1的路径。TaoToken 的端点就是https://taotoken.net/api，Qwen Code 内部会自己拼/v1/chat/completions，你不需要手动加。

如果你更习惯用配置文件，Qwen Code 也支持在~/.qwen/settings.json里写：

{ "model": { "provider": "openai", "baseUrl": "https://taotoken.net/api", "apiKey": "sk-你的TaoTokenKey", "modelId": "qwen3-coder-plus" } }

两种方式选一种即可，不要同时配，否则环境变量优先级更高，容易让你误以为配置文件没生效。配完之后，Qwen Code 侧的模型通道就算打通了。接下来才是 OpenClaw 的 ACP 配置。

3. OpenClaw ACP 协议与 Qwen Code 的可复制配置片段

这一节是整篇的核心，交付的是可以直接复制粘贴的配置。OpenClaw 的 ACP 配置入口在~/.openclaw/config/gateway.json。如果目录不存在，先创建：

mkdir -p ~/.openclaw/config

然后写入以下内容：

{ "acp": { "defaultAgent": "qwen-code", "allowedAgents": [ "qwen-code", "main", "claude-code", "codex" ], "agents": { "qwen-code": { "command": "qwen", "args": ["--acp"], "env": { "OPENAI_API_KEY": "sk-你的TaoTokenKey", "OPENAI_BASE_URL": "https://taotoken.net/api", "QWEN_MODEL": "qwen3-coder-plus" }, "timeoutSeconds": 1800 } } } }

这段配置里几个字段要重点解释。defaultAgent设成qwen-code，意味着你在 OpenClaw 对话里不指定 Agent 时，默认走 Qwen Code。allowedAgents是白名单，只有列在这里的 Agent 才能被sessions_spawn调用，防止误触发。agents.qwen-code里的command和args定义了 ACP 协议拉起 Qwen Code 的方式，--acp是让 Qwen Code 以 ACP 兼容模式启动。env块把 TaoToken 的 Key 和 Base URL 直接注入子进程，这样即使你的 shell 环境没配，ACP 调度时也能拿到。timeoutSeconds设成 1800，是因为 C# 项目生成可能涉及多个文件写入，300 秒有时不够。

这里必须把三件套写全：Base URL 是https://taotoken.net/api，Key 是你在 console 创建的sk-开头的字符串，Model ID 是qwen3-coder-plus。这三个值缺一个，ACP 调度时 Qwen Code 就会报认证失败或者模型不存在。如果你用的是其他模型，把QWEN_MODEL换成对应的 ID 即可，但 Base URL 和 Key 的格式不变。

配置写完后，重启 OpenClaw Gateway 让它加载：

openclaw gateway restart openclaw gateway logs

logs里如果看到acp agent qwen-code registered之类的字样，说明 Agent 注册成功。如果看到agent not found，检查allowedAgents里有没有拼错，或者command指向的qwen是否在 PATH 里。可以用which qwen确认路径，如果不在标准路径，把command改成绝对路径，比如/usr/local/bin/qwen。

另外，OpenClaw 的 ACP 调度依赖sessions_spawn这个动作。它的参数结构是这样的：

{ "runtime": "acp", "agentId": "qwen-code", "task": "创建一个 C# Hello World 项目，包含 HelloWorld.cs 和 HelloWorld.csproj", "cwd": "/Volumes/SSD/Source/csharp-hello", "mode": "run", "timeoutSeconds": 600 }

runtime="acp"表示走 ACP 协议，agentId对应allowedAgents里的名字，task是自然语言任务描述，cwd是工作目录，mode="run"表示一次性任务，如果要持久会话就改成session。这些参数在 OpenClaw 对话里通常由模型自动填充，但你手动调用时也可以直接写。

配置到这一步，ACP 链路和模型通道都齐了。下一节进入 C# 项目联调，验证整条链路真的能跑通。

4. C# 项目联调与端到端请求验证

现在做一次完整的端到端验证。目标是在 OpenClaw 里通过 ACP 协议让 Qwen Code 创建一个 C# 控制台项目，然后本地dotnet run确认输出。先建工作目录：

mkdir -p /Volumes/SSD/Source/csharp-hello cd /Volumes/SSD/Source/csharp-hello

然后在 OpenClaw 对话窗口里输入：

使用 ACP 协议让 Qwen Code 创建一个 C# Hello World 项目，保存到 /Volumes/SSD/Source/csharp-hello

OpenClaw 会解析意图，自动构造sessions_spawn调用，参数大致是runtime="acp"、agentId="qwen-code"、task="创建 C# Hello World 项目"、cwd="/Volumes/SSD/Source/csharp-hello"。ACP 协议随后拉起 Qwen Code 子进程，子进程通过 TaoToken 的通道请求模型，模型返回代码内容，Qwen Code 把文件写到工作目录。

等 OpenClaw 回复完成后，检查目录：

ls -la /Volumes/SSD/Source/csharp-hello

你应该看到HelloWorld.cs和HelloWorld.csproj两个文件。HelloWorld.cs内容类似：

using System; namespace HelloWorld { class Program { static void Main(string[] args) { Console.WriteLine("Hello, World!"); Console.WriteLine("=== 格式化输出 ==="); Console.WriteLine("Hello, 用户！欢迎使用 C#"); Console.WriteLine("=== 带时间戳 ==="); Console.WriteLine($"[{DateTime.Now:yyyy-MM-dd HH:mm:ss}] Hello from C#!"); Console.WriteLine("=== 多语言问候 ==="); Console.WriteLine("中文：你好，世界！"); Console.WriteLine("English: Hello, World!"); Console.WriteLine("日本語：こんにちは、世界！"); Console.WriteLine("한국어: 안녕하세요, 세계!"); Console.WriteLine("[程序执行完成]"); } } }

HelloWorld.csproj内容类似：

<Project Sdk="Microsoft.NET.Sdk"> <PropertyGroup> <OutputType>Exe</OutputType> <TargetFramework>net8.0</TargetFramework> <Nullable>enable</Nullable> <ImplicitUsings>enable</ImplicitUsings> </PropertyGroup> </Project>

然后运行：

cd /Volumes/SSD/Source/csharp-hello dotnet run

预期输出：

Hello, World! === 格式化输出 === Hello, 用户！欢迎使用 C# === 带时间戳 === [2026-03-14 09:38:44] Hello from C#! === 多语言问候 === 中文：你好，世界！ English: Hello, World! 日本語：こんにちは、世界！ 한국어: 안녕하세요, 세계! [程序执行完成]

看到这个输出，说明整条链路验证通过：OpenClaw 下发指令、ACP 协议调度 Qwen Code、Qwen Code 通过 TaoToken 通道请求模型、模型生成 C# 代码、代码写入磁盘、dotnet run成功执行。如果你想确认指令确实走了 ACP 而不是直接对话，可以看 OpenClaw 的日志：

openclaw gateway logs | grep acp

日志里会有sessions_spawn runtime=acp agentId=qwen-code的记录。这一步是很多人忽略的，但它能帮你区分「模型直接回答」和「Agent 真实执行」——前者只是聊天，后者才会在磁盘上留下文件。

再做一个稍复杂的验证，让 Qwen Code 创建一个带计算器功能的 C# 控制台应用：

使用 ACP 协议让 Qwen Code 在 /Volumes/SSD/Source/calc-app 创建一个 C# 计算器项目，支持加减乘除

等完成后dotnet run，输入两个数字和运算符，看是否能算出结果。这个验证能确认 Qwen Code 不只是生成 Hello World 模板，而是能根据任务描述写出有逻辑的代码。如果这一步也通过，你的 ACP + Qwen Code + TaoToken 链路就算完全打通了。

5. 常见报错排查：401、local proxy failed、reading choices、OAuth

联调过程中最容易撞上的几类报错，我按真实错误信息整理出来，对照排查。

报错一：401 Unauthorized

Error: 401 Unauthorized - invalid api key

这是 TaoToken Key 没配对。检查三处：gateway.json里env.OPENAI_API_KEY是否填了完整的sk-开头字符串；shell 环境变量是否覆盖了配置文件（环境变量优先级更高）；Key 是否在 console 里被删除或过期。最快的验证方式是单独跑qwen "test"，如果这里也 401，说明 Key 本身有问题，重新在https://taotoken.net/console创建一个。

报错二：local proxy failed

Error: local proxy failed to connect to upstream

这个报错通常出现在 Base URL 写错的时候。TaoToken 的端点是https://taotoken.net/api，不要写成https://taotoken.net/api/v1，也不要带尾部斜杠。Qwen Code 内部会自己拼路径。另外检查网络是否能访问该域名，可以用curl -I https://taotoken.net/api看返回状态。如果返回 404 是正常的，说明域名可达；如果超时，检查本机网络配置。

报错三：reading choices

Error: reading choices: unexpected end of JSON input

这个报错说明模型返回的响应体不是预期的 JSON 结构，常见原因是 Base URL 指向了一个不兼容 OpenAI 格式的端点，或者请求被中间层拦截返回了 HTML。确认OPENAI_BASE_URL是https://taotoken.net/api，并且QWEN_MODEL填的是 TaoToken 支持的模型 ID。如果模型 ID 写错，有些网关会返回错误页而不是 JSON，就会触发这个解析错误。

报错四：OAuth 相关

Error: Authentication required. Please run: qwen auth login

如果你之前用过 OAuth 登录，Qwen Code 可能优先走 OAuth 而不是 API Key。解决办法是显式设置环境变量覆盖，或者在~/.qwen/settings.json里把 provider 固定为openai。另外，ACP 调度时子进程继承的是gateway.json里的env，如果你在 shell 里登录过 OAuth，可能会和 API Key 冲突。最干净的做法是统一用 API Key，不混用 OAuth。

报错五：agent not found

Error: acp agent qwen-code not found in allowedAgents

检查gateway.json的allowedAgents数组里是否有qwen-code，拼写是否一致。改完必须openclaw gateway restart，否则配置不生效。如果重启后还报，看openclaw gateway logs里 Agent 注册阶段的输出，确认command指向的qwen可执行文件存在。

报错六：dotnet 命令未找到

dotnet: command not found

这是 .NET SDK 没装或没进 PATH。macOS 用brew install --cask dotnet-sdk，Linux 用包管理器装dotnet-sdk-8.0。装完新开一个终端窗口，或者source ~/.zshrc，再dotnet --version确认。

报错七：Console.ReadKey 异常

System.InvalidOperationException: Cannot read keys when either application does not have a console

这个不是 ACP 链路问题，是生成的 C# 代码在非交互环境里调用了Console.ReadKey()。如果你在 CI 或者重定向输入的环境里跑，需要加判断：

if (Console.IsInputRedirected == false) { Console.ReadKey(); }

排查顺序建议是：先确认qwen "test"能通，再确认gateway.json配置正确，最后看sessions_spawn的日志。大部分问题都出在 Key 和 Base URL 这两个值上，把三件套（Base URL、Key、Model ID）对齐，八成报错会消失。

6. 把 ACP 调度用在日常 C# 开发里的实用建议

链路打通之后，你可以把 ACP 调度用在更多 C# 场景里。比如让 Qwen Code 创建一个 ASP.NET Core Web API 项目：

使用 ACP 协议让 Qwen Code 在 /Volumes/SSD/Source/user-api 创建 ASP.NET Core Web API，包含用户 CRUD 接口，使用 EF Core 和 SQLite

这种任务涉及多个文件、依赖包和数据库上下文，Qwen Code 会在工作目录里生成完整的项目结构。你只需要在 OpenClaw 里描述清楚技术栈和功能点，剩下的交给 ACP 调度。任务描述越具体，生成结果越接近可用状态。好的描述是「创建 ASP.NET Core Web API，包含用户 CRUD，使用 EF Core 和 SQLite」，差的描述是「做个 API」——后者会让 Agent 猜技术栈，结果往往要返工。

工作目录一定要显式指定。ACP 调度的cwd参数决定了 Qwen Code 在哪个目录里读写文件，不指定的话可能落到默认目录，你找不到生成的文件。建议每个项目一个独立目录，比如/Volumes/SSD/Source/项目名，这样也方便后续用 git 管理。

超时时间按任务复杂度调。简单项目 300 秒够用，涉及多文件生成和依赖安装的，设到 1800 秒。gateway.json里的timeoutSeconds是 Agent 级别的默认值，sessions_spawn里也可以单独覆盖。如果任务跑到一半超时，日志里会显示timeout，这时候把值调大重试即可。

模型 ID 的选择上，qwen3-coder-plus适合代码生成和重构，响应质量和速度比较均衡。如果你有更复杂的架构设计需求，可以在 TaoToken 的模型列表里选更强的编码模型，把QWEN_MODEL换掉就行，Base URL 和 Key 不用动。这就是统一 Key 接入的好处：换模型只改一个环境变量，不用重新认证。

最后，ACP 调度适合「需要真实文件产出」的任务，不适合纯咨询。如果你只是问「C# 的 async 和 await 有什么区别」，直接在 OpenClaw 对话里问就行，不用走 ACP。判断标准很简单：任务需要在磁盘上留下文件或者执行命令，就走 ACP；只是要一个解释，就直接对话。这样能省掉不必要的 Agent 启动开销。

如果你还没创建 TaoToken 的 Key，可以去https://taotoken.net/api-keys拿一个，然后在https://taotoken.net/doc看接口文档确认模型 ID 列表。配置过程中卡在 ACP 注册或者模型通道上，优先检查gateway.json的三件套和qwen "test"是否通。整条链路跑通一次之后，后面就是复制配置、换任务描述的事了。