OpenClaw从新手到中级完整教程在最近这三个月，有一款开源AI Agent项目在全球爆火，许多人都在争相学习和使用。

大家好，我是程序员小灰。

在最近这三个月，有一款开源AI Agent项目在全球爆火，许多人都在争相学习和使用。

这个开源项目就是OpenClaw，被国人戏称为“小龙虾”。

这到底是一个怎样的项目？如何进行安装和使用？有哪些落地的应用场景？今天我们用一篇完整教程给大家讲清楚。

文章比较长，建议大家收藏一下，不迷路。

一、OpenClaw 到底是什么？

OpenClaw（曾用名 ClawdBot/Moltbot）是 2026 年最火的开源 AI Agent 项目，GitHub 已获得超过 242,000 星标。

它不是普通的聊天机器人，而像是一个的AI智能体平台（Agent Platform），让你能在自己的电脑上运行AI助理，并把它接入到你日常使用的工具里——比如飞书、Discord。

OpenClaw的核心架构，就像这张图中所展示的一样：

1、Gateway（网关）

Gateway 是 OpenClaw 与外部世界交互的桥梁：

消息路由：将 IM（微信、Telegram、Discord 等）消息转发给对应的 Agent 处理
结果回复：将 Agent 的响应发送回原始 IM 渠道
多渠道支持：同时接入多个 IM 平台，统一管理

2、Agent（智能体）

Agent 是处理任务的实体：

会话管理：维护对话上下文，支持多轮对话
任务执行：调用 Skills 和工具完成用户请求
记忆机制：通过记忆系统保持长期上下文

3、Skills（技能）

Skills 是 OpenClaw 的能力扩展，类似于"插件"或"应用"：

模块化设计：每个 Skill 定义一组特定任务
生态丰富：可从 ClawHub 安装第三方 Skills
自定义开发：支持编写自定义 Skills 扩展能力
典型 Skills：GitHub、Weather、Coding Agent 等

4、Channel（频道）

Channel 定义了消息的输入/输出渠道：

多平台接入：支持 Telegram、Discord、WhatsApp、Feishu、Signal 等
配置灵活：每个 Channel 可独立配置机器人行为
消息格式：处理不同平台的消息格式差异

二、如何安装OpenClaw？

在终端，粘贴下面命令安装 openclaw

npm install -g openclaw@latest

安装完成后，执行以下命令，然后按照引导对openclaw进行初始化设置

openclaw onboard --install-daemon

选择 QuickStart 快速开始配置

AI模型供应商选择，这里我选择 MiniMax

认证方式选择：MiniMax M2.5(CN)，意思是国内版本，通过API Key 方式做认证

接着按提示输入Key，回车确认。

Channel 选择，暂时跳过，后面单独介绍接入飞书和Discord

Skill 和Hooks 也先跳过，暂时先不配置

然后选择的Web UI打开 OpenClaw Web 端

随后会在浏览器打开 http://127.0.0.1:18789

这个就是 OpenClaw Web 端，后面也可以通过 openclaw dashboard 命令来打开**。**

三、如何接入飞书机器人？

为了可以随时随地使用OpenClaw，我们需要接入IM通信软件。

国内的话可以考虑接入飞书，因为它生态相对开放，接入起来会比较方便，同时支持PC电脑端和手机移动端

1、创建飞书应用

open.feishu.cn/app

打开飞书开放平台, 创建新的应用: OpenClaw

创建完成记录下 App ID 和 App Secret 备用

2、 OpenClaw添加飞书channel

使用命令：openclaw plugins enable feishu 开启 OpenClaw 内置的飞书插件，默认是disable 状态，loaded 为开启

使用 openclaw channels add 命令配置channel

选择 Feishu/Lark (飞书)

按提示输入创建飞书应用时保存的App ID 和App Secret

群聊策略选择 Open：允许响应所有的群聊，Allowlist：在白名单的群聊可以响应

选择 Finished, 然后按提示完成配置即可。

Web 端 Channels 页可以看到飞书是 Running 状态，就是配置好了

3、配置飞书应用机器人能力与消息权限

编辑上面创建的飞书应用

为应用开启机器人能力

为应用开通相关权限

批量导入下方权限

{

  "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"

    ]

  }

}

为应用订阅相关事件

订阅方式选默认推荐的 长连接，添加上以下事件

⚠️第3步中的订阅事件的操作一定要在第2步接入飞书channel之后，否则选长连接会失败

编辑完之后记得创建版本并发布才能生效

4、接入飞书群聊

用手机或者电脑打开飞书客户端，创建一个测试群

将机器人拉入群聊

@OpenClaw 打个招呼

OpenClaw 可以正常回复就说明飞书接入成功了

四、如何接入Discord Bot？

对于有条件上外网的朋友，可以考虑接入Discord，它多频道(channel)的设计天生就适合 OpenClaw 的多Agent场景, 用起来很丝滑。

1、新建 discord 应用

discord.com/developers/…

打开Discord 开发者平台,新建应用：OpenClaw

Bot 页面开启下面3个配置项，然后复制Token 备用

OAuth2 页面开启必要的权限后，拷贝生成的URL

2、新建Discord Server 并加入Bot

新建Discord 的Server

将创建的Bot 加到 Server ，拷贝上面复制的URL 到浏览器打开，点击‘Continue’

3、OpenClaw添加Discord channel

使用 openclaw channels add 命令配置channel

选择 Discord （Bot API）

按提示输入Token

Discord channel策略选择 Open：允许响应所有的channel，Allowlist：在白名单的channel可以响应

选择 Finished, 然后按提示完成配置即可。

五、如何进行多Agent 配置？

在 OpenClaw 中，一个 Agent 不只是一个名字，它是一个独立的“虚拟员工”，拥有自己的各个组成部分，包括：

Workspace (工作区)：它的个人办公室（"灵魂三件套"、长期记忆）
AgentDir (状态目录)：它的身份证（认证信息、模型配置）
Sessions (会话存储)：它的私人记忆（独立的聊天记录，不跟别人串味）

其中Workspace 目录下的 AGENTS.md、SOUL.md、USER.md 文件是Agent 的核心，被称为Agent 的"灵魂三件套"，下面我给大家逐个介绍下：

1、SOUL.md — AI 的灵魂

定义 AI 的性格和行为准则：

Core Truths — 核心原则（不说废话、有观点、谨慎使用外部工具）
Vibe — 风格定位（不像机器人，像真实助手）
Boundaries — 边界（隐私保护、谨慎对外）

2、USER.md — 用户画像

记录关于用户的信息：

姓名、称呼、时区
偏好、项目、痛点
随对话不断更新

3、AGENTS.md — 工作规范

定义工作方式和记忆机制：

每次会话必读：SOUL.md → USER.md → memory/
写作规范：TEXT > BRAIN（随时记录）
心跳任务：定期检查 + 主动汇报
群聊礼仪：知道何时说话、何时沉默

通过调整 workspace 下的这3个文件，就可以将Agent 从"通用 AI"变成"你的专属AI"。

多Agent的原理已经讲清楚，接下来我们演示一下，如何在Discord当中配置多个agent：

step1: 新建多个agent

Openclaw 默认是单 agent 模式，可以通过下面命令新建 agent：

openclaw agents add coder

step2: 创建多个Bot

按着上面 新建 discord 应用 的操作创建多个Bot 并加入到Server

step3: 将Bot 与Agent 绑定

通过bindings 为每个agent 绑定一个Bot , 下面是discord 的配置示例：

{

  "bindings": [

    {

      "agentId": "main",

      "match": {

        "channel": "discord",

        "accountId": "main"

      }

    },

    {

      "agentId": "coder",

      "match": {

        "channel": "discord",

        "accountId": "coder"

      }

    }

  ],

  "channels": {

    "discord": {

      "enabled": true,

      "allowBots": true,

      "groupPolicy": "allowlist",

      "accounts": {

        "main": {

          "token": "${DISCORD_BOT_TOKEN_1}",

          "groupPolicy": "allowlist",

          "guilds": {

            "${SERVER_ID}": {

              "requireMention": true,

              "users": [

                "${USER_ID}"

              ],

              "channels": {

                "${CHANNEL_ID}": {

                  "allow": true

                }

              }

            }

          }

        },

        "coder": {

          "token": "${DISCORD_BOT_TOKEN_2}",

          "groupPolicy": "allowlist",

          "guilds": {

            "${SERVER_ID}": {

              "requireMention": true,

              "users": [

                "${USER_ID}"

              ],

              "channels": {

                "${CHANNEL_ID}": {

                  "allow": true

                }

              }

            }

          }

        }

      }

    }

  }

}