给 OpenClaw 新增一个 Agent（以飞书机器人为例）

想给自己的飞书加一个专属 AI 机器人？

这篇教程手把手教你从零开始，在 OpenClaw 里新建一个独立的 Agent，并接入飞书。跟着做就行，不需要懂内部原理。

已经装好并能正常运行的 OpenClaw
一个飞书开发者账号，并已经在飞书开放平台创建好了一个 App（没有的话先去 open.feishu.cn/app 新建一个）
终端基本操作能力（会复制粘贴命令就够了）

每个 Agent 都有自己的"家"，住在 ~/.openclaw/agents/<agentname>/ 下面。

把 agentname 换成你想取的名字，比如 mybot。

打开终端，依次运行：

mkdir -p ~/.openclaw/agents/mybot/workspace/skills
mkdir -p ~/.openclaw/agents/mybot/workspace/tasks
mkdir -p ~/.openclaw/agents/mybot/workspace/results
mkdir -p ~/.openclaw/agents/mybot/workspace/memory
mkdir -p ~/.openclaw/agents/mybot/agent
mkdir -p ~/.openclaw/agents/mybot/sessions

然后初始化 sessions 文件：

echo '{"sessions":[]}' > ~/.openclaw/agents/mybot/sessions/sessions.json

接着把 models.json 和 auth-profiles.json 从现有 Agent 复制过来（直接用主 Agent 的就行）：

cp ~/.openclaw/agents/main/agent/models.json ~/.openclaw/agents/mybot/agent/
cp ~/.openclaw/agents/main/agent/auth-profiles.json ~/.openclaw/agents/mybot/agent/

目录结构建好了，接下来写配置文件。

第二步：写核心配置文件

这些文件决定了你的 Agent 是什么性格、干什么活、认识谁。挨个创建就行。

SOUL.md — Agent 的灵魂

cat > ~/.openclaw/agents/mybot/workspace/SOUL.md << 'EOF'
# SOUL.md

你是 MyBot，一个简洁高效的助手。

## 性格
- 回答简短直接，不废话
- 友好但不过分热情
- 不确定的事情说不确定，不瞎编

## 职责
- 回答用户问题
- 协助处理日常任务

## 禁止事项
- 不发布任何外部消息（邮件、推文等）除非明确被要求
- 不删除重要文件
EOF

IDENTITY.md — 名字和角色

cat > ~/.openclaw/agents/mybot/workspace/IDENTITY.md << 'EOF'
# IDENTITY.md

- **Name:** MyBot
- **Role:** 飞书助手
- **Emoji:** 🤖
EOF

AGENTS.md — 工作规范

cat > ~/.openclaw/agents/mybot/workspace/AGENTS.md << 'EOF'
# AGENTS.md

## 每次会话开始
1. 读 SOUL.md
2. 读 USER.md
3. 读今天的 memory/YYYY-MM-DD.md（如果存在）

## 记忆
- 日常记录写到 memory/YYYY-MM-DD.md
- 重要信息更新到 MEMORY.md
EOF

USER.md — 用户是谁

cat > ~/.openclaw/agents/mybot/workspace/USER.md << 'EOF'
# USER.md

- **Name:** 你的名字
- **Timezone:** Asia/Shanghai
- **Notes:** 根据实际情况填写
EOF

MEMORY.md — 长期记忆（不能省！）

这个文件一定要创建，哪怕内容很简单。原因后面踩坑部分会说。

cat > ~/.openclaw/agents/mybot/workspace/MEMORY.md << 'EOF'
# MEMORY.md

这是 MyBot 的长期记忆文件。

## 基本信息
- 我是 MyBot，运行在飞书频道的助手
- 创建时间：2026-03-05
EOF

HEARTBEAT.md 和 TOOLS.md

echo '# HEARTBEAT.md\n\n# 暂无心跳任务' > ~/.openclaw/agents/mybot/workspace/HEARTBEAT.md
echo '# TOOLS.md\n\n# 工具备注（暂无）' > ~/.openclaw/agents/mybot/workspace/TOOLS.md

第三步：软连接 Skills（可选）

如果你希望新 Agent 也能用全局的 skills，跑这段脚本：

cd ~/.openclaw/agents/mybot/workspace/skills
GLOBAL_SKILLS=~/.openclaw/workspace/skills
for skill in $(ls "$GLOBAL_SKILLS"); do
  ln -sf "$GLOBAL_SKILLS/$skill" "$skill"
done

不需要的话这步跳过也没问题。

第四步：修改 openclaw.json

这是最重要的一步，三个地方都要改，一个都不能漏。

用编辑器打开 ~/.openclaw/openclaw.json。

1. 在 agents.list 数组里加入新 Agent

找到 agents → list 数组，在里面追加：

{
  "id": "mybot",
  "name": "mybot",
  "workspace": "/Users/你的用户名/.openclaw/agents/mybot/workspace",
  "agentDir": "/Users/你的用户名/.openclaw/agents/mybot/agent",
  "model": "github-copilot/claude-sonnet-4.6",
  "identity": {
    "name": "MyBot",
    "emoji": "🤖"
  },
  "account": "mybot"
}

记得把 你的用户名 换成你本机的实际用户名，可以用 whoami 命令查看。

2. 在 channels.feishu.accounts 里加飞书账号

找到 channels → feishu → accounts，加入：

"mybot": {
  "appId": "cli_xxxxxxxx",
  "appSecret": "xxxxxxxxxxxxxxxx",
  "dmPolicy": "open",
  "domain": "feishu",
  "enabled": true,
  "allowFrom": ["*"],
  "groupPolicy": "open"
}

appId 和 appSecret 在飞书开放平台你的 App 里找，位置：凭证与基础信息 → App ID / App Secret。

3. 在顶层 bindings 数组里加路由规则

⚠️ 这是最容易漏掉的一步！ 找到顶层的 bindings 数组（不是某个 agent 里面的），加入：

{
  "agentId": "mybot",
  "match": {
    "channel": "feishu",
    "accountId": "mybot"
  }
}

没有这条规则，飞书消息会被路由到主 Agent，新 Agent 永远收不到消息。

第五步：重启 OpenClaw Gateway

配置文件改完之后，必须重启 Gateway 才能生效：

openclaw gateway restart
openclaw gateway status

看到 RPC probe: ok 就说明启动成功了。

⚠️ 顺序很重要：必须先把 Gateway 跑起来，才能去飞书配置长连接。顺序反了飞书那边会报错。

第六步：飞书开发者后台配置

进入飞书开放平台，找到你的 App
权限管理 → 搜索并开通以下三个权限：
- im:message
- im:message:send_as_bot
- contact:user.id:readonly
事件与回调 → 消息与事件订阅 → 选择长连接模式 → 点击开启
- ⚠️ 此时 Gateway 必须已经在跑，否则页面会提示"未检测到应用连接信息"，开启会失败
订阅事件，搜索并添加：im.message.receive_v1
保存配置，发布应用（版本管理 → 创建版本 → 发布）