OpenClaw 十分钟快速，安装与接入完全指南 - 推荐使用trae 官方 skills 安装

什么是 OpenClaw？

OpenClaw（也被称为"龙虾"或"任意虾"）是一个强大的 AI 助手框架，它可以与飞书等多种平台集成，提供智能对话、文档管理、知识库查询等功能。通过本文的安装指南，你将能够快速搭建并配置 OpenClaw 环境。

安装前准备

（可选traeskills 安装 官方推荐地址 好用已经试过，注意文件使用用户根目录可以解决文件权限问题 mp.weixin.qq.com/s/_qWjfD-CN...

系统要求

• macOS 或 Linux 系统
• 至少 4GB 内存
• Node.js 22+ 版本

所需信息

• 飞书应用的 App ID 和 App Secret
• 模型提供商的 API Key（如 Doubao、Anthropic 等）
• 模型端点 ID（如使用 Doubao 模型）

详细安装步骤

1. 安装 Node Version Manager (nvm)

首先，我们需要安装 nvm 来管理 Node.js 版本：

# 创建 .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+ 版本，我们将安装并设置为默认版本：

# 安装 Node.js 22
nvm install 22 && nvm alias default 22 && nvm use 22 && node -v

3. 安装 OpenClaw

使用 npm 全局安装 OpenClaw：

# 安装 OpenClaw
npm install -g openclaw && openclaw --version

4. 配置 OpenClaw 4.1 配置脚本准备

创建 configure_openclaw.py 配置脚本，用于安全配置 OpenClaw：

#!/usr/bin/env python3
import argparse
import os
import json
import subprocess

def main():
    parser = argparse.ArgumentParser(description='Configure OpenClaw')
    parser.add_argument('--provider', required=True, choices=['doubao', 
    'anthropic'], help='Model provider')
    parser.add_argument('--api-key', required=True, help='API key')
    parser.add_argument('--endpoint-id', help='Endpoint ID (for Doubao)
    ')
    parser.add_argument('--model-name', required=True, help='Model 
    name')
    parser.add_argument('--feishu-app-id', required=True, help='Feishu 
    App ID')
    parser.add_argument('--feishu-app-secret', required=True, 
    help='Feishu App Secret')
    
    args = parser.parse_args()
    
    # 设置环境变量
    os.environ['DOUBAO_API_KEY'] = args.api_key if args.provider == 
    'doubao' else os.environ.get('DOUBAO_API_KEY', '')
    os.environ['ANTHROPIC_API_KEY'] = args.api_key if args.provider == 
    'anthropic' else os.environ.get('ANTHROPIC_API_KEY', '')
    
    # 配置模型
    model_config = {
        "default": args.provider + '/' + (args.endpoint_id if args.
        endpoint_id else args.model_name)
    }
    
    # 创建配置目录
    os.makedirs(os.path.expanduser('~/.openclaw'), exist_ok=True)
    
    # 写入模型配置
    with open(os.path.expanduser('~/.openclaw/models.json'), 'w') as f:
        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)
    
    # 写入飞书配置
    with open(os.path.expanduser('~/.openclaw/extensions/feishu/config.
    json'), 'w') as f:
        json.dump(feishu_config, f, indent=2)
    
    # 安装飞书插件
    subprocess.run(['openclaw', 'plugins', 'install', '@openclaw/
    feishu'], check=True)
    
    print("OpenClaw configuration completed successfully!")

if __name__ == '__main__':
    main()
``` 4.2 执行配置脚本
根据你选择的模型提供商，执行相应的配置命令：

对于 Doubao 模型：

python3 configure_openclaw.py --provider doubao --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 模型：

python3 configure_openclaw.py --provider anthropic --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 安装并启动网关服务

安装网关服务 openclaw gateway install

启动网关服务 openclaw gateway start

检查服务状态 openclaw gateway status

如果系统服务安装失败，可以直接运行网关：

直接运行网关 openclaw gateway

## 飞书集成配置
### 1. 构建事件订阅 URL
使用你的飞书 App ID 构建事件订阅 URL：

open.larkoffice.com/app/YOUR_FE...

### 2. 配置飞书开发者控制台
1. 访问 飞书开发者控制台
2. 进入 事件订阅 配置
3. 设置请求 URL（通常是你的 OpenClaw 服务器公网地址）
4. 创建版本并发布应用，使更改生效
## 常见问题解决
### 1. 网关令牌缺失错误
如果遇到 "unauthorized: gateway token missing" 错误：

生成网关令牌 openclaw dashboard --no-open # 或 openclaw doctor --generate-gateway-token

然后将生成的令牌添加到 Control UI 设置中。

### 2. 模型配置错误
如果遇到模型相关错误，检查模型配置是否正确：

- 对于 Doubao 模型，确保使用正确的端点 ID 格式： doubao/ep-xxxxxxxxxxxxxx
- 对于 Anthropic 模型，确保使用正确的模型名称
### 3. 服务启动失败
如果服务启动失败，检查端口是否被占用：

检查端口占用情况 lsof -i :18789

如果端口被占用，停止占用该端口的进程 kill -9 PID

## 验证安装
### 1. 检查服务状态

检查 OpenClaw 网关状态 openclaw gateway status

### 2. 测试飞书集成
在飞书中向机器人发送消息，检查是否能正常响应。

## 技能安装
OpenClaw 支持安装各种技能来扩展功能，例如前端开发相关技能：

从 ClawHub 安装技能 openclaw skills install frontend-dev openclaw skills install react-dev openclaw skills install frontend-build

## 总结
通过以上步骤，你已经成功安装并配置了 OpenClaw 环境，包括：

1. 安装了 Node.js 22 并设置为默认版本
2. 安装了 OpenClaw 核心框架
3. 配置了飞书集成和模型设置
4. 启动了 OpenClaw 网关服务
5. 验证了服务运行状态
OpenClaw 现在已经准备就绪，可以为你提供智能助手服务，帮助你处理各种任务，提高工作效率。

提示： 定期更新 OpenClaw 以获取最新功能和安全补丁：

更新 OpenClaw npm update -g openclaw

希望本文对你有所帮助，祝你使用 OpenClaw 愉快！