OpenClaw 与阿里云百炼大模型及飞书的集成教程

本教程旨在指导您将 OpenClaw（前身为 Clawdbot 或 Moltbot）框架与阿里云百炼大模型平台集成，并通过飞书作为即时通信工具进行接入。OpenClaw 是一个开源 AI 代理框架，支持多种大模型接口，并可扩展到各种即时通信应用。该教程基于最新版本的 OpenClaw，提供逐步配置步骤、常见问题排查以及资源推荐。假设您具备基本的终端操作知识；若需特定环境调整，请提供更多细节以便进一步协助。

1. 前置准备

1.1 开通阿里云百炼并创建 API Key

访问阿里云百炼控制台（https://bailian.console.aliyun.com/）。
导航至“密钥管理”页面，创建新的 API Key（格式通常以 sk- 开头）。
复制并安全保存该 API Key，此密钥仅显示一次，用于后续配置。避免泄露，以防安全风险。

1.2 安装 OpenClaw

以 macOS 系统为例，使用终端执行以下命令进行安装（Windows 用户可使用类似终端工具，如 Warp 的 Windows 版本）：

 代码块
Plain
自动换行
复制代码
curl -fsSL https://openclaw.ai/install.sh | bash复制成功

安装完成后，进入引导配置流程。
使用左右箭头键选择“Yes”并回车。
在 Onboarding 模式中，选择“QuickStart”。
当提示 Model/Auth Provider 时，选择兼容的选项（如 OpenAI 兼容接口），并粘贴百炼 API Key。
将其设置为默认模型。
跳过 Telegram 或 Discord 配置（后续将处理飞书）。
在 Skill 配置中，使用上下箭头移动，空格键选中所需 Skill，回车确认。
启用以下 Hook 配置（推荐全部启用，以增强功能）：
- 启动时注入 Markdown 文件（用于会话初始化）。
- 操作日志记录（跟踪命令和上下文）。
- 新会话时保存上下文摘要（便于无缝衔接）。
若电脑已运行网关，选择重启。
选择孵化机器人方式：推荐 Web UI 以便新手使用（TUI 为终端界面，两者可共存）。
安装完成后，可通过命令启动：
- TUI：openclaw tui
- Web UI：系统将自动安装并提供访问方式。

2. 接入阿里云百炼大模型

OpenClaw 支持通过 OpenAI 兼容接口接入百炼大模型（包括通义千问系列）。以下提供两种配置方式：阿里云轻量应用服务器一键部署（推荐新手）和手动/UI 配置。

2.1 方式一：阿里云轻量应用服务器一键部署（推荐）

购买轻量应用服务器：
1. 进入阿里云轻量应用服务器控制台，选择应用镜像，搜索并选用 Moltbot（或 OpenClaw/Clawdbot）镜像。
2. 推荐配置：2 核 2 GiB 或更高（优先美国地域以确保完整联网）。
初始化配置：
1. 放通 18789 端口（使用“一键放通”功能）。
2. 输入百炼 API Key 执行“一键配置”。
3. 生成访问 Token 和 URL（保存以防丢失）。
设置主模型：
1. 通过 Token URL 访问管理界面。
2. 导航至 Config → Agents。
3. 将 Primary Model 设置为百炼模型格式，例如：bailian/qwen3-max-2026-01-23 或 alibaba-cloud/qwen-max-latest（以百炼模型广场实时列表为准：https://bailian.console.aliyun.com/ → 模型市场）。
保存并重启服务。完成后，OpenClaw 可通过各种渠道调用百炼模型。

2.2 方式二：手动部署或 UI 配置

通过 Dashboard 配置（推荐）：
1. 运行 openclaw dashboard 以启动管理面板。
2. 浏览器访问生成的 URL。
3. 导航至 Config → Models → Providers → Add Entry。
4. 输入以下 JSON 配置（替换为您的 API Key）：

 代码块
Plain
自动换行
复制代码
{
  "bailian": {
    "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
    "apiKey": "sk-您的百炼API-Key",
    "api": "openai-completions",
    "models": [
      {
        "id": "qwen3-max-2026-01-23",
        "name": "通义千问 Max Thinking 版",
        "contextWindow": 262144,
        "maxTokens": 65536
      },
      {
        "id": "qwen-max",
        "name": "通义千问 Max"
      }
    ]
  }
}复制成功

保存后，导航至 Config → Agents → Defaults → Model → Primary，设置为 bailian/qwen3-max-2026-01-23。
重启服务。
通过命令行配置（适用于进阶用户）：

 代码块
Plain
自动换行
复制代码
openclaw config set models.providers.bailian '{
  "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
  "apiKey": "sk-您的百炼API-Key",
  "api": "openai-completions",
  "models": [
    {"id": "qwen3-max-2026-01-23", "name": "Qwen3 Max"},
    {"id": "qwen-max", "name": "Qwen Max"}
  ]
}'复制成功

 代码块
Plain
自动换行
复制代码
openclaw config set agents.defaults.model.primary "bailian/qwen3-max-2026-01-23"复制成功

注意事项：

优先使用带日期的快照版模型（如 qwen3-max-2026-01-23），以确保稳定性。
配置生产环境时，考虑 HTTPS 或反向代理端口 18789。
若模型不响应，检查日志：openclaw logs --follow。
API Key 应绑定子账号并最小化权限。

3. 接入飞书

OpenClaw 支持通过插件接入飞书。以下步骤基于官方插件。

安装飞书插件：

 代码块
Plain
自动换行
复制代码
openclaw plugins install @m1heng-clawd/feishu复制成功

配置飞书应用：
1. 访问飞书开放平台（https://open.feishu.cn/app?lang=zh-CN）。
2. 创建企业自建应用，填写名称和描述。
3. 添加“机器人”能力。
4. 在“凭证与基础信息”页面复制 App ID 和 App Secret。
设置 OpenClaw 配置：

 代码块
Plain
自动换行
复制代码
openclaw config set channels.feishu.appId "您的 App ID"
openclaw config set channels.feishu.appSecret "您的 App Secret"
openclaw config set channels.feishu.enabled true复制成功

重启网关（必需，否则连接失败）：

 代码块
Plain
自动换行
复制代码
openclaw gateway restart复制成功

配置飞书权限和事件：
1. 在飞书应用“权限管理”页面，开启以下权限：
  - contact:user.base:readonly
  - im:message
  - im:message.p2p_msg:readonly
  - im:http://message.group_at_msg:readonly
  - im:message:send_as_bot
  - im:resource
2. 在事件配置中，选择“长链接”订阅方式，添加事件：
  - im.message.receive_v1
  - im.message.message_read_v1
  - http://im.chat.member.bot.added_v1
  - http://im.chat.member.bot.deleted_v1
发布应用：
1. 在“版本管理与发布”页面创建并发布版本。
2. 在飞书中搜索“OpenClaw”添加机器人。

替代配置方法：若需 AI 辅助，可在 OpenClaw 会话中输入类似提示：“帮我把飞书接入 OpenClaw，插件安装指令：openclaw plugins install @m1heng-clawd/feishu”，然后提供 App ID 和 Secret（手动配置平台权限仍需自行处理）。

4. 常见命令和问题排查

4.1 常用命令

启动 TUI：openclaw tui
重启网关：openclaw gateway restart
开启新对话：/new
添加备用模型：openclaw models fallbacks add [提供商/模型名称]（例如：bailian/qwen-max）
设置默认模型：openclaw models set [提供商/模型名称]（例如：bailian/qwen3-max-2026-01-23）

4.2 常见问题

ClawdHub 安装的 Skill 在 OpenClaw 中不可用：
- ClawHub 默认将技能安装到当前工作目录下的 ./skills 文件夹。如果存在已配置的 OpenClaw workspace，CLI 会自动回退使用该 workspace 的路径（优先级最高）。
- 为确保兼容性，请在 OpenClaw 的 workspace 目录中执行安装命令：
- 首先切换到 workspace 目录（通常为 ~/.openclaw/workspace 或通过 openclaw setup 创建的路径）。
- 然后运行：

 代码块
Plain
自动换行
复制代码
clawhub install <skill-slug>复制成功

替换 <skill-slug> 为实际技能标识，例如从 https://clawhub.com 浏览获取。
可选参数：
--force：如果目标文件夹已存在则覆盖。
--version <version>：指定版本安装。
安装后，技能文件夹将出现在 <workspace>/skills 下，并生成 .clawhub/lock.json 记录。
启动卡住（如 tmux 会话或 Cursor 代理）：使用 tmux 进入 session，并确保 Cursor 代理信任 workspace。
其他坑：参考相关教程（例如 Discord 配置：https://x.com/AppSaildotDEV/status/2016384987596206383；安装常见问题：https://x.com/lyc_zh/status/2016984907226939820）。

5. Skill 资源和高级玩法

OpenClaw 支持自动加载全局 Skill。新手可从现有资源开始：

推荐 Skill 库：https://github.com/VoltAgent/awesome-openclaw-skills（收录 700+ Skill）。
安装示例：使用 ClawdHub 命令安装特定 Skill，并按上述排查确保加载。
高级功能：探索长期记忆、心跳问询、异步工作和定时脚本。百炼的多 Agent 集群与 OpenClaw 理念兼容，可进一步研究以扩展应用。

此教程提供入门指导；实际使用中，工具价值在于日常应用。若遇到特定问题或需优化配置，请提供环境细节以便协助。

cv45186339

分享至

投诉或建议