Qwen3.5 Plus 与 OpenClaw 框架协同构建商用 AI Agent 实战

确保 Python 版本≥3.9，这是最稳定的适配版本，然后安装依赖：

pip install openclaw>=2026.2.19 qwen-sdk>=1.3.0 python-dotenv>=1.0.1

2. 配置模型密钥

在项目根目录创建 .env 文件，填写 Qwen3.5 Plus 的 API 信息（阿里云百炼平台可快速申请）：

# Qwen3.5 Plus 接口配置
QWEN_API_KEY = "你的 API 密钥"
QWEN_BASE_URL = "https://dashscope.aliyuncs.com/compatible-mode/v1"
QWEN_MODEL = "qwen3.5-plus"

3. 完整运行代码

代码全程加注释，新手也能看懂，复制即可运行：

# 导入依赖
import os
from dotenv import load_dotenv
from openclaw import Agent, ToolRegistry
from qwen_sdk import QwenClient

# 加载环境配置
load_dotenv()

# 初始化 Qwen3.5 Plus 客户端（大脑）
llm_client = QwenClient(
    api_key=os.getenv("QWEN_API_KEY"),
    base_url=os.getenv("QWEN_BASE_URL"),
    model=os.getenv("QWEN_MODEL")
)

# 初始化 OpenClaw 智能体（手脚）
office_agent = Agent(
    llm=llm_client,
    name="企业办公助手",
    description="专注文档处理、数据总结、格式转换的商用 AI Agent"
)

# 注册自定义工具：文档总结
@ToolRegistry.register(name="文档总结", description="读取文本文件并生成核心总结")
def doc_summarize(file_path: str) -> str:
    try:
        # 读取文件内容
        with open(file_path, "r", encoding="utf-8") as f:
            content = f.read()
        # 调用大模型生成总结
        prompt = f"请总结以下文档核心内容，分点列出，简洁清晰：{content}"
        resp = llm_client.chat.completions.create(
            messages=[{"role": "user", "content": prompt}]
        )
        return resp.choices[0].message.content
    except Exception as e:
        return f"处理失败：{str(e)}"

# 启动 Agent
if __name__ == "__main__":
    print("=== 商用办公 Agent 已启动 ===")
    while True:
        user_cmd = input("请输入需求（输入退出结束）：")
        if user_cmd in ["退出", "exit", "quit"]:
            print("Agent 已停止运行")
            break
        # 执行任务并输出结果
        result = office_agent.run(user_cmd)
        print("\n===== 执行结果 =====")
        print(result)

4. 运行效果

运行代码后，输入'总结项目需求文档.txt'，Agent 会自动读取文件、调用模型生成总结，全程无需手动操作，对接企业文件系统即可直接用于办公场景。

六、商用落地场景

Qwen3.5 Plus + OpenClaw 的组合，已经在大量中小微企业落地，以下 4 个场景最常用，直接复用代码就能上线：

1. 电商智能客服：对接电商订单、物流系统，自动查询订单状态、回复售后问题、生成售后工单，7×24 小时响应，降低人力成本。
2. 数据分析师：对接 Excel 与企业数据库，自动拉取销售、库存数据，生成可视化分析报告，每日定时推送，不用人工整理数据。
3. 内容创作助手：根据产品信息自动生成推广文案、短视频脚本、公众号文章，支持多风格切换，提升内容产出效率。
4. 行政办公管家：自动处理会议纪要、合同审核、日程安排、邮件发送，简化行政流程，提升办公效率。

七、进阶优化建议

代码跑起来只是基础，商用 Agent 还要做这些优化：

1. 指令优化：给模型的指令越具体，执行越准确，比如明确字数、格式、输出要求；
2. 参数调优：给 OpenClaw 工具设置超时时间、重试次数，避免执行中断；
3. 私有化部署：本地部署 OpenClaw + 轻量化模型，数据完全本地化；
4. 多 Agent 协同：复杂业务拆分多个 Agent 分工执行，框架支持 Agent 间无缝通信。

八、常见问题排查

开发中遇到的小问题，按以下思路快速解决：

1. 接口调用失败：检查 API 密钥、接口地址是否正确，网络是否可访问；
2. 工具无响应：核对文件路径、参数格式，查看框架运行日志；
3. 结果不符合预期：优化指令细节，增加结果校验逻辑。