乐于分享
好东西不私藏

OpenClaw进阶配置:通义千问+飞书完整部署手册

OpenClaw进阶配置:通义千问+飞书完整部署手册

在上一篇《5分钟上手OpenClaw:AI助手部署完全指南》中,我们完成了OpenClaw的基础安装和启动。今天,我们将深入配置两个核心功能:通义千问(Qwen)大模型飞书频道集成,让你的AI助手真正具备强大的智能和工作流自动化能力。

💡 为什么选择通义千问?
通义千问是阿里云推出的超大规模语言模型,在中文理解、代码生成、多轮对话等方面表现优异,特别适合中文用户使用。配合飞书集成,你可以打造一个既能深度思考又能自动处理工作消息的智能助手。

1️⃣ 配置通义千问模型

1.1 获取API Key

首先,你需要在阿里云获取通义千问的API Key:

  1. 访问 阿里云DashScope
  2. 登录或注册阿里云账号
  3. 开通百炼(Model Studio)服务
  4. 在控制台创建API Key

⚠️ 安全提醒
API Key是敏感信息,请妥善保管,不要泄露给他人。建议在个人测试环境中使用,生产环境需要额外的安全措施。

1.2 编辑配置文件

OpenClaw的主配置文件位于 ~/.openclaw/openclaw.json。打开该文件,添加或修改以下配置:

{
  "models": {
    "mode": "merge",
    "providers": {
      "bailian": {
        "baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
        "apiKey": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
        "api": "openai-completions",
        "models": [
          {
            "id": "qwen3.5-plus",
            "name": "qwen3.5-plus",
            "reasoning": false,
            "input": ["text", "image"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 1000000,
            "maxTokens": 65536,
            "compat": {
              "thinkingFormat": "qwen"
            }
          },
          {
            "id": "qwen3-max-2026-01-23",
            "name": "qwen3-max-2026-01-23",
            "reasoning": false,
            "input": ["text"],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 262144,
            "maxTokens": 65536,
            "compat": {
              "thinkingFormat": "qwen"
            }
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "bailian/qwen3.5-plus"
      },
      "models": {
        "bailian/qwen3.5-plus": {},
        "bailian/qwen3-max-2026-01-23": {}
      },
      "workspace": "/Users/yourname/.openclaw/workspace"
    }
  }
}

1.3 模型选择指南

通义千问提供了多个模型版本,根据你的需求选择合适的模型:

模型ID
核心能力
上下文窗口
适用场景
qwen3.5-plus
文本生成、图像理解、深度思考
1M tokens
全能型,推荐作为默认模型
qwen3-max-2026-01-23
文本生成、深度思考
256K tokens
高性价比,适合日常对话

💡 小贴士
如果你主要进行中文对话和内容创作,推荐使用 qwen3.5-plus;如果对成本比较敏感,可以选择 qwen3-max-2026-01-23

2️⃣ 配置飞书频道

2.1 创建飞书应用

要在飞书中使用OpenClaw,你需要先创建一个飞书应用:

  1. 访问 飞书开放平台
  2. 使用企业管理员账号登录
  3. 进入「开发者后台」→「创建应用」
  4. 选择「自建应用」,填写应用名称(如「金点子」)
  5. 创建完成后,在「凭证与基础信息」页面获取 App ID 和 App Secret

2.2 配置应用权限

为你的飞书应用添加必要的权限:

  • 消息发送权限
  • 消息接收权限
  • 用户信息读取权限

2.3 添加飞书配置到OpenClaw

在 ~/.openclaw/openclaw.json 中添加飞书频道配置:

{
  "channels": {
    "feishu": {
      "enabled": true,
      "dmPolicy": "allowlist",
      "accounts": {
        "main": {
          "appId": "cli_xxxxxxxxxxxxxxxx",
          "appSecret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
          "name": "金点子"
        }
      },
      "allowFrom": [
        "ou_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      ]
    }
  }
}

2.4 获取用户ID

allowFrom 字段中的用户ID(open_id)可以通过以下方式获取:

  • 在飞书开放平台使用「用户身份识别」能力
  • 通过飞书API查询用户信息
  • 在飞书客户端中查看用户详情

⚠️ 重要安全设置
dmPolicy 设置为 allowlist 表示只有名单内的用户可以与机器人交互,这是强烈推荐的安全配置。不要设置为 anyone,除非你明确知道自己在做什么。

3️⃣ 启动和验证

3.1 重启Gateway

完成配置后,重启OpenClaw Gateway:

# 在OpenClaw项目目录下执行
cd /Users/yourname/openclaw/openclaw-cn
pnpm openclaw gateway

3.2 验证配置成功

启动成功后,你应该看到类似以下输出:

[gateway] agent model: bailian/qwen3.5-plus
[gateway] listening on ws://127.0.0.1:18789, ws://[::1]:18789 (PID 12345)
[gateway] log file: /tmp/openclaw/openclaw-2026-03-25.log
[feishu] channel connected

关键是要看到 [feishu] channel connected 这一行,表示飞书频道已成功连接。

3.3 测试飞书交互

在飞书中向你的机器人发送消息,测试是否能正常响应。如果配置正确,机器人应该能够使用通义千问模型回答你的问题。

✅ 成功标志
当你在飞书中收到机器人的回复,并且回复质量符合通义千问的水平时,说明配置完全成功!

4️⃣ 备份与迁移

配置完成后,记得备份你的配置文件,以便在其他设备上快速恢复:

# 备份配置文件
cp ~/.openclaw/openclaw.json ~/openclaw-backup/

# 备份工作空间(包含记忆文件)
cp -r ~/.openclaw/workspace ~/openclaw-backup/

💡 迁移提示
OpenClaw的"记忆"和"个性"都保存在配置文件和工作空间中,所以只要备份这两个部分,就能在新设备上完全复现你的AI助手。

🎯 总结

通过本文的配置,你的OpenClaw现在已经具备了:

  • ✅ 强大的通义千问大模型支持
  • ✅ 飞书工作流自动化能力
  • ✅ 安全的访问控制机制
  • ✅ 完整的备份和迁移方案

现在,你可以开始享受一个既能深度思考又能自动处理工作消息的智能助手了!在下一篇中,我们将探讨OpenClaw的数据安全和备份策略。

💬 互动时间
你在配置过程中遇到了什么问题?或者有什么想要OpenClaw帮你实现的功能?欢迎在评论区留言讨论!


#OpenClaw #AI助手 #通义千问 #飞书集成 #技术教程