openclaw-init — OpenClaw 初始化向导
全新安装 OpenClaw 后的第一步:绑定 main agent 与飞书或企业微信。
完成后即可通过对话使用 feishu-multi-agent-factory 添加更多 agent。
核心脚本
~/.openclaw/workspace/skills/openclaw-init/scripts/init_setup.py
对话流程
第 0 步:检查现状
用户触发时,先运行检查:
python3 ~/.openclaw/workspace/skills/openclaw-init/scripts/init_setup.py --check
- 已初始化 → 告知用户当前状态,可直接使用
feishu-multi-agent-factory - 未初始化 → 进入引导流程
第 1 步:选择 channel 类型
询问用户:
你想用哪个 channel 作为主入口?
1. 飞书(推荐,支持多 bot 独立账号)
2. 企业微信
第 2 步(飞书):收集凭据
需要以下信息:
1. **飞书 App ID**(格式:cli_xxxxxxxx)
→ 飞书开放平台 → 我的应用 → 凭证与基础信息
2. **飞书 App Secret**
→ 同上
3. **主 agent 名称**(可选,默认「主管」)
4. **Emoji**(可选,默认 🦞)
5. **域名**(可选,默认 feishu;国际版填 lark)
收到后执行:
python3 ~/.openclaw/workspace/skills/openclaw-init/scripts/init_setup.py --feishu \
'{"app_id":"cli_xxx","app_secret":"xxx","agent_name":"主管","agent_emoji":"🦞"}'
第 2 步(企业微信):收集凭据
需要以下信息:
1. **企业微信 Bot ID**
→ 企微管理后台 → 应用管理 → 机器人 ID
2. **Secret**
→ 同上
3. **主 agent 名称**(可选,默认「主管」)
4. **Emoji**(可选,默认 🦞)
收到后执行:
python3 ~/.openclaw/workspace/skills/openclaw-init/scripts/init_setup.py --wecom \
'{"bot_id":"aibsXXX","secret":"xxx","agent_name":"主管","agent_emoji":"🦞"}'
第 3 步:确认完成
脚本执行完毕后,告知用户:
✅ 初始化完成!
main agent 已绑定到 [飞书/企业微信]。
下一步:
• 在 [飞书开放平台/企微后台] 将机器人设为「上线」状态
• 向机器人发一条消息测试是否有回复
• 需要添加更多 agent?告诉我,我来帮你用 feishu-multi-agent-factory 配置
自动完成的事项
| 步骤 | 内容 |
|---|---|
| ✅ 检测 | 判断是否全新安装 |
| ✅ 备份 | 自动备份现有 openclaw.json |
| ✅ workspace | 创建 ~/.openclaw/workspace/ + 基础文件 |
| ✅ agentDir | 创建 ~/.openclaw/agents/main/agent/ |
| ✅ channel 配置 | 写入飞书或企业微信凭据 |
| ✅ binding | main agent ↔ channel 绑定 |
| ✅ gateway 重启 | 自动执行 openclaw gateway restart |
常见问题
Q: 飞书机器人在哪里创建?
飞书开放平台(open.feishu.cn)→ 创建企业自建应用 → 添加机器人能力
需开通权限:im:message、im:message.group_at_msg
Q: 企业微信机器人在哪里创建? 企微管理后台(work.weixin.qq.com/wework_admin)→ 应用管理 → 创建自建应用
Q: 初始化完但机器人没回复?
- 确认机器人在对应平台已「上线」
- 运行
openclaw gateway status确认 gateway 正在运行 - 再次运行
--check确认绑定正确
Q: 我已经初始化过,想换绑一个新的飞书账号?
重新运行 --feishu 命令,会自动覆盖旧的 main 绑定(原配置已备份)。
Q: 可以同时绑飞书和企业微信吗?
可以,分别运行 --feishu 和 --wecom 即可,两个 channel 都会对应 main agent。
