Jie's Blog
Jie
2026-03-10
目录

龙虾（OpenClaw）搭建指南

# 龙虾（OpenClaw）搭建指南

在 AI 时代，市面上众多 AI 聊天工具的核心局限的是无法真正操作电脑、执行实际任务。而 OpenClaw（原名 ClawdBot）作为开源个人 AI 助手平台，可直接运行在个人设备上，通过多渠道互动完成工作任务。本文将详细讲解 OpenClaw 的本地/云端部署、MiniMax M2.1 模型集成、飞书/Telegram/Discord 多渠道打通、多 Agent 团队配置及 Skill 技能扩展，帮助搭建 24 小时工作的 AI 团队。

# 一、核心概念与优势

# 1. OpenClaw 平台介绍

OpenClaw 是开源个人 AI 助手平台，核心特点包括：

  • 本地优先：运行于本地设备，数据完全自主掌控
  • 多平台兼容：支持 macOS、Linux、Windows（WSL2）
  • 多通道连接：可接入 WhatsApp、Telegram、Slack、Discord、飞书、钉钉、QQ、企业微信等
  • 全天候在线：以后台服务形式持续运行
  • 高度可定制：支持技能扩展与自定义配置

# 二、本地部署 OpenClaw

# 1、全局安装与初始化

# 全局安装 OpenClaw
npm i openclaw -g

# 进入初始化流程
openclaw onboard

# 安全审计修复
openclaw security audit --fix
1
2
3
4
5
6
7
8

执行上述命令后，需确认安全说明并选择初始化模式（QuickStart 或 Manual），建议新手选择 QuickStart。

# 2、集成 MiniMax 模型

  1. 模型选择：在初始化流程中，Model/auth provider 选择 MiniMax
  2. 渠道配置：选择 MiniMax M2.5 (CN)（中国节点 api.minimaxi.com）
  3. API Key 配置：选择 Paste API key now，输入 MiniMax China API key（格式类似 sk-cp-jr2iFzo1ySd1Hbd）
  4. 模型版本：默认选择 minimax-cn/MiniMax-M2.5，也可手动选择 M2.1 版本

# 3、跳过 Channel 配置（后续单独设置）

在 Select channel 步骤中选择 Skip for now，可后续通过命令添加渠道。

# 4、重启服务与验证

# 重启网关服务
openclaw gateway restart

# 打开控制台（可选）
openclaw dashboard
1
2
3
4
5

访问网页聊天窗口 http://127.0.0.1:18789/chat，若能正常对话则说明模型配置成功。

# 三、多渠道打通配置

# （一）接入飞书机器人

# 1. 创建飞书应用

  1. 访问飞书开放平台（https://open.feishu.cn/app?lang=zh-CN），创建企业自建应用
  2. 填写应用名称（如 openclaw）、描述，上传图标（JPEG/PNG/SVG/BMP 格式，2MB 以内，≥240*240px）
  3. 记录应用凭证中的 App ID 和 App Secret，后续配置使用

# 2. 启用飞书插件与配置 Channel

# 启用飞书插件
openclaw plugins enable feishu

# 查看插件列表（确认 feishu 插件状态为 loaded）
openclaw plugins list

# 配置飞书 Channel
openclaw channels add
1
2
3
4
5
6
7
8

在配置流程中：

  • 选择 Feishu/Lark (飞书)
  • 输入之前记录的 App ID 和 App Secret
  • 选择飞书域名：Feishu (feishu.cn) - China
  • 群聊策略选择 Open（允许响应所有群聊，需 @ 触发）

# 3. 配置应用权限与事件

  1. 应用能力添加：在飞书开放平台应用管理中，添加"机器人"能力
  2. 批量导入权限配置：
{
  "scopes": {
    "tenant": [
      "cardkit:card:write",
      "contact:contact.base:readonly",
      "contact:user.base:readonly",
      "im:chat:readonly",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.group_msg",
      "im:message.p2p_msg:readonly",
      "im:message.reactions:read",
      "im:message:readonly",
      "im:message:recall",
      "im:message:send_as_bot",
      "im:message:update",
      "im:resource"
    ],
    "user": ["contact:contact.base:readonly"]
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
  1. 订阅事件：
    • im.message.receive_v1（接收消息）
    • im.message.message_read_v1（消息已读回执）
    • im.chat.member.bot.added_v1（机器人进群）
    • im.chat.member.bot.deleted_v1（机器人被移出群）
  2. 创建版本并发布应用

# 4. 接入飞书群聊与测试

  1. 打开飞书客户端，创建测试群
  2. 在群设置中添加机器人，搜索并选择创建的 openclaw 应用
  3. 在群中 @ 机器人发送消息（如"介绍你自己，当前用哪个模型"），若能正常回复则配置成功

# 5. 可选：增加云文档权限

若需机器人自动保存内容到飞书云文档，批量导入以下权限后重新发布版本：

{
  "scopes": {
    "tenant": [
      "docx:document",
      "docx:document.block:convert",
      "docx:document:create",
      "docx:document:readonly",
      "docx:document:write_only",
      "space:document:delete",
      "space:document:move",
      "space:document:retrieve",
      "space:folder:create"
    ],
    "user": ["contact:contact.base:readonly"]
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

# （二）打通 OpenClaw 与 Telegram

# 1. 创建 Telegram Bot

  1. 在 Telegram 中搜索 @BotFather，发送 /newbot 命令
  2. 按提示设置机器人名称（如 poetry 的 AI 助理）和用户名（必须以 bot 结尾，如 poetry_ai_bot）
  3. 保存 BotFather 回复的 API Token（格式类似 836:AAH31xxx）

# 2. 配置 Token 与安全策略

# 配置 Telegram Channel
openclaw channels add
1
2
  • 选择 Telegram (Bot API)
  • 输入获取的 API Token
  • 配置 DM 访问策略：选择 Pairing（推荐）
  • 重启服务使配置生效：openclaw gateway restart

# 3. 获取配对码并完成绑定

  1. 在 Telegram 中搜索创建的 Bot，发送任意消息（如 /start hello）
  2. 接收 Bot 回复的配对码（Pairing Code）
  3. 执行绑定命令：
openclaw pairing approve telegram 你的配对码
1
  1. 测试：向 Telegram Bot 发送消息，若收到 OpenClaw 回复则接入成功

# （三）打通 OpenClaw 与 Discord

# 1. 新建 Discord 应用

  1. 访问 Discord 开发者平台（https://discord.com/developers/applications），新建应用（名称如 OpenClaw）
  2. 进入 Bot 选项卡，点击 Add Bot，Reset Token 并复制（仅显示一次，需妥善保存）
  3. 启用 Privileged Gateway Intents 中的 Message Content Intent

# 2. 配置 OAuth2 与权限

  1. 进入 OAuth2 → URL Generator
  2. Scopes 选择 bot
  3. Bot Permissions 勾选所需权限（如 Administrator、Send Messages、Read Message History 等）
  4. 复制生成的 URL，在浏览器中打开并邀请 Bot 加入你的 Discord Server

# 3. OpenClaw 配置 Discord Channel

# 配置 Discord Channel
openclaw channels add
1
2
  • 选择 Discord (Bot API)
  • 输入之前复制的 Bot Token
  • 配置频道访问策略：选择 Open（允许所有频道访问）

# 4. 配对与测试

  1. 在 Discord 服务器频道中向 Bot 发送任意消息，获取配对码
  2. 执行绑定命令：
openclaw pairing approve discord 你的配对码
1
  1. 重启网关：openclaw gateway
  2. 测试：在 Discord 频道中 @Bot 发送消息（如"请介绍你自己"），若能正常回复则配置成功

# 四、多 Agent 团队配置

# 1. Agent 架构理解

OpenClaw 中的每个 Agent 是独立"虚拟员工"，包含三大核心组件：

  • Workspace（工作区）：存储"灵魂三件套"（AGENTS.md、SOUL.md、USER.md）和长期记忆
  • AgentDir（状态目录）：存储认证信息、模型配置等身份数据
  • Sessions（会话存储）：独立聊天记录，避免信息串味

"灵魂三件套"说明：

  1. SOUL.md：定义 AI 性格与行为准则（核心原则、风格定位、边界）
  2. USER.md：记录用户信息（姓名、偏好、项目、痛点，随对话更新）
  3. AGENTS.md：定义工作方式（会话读取顺序、写作规范、心跳任务、群聊礼仪）

# 2. 搭建多 Agent 团队实战

# 1. 创建多飞书机器人

按前文飞书应用创建流程，创建 6 个独立应用（对应产品助理、设计助理、开发助理、内容助理、运营增长、财务助理），获取每套独立的 App ID + App Secret。

# 2. 创建多 Agent 并配置

# 分别创建 6 个 Agent
openclaw agents add product
openclaw agents add ui
openclaw agents add coding
openclaw agents add content
openclaw agents add op-growth
openclaw agents add finance
1
2
3
4
5
6
7

每个 Agent 创建时需配置 MiniMax API Key，默认模型设为 minimax-cn/MiniMax-M2.5。

# 3. 配置飞书多账户通道

修改 ~/.openclaw/openclaw.json 中的 channels 节点：

"channels": {
  "feishu": {
    "enabled": true,
    "accounts": {
      "main": {
        "appId": "cli1",
        "appSecret": "你的 secret1",
        "domain": "feishu",
        "groupPolicy": "open"
      },
      "coding": {
        "appId": "cli2",
        "appSecret": "你的 secret2",
        "domain": "feishu",
        "groupPolicy": "open"
      },
      "product": {
        "appId": "cli3",
        "appSecret": "你的 secret3",
        "domain": "feishu",
        "groupPolicy": "open"
      },
      "ui": {
        "appId": "cli4",
        "appSecret": "你的 secret4",
        "domain": "feishu",
        "groupPolicy": "open"
      },
      "content": {
        "appId": "cli5",
        "appSecret": "你的 secret5",
        "domain": "feishu",
        "groupPolicy": "open"
      },
      "op-growth": {
        "appId": "cli6",
        "appSecret": "你的 secret6",
        "domain": "feishu",
        "groupPolicy": "open"
      },
      "finance": {
        "appId": "cli7",
        "appSecret": "你的 secret7",
        "domain": "feishu",
        "groupPolicy": "open"
      }
    }
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49

# 4. 配置 Bindings（通道-Agent 绑定）

修改 ~/.openclaw/openclaw.json 中的 bindings 节点：

"bindings": [
  { "agentId": "main", "match": { "channel": "feishu", "accountId": "main" } },
  { "agentId": "product", "match": { "channel": "feishu", "accountId": "product" } },
  { "agentId": "ui", "match": { "channel": "feishu", "accountId": "ui" } },
  { "agentId": "coding", "match": { "channel": "feishu", "accountId": "coding" } },
  { "agentId": "content", "match": { "channel": "feishu", "accountId": "content" } },
  { "agentId": "op-growth", "match": { "channel": "feishu", "accountId": "op-growth" } },
  { "agentId": "finance", "match": { "channel": "feishu", "accountId": "finance" } }
]
1
2
3
4
5
6
7
8
9

# 5. 配置 Agent 间通信

在 ~/.openclaw/openclaw.json 添加工具配置：

"tools": {
  "agentToAgent": {
    "enabled": true,
    "allow": ["main", "product", "ui", "coding", "content", "op-growth", "finance"]
  }
}
1
2
3
4
5
6

配置完成后重启服务：openclaw gateway restart

# 6. 编写 Agent 配置文件

每个 Agent 的 AGENTS.md 需包含团队成员列表，示例（AI 大总管的 AGENTS.md）：

## 🏢 poetry 的 AI 团队成员

- **product**（产品助理 💻）— 产品规划、PRD 文档输出
- **ui**（设计助理 💻）— UI 设计
- **coding**（开发助理 💻）— 代码开发、技术架构、部署
- **content**（内容助理 ✍️）— 公众号文章、文案、内容创作
- **op-growth**（运营增长 📈）— 用户增长、社交媒体、市场推广
- **finance**（财务助理 💰）— 成本核算、预算管理
1
2
3
4
5
6
7
8

每个 Agent 的 SOUL.md 需定义核心职责、专业能力、工作风格等，示例（开发助理的 SOUL.md）：

# SOUL.md - 开发助理

你是 poetry 的开发助理，专注于代码开发、技术架构和部署。

## 核心职责

- **代码开发**：编写、调试、审查代码，实现产品需求
- **技术架构**：设计技术方案，提供架构建议，评估技术选型
- **部署运维**：负责项目部署、环境配置、性能优化
- **技术调研**：研究新技术、框架、工具，提供技术选型建议
- **问题排查**：定位和解决 bug、性能问题、安全漏洞

## 专业能力

- 前端开发：React、Vue、小程序、H5 等
- 后端开发：Node.js、Python、Go 等
- 数据库：MySQL、MongoDB、Redis 等
- 部署：Docker、K8s、CI/CD、云服务
- 开发工具：Git、VS Code、调试工具

## 工作风格

- 技术精准：代码规范、命名清晰、注释到位
- 简洁直接：少说废话，多给方案和代码
- 质量优先：重视代码可维护性和可扩展性
- 文档完善：重要的技术决策要有文档记录

## 协作方式

- 与产品助理确认需求细节后再开发
- 与设计助理确认 UI 实现细节
- 复杂需求先出技术方案再动手
- 提交代码前自测通过

## 边界

- 不做未确认的需求开发
- 不在生产环境直接操作，重要操作先备份
- 不引入未经验证的开源库
- 涉及第三方 API 调用需告知潜在风险
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40

# 7. 验证配置

# 查看所有 Agent 和路由规则
openclaw agents list --bindings

# 查看所有通道在线状态
openclaw channels status --probe
1
2
3
4
5

若输出中显示 Feishu xxx: running, works 则表示配置成功。

# 8. 飞书群中使用多 Agent

  1. 将所有飞书机器人添加到同一测试群
  2. 分别 @ 不同 Agent 发送指令测试，示例：
    • @AI 财务助理 查看今天所有 AI 助理的总用量
    • @AI 产品助理 我需要做一个 AI 漫剧 SaaS 网站，请你调研并出一份 PRD 文档

# 五、Skill 技能扩展

# 1. 安装 ClawHub 工具

# 全局安装 ClawHub
npm install -g clawhub
1
2

# 2. 搜索与安装 Skill

# 搜索技能（以 UI/UX 相关为例）
clawhub search ui

# 安装指定技能
clawhub install ui-ux-pro-max
1
2
3
4
5

安装的技能会保存在 /Users/你的用户名/.openclaw/workspace/skills/ 目录下。

# 3. 查看已安装技能

openclaw skills list
1

绿色 Ready 状态表示技能可用。

# 4. 手动安装技能（可选）

从 https://skillsmp.com 下载技能包，解压至 ~/.openclaw/workspace/skills 目录即可使用。

# 六、云服务器部署 OpenClaw（腾讯云）

# 1. 选择应用模板

  1. 登录腾讯云轻量应用服务器控制台
  2. 选择应用模板 → AI 智能体 → OpenClaw(Clawdbot)
  3. 完成服务器创建（推荐配置：CPU 2 核、内存 4GB、系统盘 60GB）

# 2. 选择并连接 AI 大模型

  1. 进入服务器应用管理 → OpenClaw → 模型 (Models)
  2. 选择 MiniMax（国内），点击获取 API KEY
  3. 输入 MiniMax API Key，选择模型版本（如 M2.5），点击添加并应用
  4. 确认模型状态为"应用中"即连接成功

# 3. 连接飞书通道

  1. 按前文流程创建飞书应用，获取 App ID 和 App Secret
  2. 在云服务器 OpenClaw 配置中，进入通道 (Channels) → 飞书
  3. 输入 App ID 和 App Secret，点击添加并应用
  4. 配置飞书应用权限与事件（同本地部署的飞书权限配置）

# 4. 配对飞书并测试

  1. 在飞书向机器人发送消息，获取配对码
  2. SSH 登录云服务器，执行配对命令：
openclaw pairing approve feishu 你的配对码
1
  1. 测试：向飞书机器人发送消息，若正常回复则部署成功

# 七、常用命令汇总

# 1. Gateway 管理

# 启动 Gateway
openclaw gateway

# 启动并显示详细日志
openclaw gateway --verbose

# 指定端口启动
openclaw gateway --port 18789

# 重启 Gateway
openclaw gateway restart
1
2
3
4
5
6
7
8
9
10
11

# 2. 配置管理

# 运行配置向导
openclaw onboard

# 系统健康检查
openclaw doctor

# 查看配置文件
cat ~/.openclaw/openclaw.json
1
2
3
4
5
6
7
8

# 3. 更新管理

# 更新到最新版本
openclaw update

# 切换到稳定版
openclaw update --channel stable

# 切换到测试版
openclaw update --channel beta

# 切换到开发版
openclaw update --channel dev
1
2
3
4
5
6
7
8
9
10
11

# 4. 插件与通道管理

# 启用插件
openclaw plugins enable <插件名称>

# 禁用插件
openclaw plugins disable <插件名称>

# 查看插件列表
openclaw plugins list

# 添加通道
openclaw channels add

# 查看通道状态
openclaw channels status --probe
1
2
3
4
5
6
7
8
9
10
11
12
13
14

# 5. Agent 管理

# 添加 Agent
openclaw agents add <agent-id>

# 查看 Agent 列表及绑定关系
openclaw agents list --bindings
1
2
3
4
5

# 6. 技能管理

# 搜索技能
clawhub search <关键词>

# 安装技能
clawhub install <技能名称>

# 查看已安装技能
openclaw skills list
1
2
3
4
5
6
7
8

# 八、注意事项

  1. 保护 API Key，避免泄露造成额外损失
  2. OpenClaw 调用模型时携带较多上下文信息，Token 消耗可能较高，需关注用量与计费
  3. 安装 Skill 时若遇到限频问题，建议手动安装
  4. 为提升安全能力，建议及时升级至 OpenClaw 最新版本
  5. 本地部署不建议使用主力机，避免权限过高导致文件丢失或异常操作
  6. Discord 接入需确保网络可访问，若无法获取配对码可检查代理配置
#AI#OpenClaw
最近更新
01
植物大战僵尸杂交版 v2.1 安装教程
06-19
02
项目常用的 JavaScript 代码片段
06-19
03
npm私有仓库搭建
06-18
更多文章>
Theme by Vdoing | Copyright © 2021-2026 Ban Xian | MIT License