手把手教你在Mac上搭建OpenClaw龙虾AI助手,接入飞书和阿里云百炼

简介: 本文以 Mac 操作系统为实操环境,完整讲解 OpenClaw 龙虾 AI 助手本地部署、对接阿里云百炼大模型、接入飞书机器人全流程,同时补充轻量服务器零代码可视化部署方案。OpenClaw 是开源 AI 助手工具,可对接钉钉、飞书等主流 IM,依托百炼平台 Qwen、DeepSeek、Kimi 等多类大模型实现智能对话。教程先说明前置环境要求,指导安装 Node.js 后通过脚本或 npm 部署 OpenClaw,完成初始化基础配置OpenClaw云端部署教程:https://t.aliyun.com/U/z5eiGA

OpenClaw 是一个开源的个人 AI 助手平台,支持通过多种IM消息渠道 AI 交互。通过配置可接入阿里云百炼平台上的 AI 模型,AI模型支持按量付费、Coding Plan、Token Plan 团队版三种接入方式。本文阿小云以本地Mac OS操作系统为例,现在本地电脑安装OpenClaw,然后调用阿里云百炼平台的Token,调用百炼API Key有三种方法,最后接入飞书全流程。如果是云端部署OpenClaw,可以参考阿里云官方关于OpenClaw的部署教程:https://www.aliyun.com/activity/ecs/clawdbot

云端部署安装OpenClaw.jpg


一、安装 OpenClaw

1、检查并安装Node.js

OpenClaw 需要 Node.js 22 或更高版本。可通过以下命令检查 Node.js 版本,打开终端,执行命令:

node --version

如果未安装或版本过低,请访问 Node.js 官网下载安装。

2、安装OpenClaw

推荐使用官方安装脚本:

curl -fsSL https://openclaw.ai/install.sh | bash

或通过 npm 全局安装:

npm install -g openclaw@latest

首次安装后,OpenClaw 会自动启动配置向导,完成初始设置。也可以手动执行openclaw onboard命令进行配置。

配置项

建议配置

I understand this is powerful and inherently risky. Continue?

选择 Yes

Onboarding mode

选择 QuickStart

Model/auth provider

选择 Skip for now(稍后配置百炼模型)

Filter models by provider

选择 All providers

Default model

选择 Keep current

Select channel (QuickStart)

选择 Skip for now(稍后配置渠道)

Configure skills now? (recommended)

选择 No

Enable hooks?

按空格键选中选项,按回车键进入下一步

How do you want to hatch your bot?

选择 Do this later



二、订阅百炼AI模型API Key

接入阿里云百炼平台AI模型的API Key有三种方式,可以开通Token PlanCoding Plan或者按量付费使用Token,三种方法如下,以下三种方法三选一:


方法1、接入Token Plan 团队版

阿里云百炼TokenPlan团队版官网:https://www.aliyun.com/benefit/scene/tokenplan  需要先购买套餐,目前最低是198元1个月,如下图:

阿里云百炼TokenPlan团队版订阅计划.jpg

订阅之后获取 Token Plan 团队版专属 API Key,TokenPlan的API Key如下:

API Key

Token Plan 团队版专属API Key

Base URL


https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic

可用模型

Token Plan 团队版支持的模型


配置文件位于 ~/.openclaw/openclaw.json,OpenClaw 启动时会自动读取。查看:Token Plan 团队版专属API Key获取方法


获取到阿里云百炼Token Plan团队版的API Key后,跳转到【三、配置AI模型的API Key】


方法2、接入Coding Plan 团队版

阿里云Coding Plan官网:https://www.aliyun.com/benefit/scene/codingplan  如下图,目前只有Pro高级版,费用是200元1个月,如下图:

阿里云百炼CodingPlan介绍配置及价格.jpg


订阅之后,获取CodingPlan的API Key:

API Key

Coding Plan 专属 API Key,格式为 sk-sp-xxxxx

Base URL


https://coding.dashscope.aliyuncs.com/apps/anthropic

可用模型

Coding Plan 支持的模型


获取Coding Plan的API Key,然后跳转到【三、配置AI模型的API Key】



方法3、按量使用百炼Token

在阿里云百炼平台:https://www.aliyun.com/product/bailian  获取到API Key:https://help.aliyun.com/zh/model-studio/get-api-key


API Key

阿里云百炼 API Key,格式为 sk-xxxxx

Base URL

请确保 Base URL、API Key 和模型归属同一地域:

可用模型

填入模型广场中支持的模型

以下配置以华北2(北京)地域为例,如使用其他地域请替换 baseUrl 为上表中对应地域的 URL。

配置文件位于 ~/.openclaw/openclaw.json,OpenClaw 启动时会自动读取。


三、配置AI模型的API Key


1、Mac电脑打开终端,打开配置文件:

nano ~/.openclaw/openclaw.json

2、写入配置,首次配置:复制以下内容到配置文件,将 YOUR_API_KEY 替换为【Token Plan的API Key】、【CodingPlan的API Key】或者【百炼按量计费的API Key】,三选一。以下是以TokenPlan为例:

{
  "meta": {
    "lastTouchedVersion": "2026.2.1",
    "lastTouchedAt": "2026-02-03T08:20:00.000Z"
  },
  "models": {
    "mode": "merge",
    "providers": {
      "bailian-token-plan": {
        "baseUrl": "https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic",
        "apiKey": "YOUR_API_KEY",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "qwen3.7-max",
            "name": "qwen3.7-max",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 1000000,
            "maxTokens": 65536,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "compat": { "thinkingFormat": "openai" }
          },
          {
            "id": "qwen3.7-plus",
            "name": "qwen3.7-plus",
            "reasoning": false,
            "input": ["text", "image"],
            "contextWindow": 1000000,
            "maxTokens": 65536,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "compat": { "thinkingFormat": "openai" }
          },
          {
            "id": "qwen3.6-plus",
            "name": "qwen3.6-plus",
            "reasoning": false,
            "input": ["text", "image"],
            "contextWindow": 1000000,
            "maxTokens": 65536,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "compat": { "thinkingFormat": "openai" }
          },
          {
            "id": "qwen3.6-flash",
            "name": "qwen3.6-flash",
            "reasoning": false,
            "input": ["text", "image"],
            "contextWindow": 1000000,
            "maxTokens": 32768,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "compat": { "thinkingFormat": "openai" }
          },
          {
            "id": "deepseek-v4-pro",
            "name": "deepseek-v4-pro",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 163840,
            "maxTokens": 32768,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }
          },
          {
            "id": "deepseek-v4-flash",
            "name": "deepseek-v4-flash",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 163840,
            "maxTokens": 16384,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }
          },
          {
            "id": "deepseek-v3.2",
            "name": "deepseek-v3.2",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 163840,
            "maxTokens": 16384,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "compat": { "thinkingFormat": "openai" }
          },
          {
            "id": "kimi-k2.7-code",
            "name": "kimi-k2.7-code",
            "reasoning": false,
            "input": ["text", "image"],
            "contextWindow": 262144,
            "maxTokens": 32768,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "compat": { "thinkingFormat": "openai" }
          },
          {
            "id": "kimi-k2.6",
            "name": "kimi-k2.6",
            "reasoning": false,
            "input": ["text", "image"],
            "contextWindow": 262144,
            "maxTokens": 16384,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "compat": { "thinkingFormat": "openai" }
          },
          {
            "id": "kimi-k2.5",
            "name": "kimi-k2.5",
            "reasoning": false,
            "input": ["text", "image"],
            "contextWindow": 262144,
            "maxTokens": 16384,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "compat": { "thinkingFormat": "openai" }
          },
          {
            "id": "glm-5.2",
            "name": "glm-5.2",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 1000000,
            "maxTokens": 16384,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "compat": { "thinkingFormat": "openai" }
          },
          {
            "id": "glm-5.1",
            "name": "glm-5.1",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 202752,
            "maxTokens": 16384,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "compat": { "thinkingFormat": "openai" }
          },
          {
            "id": "glm-5",
            "name": "glm-5",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 202752,
            "maxTokens": 16384,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 },
            "compat": { "thinkingFormat": "openai" }
          },
          {
            "id": "MiniMax-M2.5",
            "name": "MiniMax-M2.5",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 204800,
            "maxTokens": 131072,
            "cost": { "input": 0, "output": 0, "cacheRead": 0, "cacheWrite": 0 }
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "bailian-token-plan/qwen3.7-plus"
      },
      "models": {
        "bailian-token-plan/qwen3.7-max": {},
        "bailian-token-plan/qwen3.7-plus": {},
        "bailian-token-plan/qwen3.6-plus": {},
        "bailian-token-plan/qwen3.6-flash": {},
        "bailian-token-plan/deepseek-v4-pro": {},
        "bailian-token-plan/deepseek-v4-flash": {},
        "bailian-token-plan/deepseek-v3.2": {},
        "bailian-token-plan/kimi-k2.7-code": {},
        "bailian-token-plan/kimi-k2.6": {},
        "bailian-token-plan/kimi-k2.5": {},
        "bailian-token-plan/glm-5.2": {},
        "bailian-token-plan/glm-5.1": {},
        "bailian-token-plan/glm-5": {},
        "bailian-token-plan/MiniMax-M2.5": {}
      }
    }
  },
  "gateway": {
    "mode": "local",
    "auth": { "mode": "none" }
  }
}

3、保存并退出,按 Ctrl+X,按 Y 确认保存,按 Enter 确认文件名


4、使配置生效,运行以下命令重启网关,使配置生效

openclaw gateway restart


四、接入飞书

步骤一:创建飞书应用

  1. 访问飞书开放平台,单击创建企业自建应用,填写应用名称和描述,选择应用图标,单击创建
  2. 左侧导航栏单击凭证与基础信息 页面,复制App ID(格式如 cli_xxx)和App Secret
  3. 左侧导航栏单击 权限管理页面,单击批量导入/导出权限 按钮,粘贴以下 JSON 配置,单击下一步,确认新增权限,单击申请开通


JSON配置文件内容:

   {
     "scopes": {
       "tenant": [
         "aily:file:read",
         "aily:file:write",
         "application:application.app_message_stats.overview:readonly",
         "application:application:self_manage",
         "application:bot.menu:write",
         "cardkit:card:write",
         "contact:user.employee_id:readonly",
         "corehr:file:download",
         "docs:document.content:read",
         "event:ip_list",
         "im:chat",
         "im:chat.access_event.bot_p2p_chat:read",
         "im:chat.members:bot_access",
         "im:message",
         "im:message.group_at_msg:readonly",
         "im:message.group_msg",
         "im:message.p2p_msg:readonly",
         "im:message:readonly",
         "im:message:send_as_bot",
         "im:resource",
         "sheets:spreadsheet",
         "wiki:wiki:readonly"
       ],
       "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
     }
   }
  1. 左侧导航栏中单击, 选择按能力添加页签,找到机器人卡片,单击配置
  2. 配置事件订阅。
  1. 在飞书开放平台左侧导航栏单击事件与回调,在事件配置页签中单击订阅方式,选择使用 长连接 接收事件,单击保存
  2. 在事件配置页面,单击添加事件,搜索事件im.message.receive_v1(接收消息),单击确认添加
  1. 版本管理与发布 页面创建版本,填写应用版本号更新说明,单击保存,提交审核并发布。


步骤二:配置飞书机器人

1、在终端中输入以下命令配置飞书渠道

openclaw channels add


根据界面交互提示,完成以下配置。

  • 选择 Feishu
  • 输入 App ID
  • 输入 App Secret

配置完成后,重启网关。 2. 创建群聊或在已有群聊中添加机器人,在飞书群中@机器人进行对话,或通过搜索的方式与机器人私聊进行测试。 3. 在群聊中添加机器人:设置。 4. 单击机器人头像,单击发送消息,可向机器人私发一条消息,机器人会回复一条包含配对码的消息。 5. 复制消息的最后一行,在 OpenClaw 对话中发送,OpenClaw 会自动完成飞书机器人配对。


步骤三:测试

1、执行以下命令重启网关。

openclaw gateway restart

2、执行以下命令检查飞书渠道状态

openclaw status

在 Channels 部分,Feishu 应显示为 ON 且状态为 OK


3. 在飞书中发送消息进行测试。


至此在MacOS电脑上安装OpenClaw龙虾AI助手,使用阿里云百炼AI模型的API Key调用模型,并接入飞书的全流程完毕。

目录
相关文章
|
4月前
|
存储 人工智能 BI
Coze开发自能体的费用
Coze(扣子)2026年全面升级计费体系,分国内版(coze.cn,订阅+资源包)与国际版(coze.com,点数制)。国内版含免费/进阶/高阶/企业四档;国际版按模型消耗Credits,GPT-4o等高价、GPT-3.5等低价。另含API调用、商业流量、知识库存储等潜在费用。个人测试选免费版,商用推荐进阶版。(239字)
|
4月前
|
人工智能 JSON 供应链
畅用7个月无影 JVS Claw |手把手教你把JVS改造成「科研与产业地理情报可视化大师」
LucianaiB分享零成本畅用JVS Claw教程(学生认证享7个月使用权),并开源GeoMind项目——将JVS改造为科研与产业地理情报可视化AI助手,支持飞书文档解析、地理编码与腾讯地图可视化,助力产业关系图谱构建。
24127 15
畅用7个月无影 JVS Claw |手把手教你把JVS改造成「科研与产业地理情报可视化大师」
|
消息中间件 Kafka 网络安全
Conduktor连接阿里云Kafka集群
Conduktor是一款商业化的Apache Kafka Connector,可以使用该工具连接Kafka Cluster,方便对集群信息如Topic,Group,Partition,Offset能信息的在线管理的查看,本文主要在Windows10环境下演示该工具的下载以及如果连接阿里云上的Kafka集群。
2382 0
Conduktor连接阿里云Kafka集群
|
2月前
|
人工智能 缓存 安全
阿里云百炼:重磅发布Qwen3.7 Max 面向智能体时代的新一代旗舰模型
阿里云百炼重磅发布Qwen3.7-Max旗舰大模型,面向智能体时代,支持100万tokens超长上下文、30K RPM高并发,具备卓越编程能力、MCP集成与长周期自主执行能力。现推理后付费限时5折,新用户可免费试用100万Tokens。开百炼免费体验:https://t.aliyun.com/U/fPVHqY
|
4月前
|
人工智能 Android开发 iOS开发
阿里云JVS Claw官方网站入口链接及使用教程说明,下载或不下载都能用
阿里云JVS Claw是基于OpenClaw打造的轻量级AI龙虾助手,免配置、开箱即用,支持网页/手机/电脑多端访问(无需下载)。官网直达:https://t.aliyun.com/U/IJbaxg 享7天免费体验,付费套餐低至29元/月。
2387 1
|
5月前
|
人工智能 弹性计算 运维
别再只聊天了!OpenClaw(养龙虾)让AI自己工作,附部署教程!
OpenClaw(“养龙虾”)是开源AI智能体框架,赋予AI“手和脚”——可读写文件、操作浏览器、执行系统命令。告别只聊天的AI,实现周报自动生成发送、数据抓取、多平台协同等真自动化。本地/云端一键部署,安全可控,让AI真正替你干活!
2679 15
|
3月前
|
云安全 人工智能 运维
阿里云ACP认证是什么?含金量高吗?有必要考吗?ACP高级工程师认证费用、题库及问题解答FAQ
阿里云ACP云计算高级工程师认证含金量高,面向架构/开发/运维人员,线下考试(120分钟,100分制,80分及格),官方费用1200元(活动价840元)。涵盖云架构、网络、高可用、安全等核心能力,助力职业发展与企业提效。阿里云认证官网链接:https://t.aliyun.com/U/cLcbll
909 0
|
4月前
|
运维 数据挖掘 API
如何根据需求选择精准度合适的IP查询工具?三步评估法+工具对比
选IP查询工具忌“一刀切”!本文提出三步评估法:一明精度需求(城市级/街道级),二看更新频率与字段维度(日更商用库准确率超99%),三定部署方式(API或离线库)。结合真实案例,助你平衡精准度、成本与性能,选对不选贵。(239字)
273 4

热门文章

最新文章