OpenClaw安装保姆级教程:Mac电脑安装Node.js、运行龙虾命令,接入百炼AI模型最后连通飞书全流程

简介: OpenClaw是开源个人AI助手平台,支持多IM渠道接入。本文详解Mac本地安装、对接阿里云百炼(Token/Coding Plan或按量付费)、配置API Key及飞书全流程集成,含终端命令与配置示例。阿里云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 Plan、Coding 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调用模型,并接入飞书的全流程完毕。

目录
相关文章
|
12天前
|
存储 人工智能 JavaScript
阿里云千问办公入门操作演示:QwenWork一句话撰写项目报告输出 Word 文档
阿里千问办公(QwenWork)是一站式AI生产力平台,支持一句话完成数据分析、PPT生成、视频剪辑、网页搭建等复杂任务。提供任务对话式工作流、多模型切换、网盘管理、扩展能力及网页发布等功能,免费版即享基础功能,助力高效智能办公。阿里千问办公官网:https://t.aliyun.com/U/JNKJuO 阿里AI工作平台,一句话完成数据分析、PPT 生成、视频剪辑、网页搭建等复杂任务
330 0
|
4月前
|
弹性计算 Ubuntu 安全
使用阿里云服务器安装宝塔Linux面板?选Alibaba Cloud Linux还是CentOS?
本文为阿里云ECS安装宝塔Linux面板提供镜像选型指南:首推官方优化的Alibaba Cloud Linux 3.2104 LTS(安全稳定、长期支持);次选兼容性好的CentOS 7.x/8.x;Ubuntu 20.04/22.04适合Debian系用户。搭配99元经济型e实例或199元u1实例,性价比高。阿里云Linux镜像官网:https://t.aliyun.com/U/KReVDn
334 0
|
18天前
|
IDE API 开发工具
阿里云百炼API Key在哪创建查询?API Key有什么用?怎么调用?
阿里云百炼API Key是调用其大模型服务的身份凭证。本文详解获取流程:登录控制台→进入API Key管理页→点击创建→选择账号、业务空间及权限→复制保存。开通即赠7000万Tokens,支持cURL、代码及第三方工具调用。
153 1
|
1天前
|
弹性计算 运维 负载均衡
阿里云轻量应用服务器和ECS云服务器有啥区别?超详细解说,新手入门
阿里云轻量应用服务器适合新手快速建站,开箱即用、操作简单、成本低;ECS则更灵活专业,支持弹性扩容、VPC组网与集群部署,适合中长期企业级业务。选型应兼顾当前需求与未来发展。(238字)
25 0
|
23天前
|
API
阿里云TokenPlan如何接入百炼使用?需要配套专属 Base URL + API Key
阿里云百炼Token Plan仅限华北2(北京)地域,需专属Base URL与API Key接入。个人/团队版API Key入口不同,官网提供优惠券及详细教程。在阿里云百炼官网:https://t.aliyun.com/U/fPVHqY 免费领取千万Tokens
83 2
|
5天前
|
弹性计算 人工智能 开发者
阿里云Token Plan个人哪个版本最划算?肯定是Pro版,超额8.8折,免费Harness权益
阿里云Token Plan个人版选Pro最划算:月付499元享18万Credits、6-8并发Agent,Harness权益全覆盖+超额调用88折。Standard(139元/月)适合中等用量用户,Lite/ Essential无Harness权益。按实际用量与功能需求选择,详情见官网。阿里云服务器ECS官网:https://t.aliyun.com/U/AZBUsA 爆火的99元服务器ECS经济型e实例,企业专享2核4G、5M固定带宽、80GB系统盘活动价格199元一年,新老同享、续费同价
53 0
|
3月前
|
人工智能 缓存 安全
Claude Code 封号真实原因曝光,这次彻底不装了,直接针对国内开发者的账号下手?
Claude Code 封号潮背后:逆向扒出客户端隐写区域标记,Anthropic 政策收紧叠加 DeepSeek 7 月涨价,国产替代更紧迫。
2015 2
|
3月前
|
人工智能 安全 前端开发
阿里云Qoder CN AI编程智能体:重塑开发全流程的智能助手
在软件开发领域,AI技术正从简单的代码补全工具,进化为能够贯穿需求分析、代码编写、测试验证、项目管理全流程的智能体。阿里云推出的Qoder CN AI编程智能体,正是这一趋势下的核心产品,它脱胎于通义灵码,完成了从传统AI集成开发环境到智能体全自动自主开发工作台的跨越,为个人开发者、技术团队及企业级项目提供了全方位的智能开发支持。Qoder CN不再局限于单一的代码辅助,而是以智能体为核心,构建了一套完整的开发生态,通过多模型融合、多智能体协作、全流程自主执行等能力,彻底改变传统开发模式,大幅提升开发效率与代码质量。
366 3
|
3月前
|
前端开发 安全 JavaScript
Harness Engineering 实践案例:如何Agent 写一份行为规范
本文展示Harness Engineering落地实践:通过`AGENTS.md`(行为总纲)、`ARCHITECTURE.md`(系统骨架)等结构化文档,为编码Agent建立可追溯、可审计、防幻觉的工作规范,实现RAG+微调系统的可控开发。
382 4
Harness Engineering 实践案例:如何Agent 写一份行为规范
|
3月前
|
人工智能 算法 测试技术
独家揭秘:拼多多测试团队如何用AI把回归时间从3天压到2小时
拼多多测试团队借AI重构回归流程:代码提交即启动智能分析,精准筛选高风险用例,将大促前回归从3天压缩至2小时内,告别通宵等待——瓶颈不在执行速度,而在决策智能。

热门文章

最新文章