保姆级教程：Ubuntu 安装 OpenClaw + 接入飞书 + 配置 AKShare MCP

---

背景说明

OpenClaw 曾用名 ClawdBot → MoltBot，最终定名 OpenClaw，是同一款软件。它是一款开源个人 AI 助手，GitHub 星标超 10 万，支持飞书、钉钉、WhatsApp、Telegram 等主流通讯平台。

本教程目标：

你在飞书发消息
      ↓
OpenClaw 理解意图
      ↓
调用 AKShare MCP 获取真实金融数据
      ↓
飞书机器人回复结果

全程零代码，跟着步骤操作即可。

---

环境要求

项目	要求
操作系统	Ubuntu Server
公网 IP	需要（飞书回调需要可访问的地址）
飞书账号	普通账号即可
API Key	前往 yibuapi.com 获取

---

一、安装 Node.js

第一步：安装 nvm

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash

第二步：激活 nvm

source ~/.bashrc

第三步：安装最新版 Node.js

nvm install node

第四步：验证安装

node --version
npm --version

两个命令都能正常输出版本号即为成功。

---

二、安装 OpenClaw

执行安装命令

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

安装过程会自动完成：检测系统环境 → 安装依赖 → 下载核心文件 → 配置环境变量 → 启动配置向导。

---

三、初始配置向导

安装完成后自动进入配置向导 openclaw onboard。

第一步：风险告知

按 左方向键 ← 选择 Yes，按 Enter 确认继续。

第二步：选择 QuickStart 模式

选择 QuickStart 快速开始。

第三步：配置 AI 模型 API Key

前往 yibuapi.com 注册账号并获取 API Key，在此处填入。

第四步：选择 AI 模型

选择默认的 GLM 4.7 即可，后续可在配置文件中更换为更强的模型。

第五步：跳过通讯平台配置

飞书配置较复杂，先选择跳过，后面单独配置。

第六步：Skills 配置

选择 No，暂不配置，后续通过 UI 界面操作。

第七步：Hooks 配置

先按空格键选中，再按回车键确认。

---

四、启动服务并开放 UI 访问

第一步：安装 PM2 进程管理器

npm install -g pm2

第二步：启动 OpenClaw 进程

⚠️ 此命令只执行一次，不要重复执行，避免启动多个进程导致端口冲突。

pm2 start "openclaw gateway" --name openclaw
pm2 startup
pm2 save

第三步：验证服务状态

pm2 status openclaw

显示 online 且只有 1 个 openclaw 进程即为正常。

第四步：修改配置文件开放远程访问

进入配置目录：

cd /home/ubuntu/.openclaw
vim openclaw.json

找到 gateway 配置项，修改为以下内容（token 和端口可按需调整）：

"gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "lan",
    "controlUi": {
        "enabled": true,
        "basePath": "/openclaw",
        "allowInsecureAuth": true,
        "dangerouslyDisableDeviceAuth": true,
        "allowedOrigins": [
            "http://你的服务器IP",
            "http://你的服务器IP:18789",
            "http://localhost",
            "http://localhost:18789"
        ]
    },
    "auth": {
        "mode": "token",
        "token": "自定义一个token字符串"
    },
    "tailscale": {
        "mode": "off",
        "resetOnExit": false
    },
    "nodes": {
        "allowCommands": ["ls", "pwd", "cat"]
    }
}

第五步：重启服务

pm2 stop openclaw && pm2 delete openclaw && pm2 start "openclaw gateway" --name openclaw

第六步：访问 Control UI

浏览器访问：

http://你的服务器IP:18789/openclaw

如果是本地 Mac 访问远程服务器，需先建立 SSH 隧道：

ssh -L 18789:localhost:18789 ubuntu@你的服务器IP

然后浏览器访问 http://localhost:18789/openclaw

---

五、配置 yibuapi.com 中转模型

第一步：修改 openclaw.json

vim /home/ubuntu/.openclaw/openclaw.json

先记住原配置中 workspace 的值，然后将 agents、auth、models 部分替换为：

{
  "agents": {
    "defaults": {
      "workspace": "/home/ubuntu/.openclaw/workspace",
      "models": {
        "api-proxy-gpt/gpt-4o": { "alias": "GPT-4o" },
        "api-proxy-claude/claude-sonnet-4-5-20250929": { "alias": "Claude Sonnet 4.5" },
        "api-proxy-google/gemini-3-pro-preview": { "alias": "Gemini 3 Pro" }
      },
      "model": {
        "primary": "api-proxy-claude/claude-sonnet-4-5-20250929"
      }
    }
  },
  "auth": {
    "profiles": {
      "api-proxy-gpt:default": { "provider": "api-proxy-gpt", "mode": "api_key" },
      "api-proxy-claude:default": { "provider": "api-proxy-claude", "mode": "api_key" },
      "api-proxy-google:default": { "provider": "api-proxy-google", "mode": "api_key" }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "api-proxy-gpt": {
        "baseUrl": "https://yibuapi.com/v1",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-4o", "name": "GPT-4o", "contextWindow": 128000, "maxTokens": 8192 }
        ]
      },
      "api-proxy-claude": {
        "baseUrl": "https://yibuapi.com",
        "api": "anthropic-messages",
        "models": [
          { "id": "claude-sonnet-4-5-20250929", "name": "Claude Sonnet 4.5", "contextWindow": 200000, "maxTokens": 8192 }
        ]
      },
      "api-proxy-google": {
        "baseUrl": "https://yibuapi.com/v1beta",
        "api": "google-generative-ai",
        "models": [
          { "id": "gemini-3-pro-preview", "name": "Gemini 3 Pro", "contextWindow": 2000000, "maxTokens": 8192 }
        ]
      }
    }
  }
}

第二步：配置鉴权文件

打开：

vim /home/ubuntu/.openclaw/agents/main/agent/auth-profiles.json

填入从 yibuapi.com 获取的真实 API Key：

{
  "version": 1,
  "profiles": {
    "api-proxy-gpt:default": {
      "type": "api_key",
      "provider": "api-proxy-gpt",
      "key": "sk-你的GPT Key"
    },
    "api-proxy-claude:default": {
      "type": "api_key",
      "provider": "api-proxy-claude",
      "key": "sk-你的Claude Key"
    },
    "api-proxy-google:default": {
      "type": "api_key",
      "provider": "api-proxy-google",
      "key": "sk-你的Google Key"
    }
  },
  "lastGood": {
    "api-proxy-gpt": "api-proxy-gpt:default",
    "api-proxy-claude": "api-proxy-claude:default",
    "api-proxy-google": "api-proxy-google:default"
  }
}

第三步：重启服务

pm2 stop openclaw && pm2 delete openclaw && pm2 start "openclaw gateway" --name openclaw

---

六、接入飞书机器人

第一步：进入飞书开放平台

访问 open.feishu.cn，点击右上角「开发者后台」。

第二步：创建企业自建应用

点击「创建企业自建应用」，填写应用名称和描述。

第三步：获取应用凭证

创建完成后记录：

App ID:     cli_xxxxxxxxxxxxxxxxxx
App Secret: xxxxxxxxxxxxxxxxxxxxxxxx

第四步：添加机器人能力

左侧菜单 →「添加应用能力」→「机器人」，点击开启。

第五步：配置应用权限

进入「权限管理」，开通所有即时通讯相关权限：

✅ 获取与发送单聊、群组消息
✅ 读取用户发给机器人的消息
✅ 以应用身份发消息
✅ 获取通讯录基本信息

第六步：创建版本并发布

进入「版本管理与发布」，创建版本后提交发布。到飞书客户端完成审批。

第七步：安装飞书插件

在服务器执行：

cd /home/ubuntu/.openclaw
openclaw plugins install @m1heng-clawd/feishu

如遇到报错 spawn npm ENOENT，手动安装：

cd /home/ubuntu/.openclaw

# 安装插件包
npm install @m1heng-clawd/feishu

# 创建目录结构
mkdir -p extensions/feishu

# 复制文件
cp -r node_modules/@m1heng-clawd/feishu/* extensions/feishu/

# 进入目录安装依赖
cd extensions/feishu
npm install --prod

第八步：配置飞书插件

打开新终端窗口执行：

openclaw config

按向导依次完成：

1. 选择渠道：选择飞书
2. 选择配置链接
3. 输入 App ID 和 App Secret：填入第三步记录的值
4. 域名选择：选择中国
5. 接受群组聊天：选择接受
6. 选择完成
7. 选择 Yes → Open → 继续完成配置

如遇到缺少依赖报错，执行：

cd /home/ubuntu/.openclaw/extensions/feishu
npm install @larksuiteoapi/node-sdk

如安装失败，切换国内镜像：

npm config set registry https://registry.npmmirror.com
npm install @larksuiteoapi/node-sdk

第九步：重启服务使配置生效

pm2 stop openclaw && pm2 delete openclaw && pm2 start "openclaw gateway" --name openclaw

控制台能看到飞书插件已配置成功。

第十步：回到飞书后台设置事件回调

在飞书开放平台：

1. 开通获取通讯录基本信息权限
2. 重新发布版本（同第六步）

---

七、在飞书中与 OpenClaw 完成配对

打开飞书客户端，找到刚创建的机器人，发送任意消息。

如果收到配对提示，说明 OpenClaw 已成功运行，需要完成账号绑定。

在服务器执行以下命令批准配对：

openclaw pairing approve feishu 配对码

将 配对码 替换为飞书提示中显示的实际配对码，例如 FB6Z4XQM。

配对批准后，飞书对话即可正常使用。

---

八、配置 AKShare MCP（金融数据接入）

第一步：克隆 openclaw-mcp-adapter

cd /home/ubuntu
git clone https://github.com/androidStern/openclaw-mcp-adapter.git

第二步：安装插件

openclaw plugins install ./openclaw-mcp-adapter

第三步：进入插件目录安装依赖

cd /home/ubuntu/.openclaw/extensions/openclaw-mcp-adapter
rm -rf node_modules package-lock.json
npm install @modelcontextprotocol/sdk
npm install

第四步：避免插件重复加载

mv /home/ubuntu/openclaw-mcp-adapter /home/ubuntu/openclaw-mcp-adapter.bak

第五步：安装 Python 虚拟环境

sudo apt update
sudo apt install python3-venv -y

第六步：创建虚拟环境并安装 AKShare MCP

cd /home/ubuntu
python3 -m venv akshare-env
source akshare-env/bin/activate
pip install --upgrade pip
pip install akshare_mcp

验证安装：

python -m akshare_mcp -h

能输出帮助信息即为成功。

第七步：修改 openclaw.json 配置插件

vim /home/ubuntu/.openclaw/openclaw.json

在配置文件中添加 plugins 配置块：

"plugins": {
  "allow": ["feishu", "openclaw-mcp-adapter"],
  "entries": {
    "feishu": {
      "enabled": true
    },
    "openclaw-mcp-adapter": {
      "enabled": true,
      "config": {
        "servers": [
          {
            "name": "akshare_mcp",
            "transport": "stdio",
            "command": "/home/ubuntu/akshare-env/bin/python",
            "args": [
              "-m",
              "akshare_mcp",
              "--format",
              "markdown"
            ],
            "env": {}
          }
        ]
      }
    }
  }
}

⚠️ 注意 command 路径要用虚拟环境中的 Python，不要用系统 Python。

第八步：重启服务

pm2 restart openclaw

第九步：验证 AKShare MCP 已加载

pm2 logs openclaw --lines 50 | grep -i "mcp\|akshare"

日志中出现 akshare 相关输出即为加载成功。

---

九、在飞书中测试金融数据查询

配置完成后，打开飞书直接发送以下消息测试：

查询 A 股实时行情：

帮我查一下今天A股的实时行情数据

自动调用 akshare_mcp_stock_zh_a_spot_em 工具

查询今日涨停板：

今天有哪些涨停板的股票？

自动调用 akshare_mcp_stock_zt_pool_em 工具

查看全球主要指数：

我想看看全球主要指数的行情

自动调用 akshare_mcp_index_global_spot_em 工具

查询股票业绩报表：

帮我查一下最近股票的业绩报表数据

自动调用 akshare_mcp_stock_yjbb_em 工具

---

十、常用命令速查

日常操作

# Mac 本地访问远程服务器 UI（建立 SSH 隧道）
ssh -L 18789:localhost:18789 ubuntu@你的服务器IP

# 浏览器访问 Control UI
http://localhost:18789/openclaw

# 带 Token 访问
http://localhost:18789/openclaw?token=你的token

服务管理

# 查看服务状态
pm2 status openclaw

# 重启服务
pm2 restart openclaw

# 完整重启（先停止再启动）
pm2 stop openclaw && pm2 delete openclaw && pm2 start "openclaw gateway" --name openclaw

# 查看实时日志
pm2 logs openclaw

# 查看 MCP 相关日志
pm2 logs openclaw | grep -i "call\|akshare"

设备管理

# 查看设备列表
openclaw devices list

# 批准设备
openclaw devices approve <设备ID>

# 批准飞书配对
openclaw pairing approve feishu <配对码>

---

常见问题排查

问题现象	原因	解决方案
UI 无法访问	端口未放行或多个进程冲突	检查防火墙，确认只有 1 个 openclaw 进程
飞书收不到回复	事件订阅未配置或权限不足	检查飞书后台权限，重新发布版本
配对后仍无响应	设备未批准	执行 openclaw pairing approve feishu 配对码
AKShare 数据查询失败	Python 路径错误	确认 command 填写的是虚拟环境 Python 路径
插件重复加载报错	源码目录被自动加载	将源码目录重命名为 .bak
npm 安装慢或失败	网络问题	切换淘宝镜像：npm config set registry https://registry.npmmirror.com

---

整体架构回顾

飞书客户端（手机/电脑）
        ↓
  飞书服务器事件推送
        ↓
  OpenClaw 飞书插件
  @m1heng-clawd/feishu
        ↓
    OpenClaw 核心
  （Claude / GPT-4o）
        ↓
  openclaw-mcp-adapter
        ↓
    AKShare MCP
  （真实金融数据）
        ↓
  OpenClaw 整合分析
        ↓
  飞书机器人回复消息

---

写在最后

按照本教程配置完成后，你拥有了一个真正可用的飞书 AI 金融助手，能够：

• 📱 在飞书直接用自然语言提问，随时随地
• 📊 调用 AKShare 获取真实的 A 股、基金、宏观数据
• 🧠 由顶级 AI 模型分析数据、给出洞察

AI 分析质量的上限取决于模型能力，本教程使用 一步API（yibuapi.com） 接入 Claude Sonnet、GPT-4o、Gemini 等顶级模型。￥1=$1 充值汇率，一个 Key 接入所有主流模型，稳定低延迟，让你的飞书金融助手跑在最强的大脑上。

👉 立即访问 yibuapi.com，获取你的 API Key

---