什么是 OpenClaw？飞书 AI 助手框架详解
OpenClaw，也被称为“龙虾”或“任意虾”，是一个能够将 AI 能力无缝接入飞书等协作平台的轻量级助手框架。它支持智能对话、文档管理、知识库查询等多种功能。如果你想自行搭建一套属于自己的 AI 助手环境，这篇快速入门指南将为你提供清晰、完整的部署步骤。
安装前准备：环境与信息核查
在正式开始动手之前，请先确认环境条件是否满足。一个小贴士：后续配置文件路径建议使用用户根目录（~），这样可以省去不少文件权限的麻烦。
系统要求
- macOS 或 Linux 操作系统
- 至少 4GB 可用内存
- Node.js 22 及以上版本
所需信息
- 飞书应用的 App ID 和 App Secret
- 模型提供商的 API Key（例如豆包 Doubao、Anthropic）
- 如果使用 Doubao 模型，还需要模型端点 ID
详细安装步骤：从零搭建 OpenClaw
1. 安装 Node Version Manager (nvm)
首先安装 Node.js 版本管理工具 nvm，避免后续版本切换带来的麻烦：
#创建.zshrc文件（如果不存在）touch~/.zshrc&&curl-o-https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh|bash&&source~/.zshrc&&nvm--version
2. 安装并配置 Node.js 22
OpenClaw 要求 Node.js 版本不低于 22，安装完成后直接设为默认版本：
nvminstall22&&nvmaliasdefault22&&nvmuse22&&node-v
3. 安装 OpenClaw 核心框架
通过 npm 全局安装，一步到位：
#安装OpenClawnpminstall-gopenclaw&&openclaw--version
4. 配置 OpenClaw
4.1 配置脚本准备
创建一个名为 configure_openclaw.py 的 Python 脚本，用于一次性完成所有安全配置：
#!/usr/bin/envpython3importargparseimportosimportjsonimportsubprocessdefmain():parser=argparse.ArgumentParser(description='ConfigureOpenClaw')parser.add_argument('--provider',required=True,choices=['doubao','anthropic'],help='Modelprovider')parser.add_argument('--api-key',required=True,help='APIkey')parser.add_argument('--endpoint-id',help='EndpointID(forDoubao)')parser.add_argument('--model-name',required=True,help='Modelname')parser.add_argument('--feishu-app-id',required=True,help='FeishuAppID')parser.add_argument('--feishu-app-secret',required=True,help='FeishuAppSecret')args=parser.parse_args()#设置环境变量os.environ['DOUBAO_API_KEY']=args.api_keyifargs.provider=='doubao'elseos.environ.get('DOUBAO_API_KEY','')os.environ['ANTHROPIC_API_KEY']=args.api_keyifargs.provider=='anthropic'elseos.environ.get('ANTHROPIC_API_KEY','')#配置模型model_config={"default":args.provider+'/'+(args.endpoint_idifargs.endpoint_idelseargs.model_name)}#创建配置目录os.makedirs(os.path.expanduser('~/.openclaw'),exist_ok=True)#写入模型配置withopen(os.path.expanduser('~/.openclaw/models.json'),'w')asf:json.dump(model_config,f,indent=2)#配置飞书feishu_config={"appId":args.feishu_app_id,"appSecret":args.feishu_app_secret}#创建飞书配置目录os.makedirs(os.path.expanduser('~/.openclaw/extensions/feishu'),exist_ok=True)#写入飞书配置withopen(os.path.expanduser('~/.openclaw/extensions/feishu/config.json'),'w')asf:json.dump(feishu_config,f,indent=2)#安装飞书插件subprocess.run(['openclaw','plugins','install','@openclaw/feishu'],check=True)print("OpenClawconfigurationcompletedsuccessfully!")if__name__=='__main__':main()
4.2 执行配置脚本
根据你选择的模型供应商，执行对应的配置命令：
例如，使用 Doubao 模型：
python3configure_openclaw.py--providerdoubao--api-key"YOUR_API_KEY"--endpoint-id"YOUR_ENDPOINT_ID"--model-name"Doubao-1.8"--feishu-app-id"YOUR_APP_ID"--feishu-app-secret"YOUR_APP_SECRET"
如果选择 Anthropic 模型：
python3configure_openclaw.py--provideranthropic--api-key"YOUR_API_KEY"--model-name"claude-3-5-sonnet-20240620"--feishu-app-id"YOUR_APP_ID"--feishu-app-secret"YOUR_APP_SECRET"
5. 启动 OpenClaw 服务
5.1 安装并启动网关服务
先安装网关组件：
openclawgatewayinstall
启动网关服务：
openclawgatewaystart
检查服务运行状态：
openclawgatewaystatus
如果系统服务无法安装，也可以直接在前台运行：
openclawgateway
飞书集成配置：将 AI 机器人接入飞书
1. 构建事件订阅 URL
使用你的飞书应用 App ID 拼接出事件订阅地址：
open.larkoffice.com/app/YOUR_FE…
2. 配置飞书开发者控制台
登录飞书开发者控制台，进入“事件订阅”设置页面，填入请求 URL（通常是你的服务器公网地址），然后创建版本、发布应用，使配置生效。
常见问题解决
1. 网关令牌缺失错误
如果遇到 “unauthorized: gateway token missing” 错误，请先执行以下命令生成令牌：
openclawdashboard--no-open#或openclawdoctor--generate-gateway-token
将生成的令牌填写到 Control UI 的设置中即可。
2. 模型配置错误
模型报错时，请检查配置格式是否正确：
- Doubao 模型需要确认端点 ID 格式是否为 doubao/ep-xxxxxxxxxxxxxx
- Anthropic 模型需确保模型名称（如 claude-3-5-sonnet-20240620）拼写无误
3. 服务启动失败
服务无法启动？极有可能是端口被占用。使用以下命令检查 18789 端口：
lsof-i:18789
找到占用端口的进程，并强制终止：
kill-9PID
验证安装：确认服务正常运行
1. 检查服务状态
openclawgatewaystatus
2. 测试飞书集成
在飞书中向机器人发送一条消息，观察是否能正常接收并回复。
技能安装：扩展 AI 助手能力
OpenClaw 支持通过 ClawHub 安装各种技能，例如前端开发相关技能：
openclawskillsinstallfrontend-devopenclawskillsinstallreact-devopenclawskillsinstallfrontend-build
总结：快速回顾安装流程
按照本指南操作，你已经完成了以下关键步骤：
- 安装了 Node.js 22 并设为默认版本
- 成功安装 OpenClaw 核心框架
- 配置了飞书集成和模型参数
- 启动并验证了 OpenClaw 网关服务
- 测试了飞书机器人的正常响应
现在 OpenClaw 已准备就绪，可以协助你处理各类智能任务。建议定期执行 npm update -g openclaw 来获取最新功能和安全更新。
