安装

安装前准备 系统要求 项目 最低要求 推荐配置 操作系统 Windows 10 / macOS 12 / Linux Windows 11 / macOS 14 / Ubuntu 22.04 内存 2GB 4GB 以上 磁盘 10GB 20GB 以上 网络 稳定连接 高速连接 软件依赖 Node.js：16 或以上版本 Python：3.8 或以上版本 Git：用于版本控制 安装步骤 第一步：安装 Node.js Windows 访问 nodejs.org 下载 LTS 版本 运行安装程序 验证安装：node --version macOS # 使用 Homebrew 安装 brew install node # 验证安装 node --version Linux # Ubuntu/Debian curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash - sudo apt-get install -y nodejs # 验证安装 node --version 第二步：安装 Python Windows 访问 python.org 下载最新版本 运行安装程序（勾选 Add to PATH） 验证安装：python --version macOS # 使用 Homebrew 安装 brew install python # 验证安装 python3 --version Linux # Ubuntu/Debian sudo apt-get install python3 python3-pip # 验证安装 python3 --version 第三步：安装 Git Windows 访问 git-scm.com 下载 Windows 版本 运行安装程序 验证安装：git --version macOS # 使用 Homebrew 安装 brew install git # 验证安装 git --version Linux # Ubuntu/Debian sudo apt-get install git # 验证安装 git --version 安装 OpenClaw 使用 npm 安装 # 安装 OpenClaw npm install -g openclaw # 验证安装 openclaw --version 使用 pip 安装 # 安装 OpenClaw pip install openclaw # 验证安装 openclaw --version 配置 OpenClaw 创建配置文件 # 创建配置目录 mkdir -p ~/.qclaw/config # 创建配置文件 touch ~/.qclaw/config/openclaw.toml 编辑配置文件 # ~/.qclaw/config/openclaw.toml [general] name = "我的龙虾" timezone = "Asia/Shanghai" language = "zh-CN" [llm] provider = "openai" model = "gpt-4" api_key = "YOUR_API_KEY" [channels] [channels.webchat] enabled = true port = 8080 配置 LLM 提供商 OpenAI [llm] provider = "openai" model = "gpt-4" api_key = "sk-xxxxxxxxxxxxxxxxxxxxxxxx" Anthropic [llm] provider = "anthropic" model = "claude-3-opus-20240229" api_key = "sk-ant-xxxxxxxxxxxxxxxxxxxxxxxx" 本地模型 [llm] provider = "local" model = "qwen3.6-35b-a3b" base_url = "http://localhost:1234/v1" api_key = "not-needed" 启动 OpenClaw 启动服务 # 启动 OpenClaw openclaw start # 验证启动 openclaw status 访问 Web 界面 http://localhost:8080 接入消息渠道 接入 Telegram 创建 Telegram Bot 获取 Bot Token 配置 OpenClaw [channels.telegram] token = "YOUR_BOT_TOKEN" webhook_url = "https://example.com/webhook" 接入 Discord 创建 Discord Bot 获取 Bot Token 配置 OpenClaw [channels.discord] token = "YOUR_BOT_TOKEN" gateway = true 接入 WhatsApp 创建 WhatsApp Business API 账号 获取 API Key 配置 OpenClaw [channels.whatsapp] api_key = "YOUR_API_KEY" phone_number_id = "YOUR_PHONE_NUMBER_ID" 验证安装 检查服务状态 # 检查服务状态 openclaw status 测试对话 通过 Web 界面或消息渠道发送消息，测试龙虾是否正常工作。 ...

四种接入方式 Codex 2026 提供四种接入方式，适用于不同场景： 方式 适合人群 功能范围 安装难度 网页端 所有用户 编程 + 对话 ★ 桌面 App 日常使用 全功能 Agent ★★ IDE 插件 开发者 编程为主 ★★ CLI 高级用户 全功能 + 脚本化 ★★★ 方式一：网页端 直接访问 chatgpt.com/codex，登录 OpenAI 账号即可使用。 适合快速体验，无需安装任何东西。但无法使用 OSS 模式和本地文件操作。 方式二：桌面 App Windows 安装 # 方式1: Winget winget install OpenAI.Codex # 方式2: 直接下载 # 从 https://openai.com/codex/download 下载 .exe 安装包 macOS 安装 # Homebrew brew install --cask codex # 或直接下载 .dmg Linux 安装 # AppImage wget https://openai.com/codex/download/codex-linux.AppImage chmod +x codex-linux.AppImage sudo mv codex-linux.AppImage /usr/local/bin/codex 桌面 App 提供完整的 Agent 功能，包括文件操作、浏览器控制等。 ...

环境要求 基本环境 组件 最低版本 推荐版本 说明 Node.js 18.0 22 LTS 主运行时 Python 3.10 3.12 复盘 LLM 与工具脚本 Git 2.30 latest 版本管理 RAM 4 GB 16 GB+ 本地模型需更多 磁盘 2 GB 20 GB+ 技能库与记忆数据库 操作系统支持 系统 支持 备注 Linux (Ubuntu 22.04+) ✅ 原生 最佳支持 macOS (13+) ✅ 原生 Apple Silicon 优秀 Windows (10/11) ✅ WSL2 原生支持有限，建议 WSL2 Docker ✅ 跨平台推荐方式 Raspberry Pi ✅ 需使用轻量模型 安装步骤 方式一：快速安装（推荐） # 一键安装脚本 curl -fsSL https://raw.githubusercontent.com/nousresearch/hermes-agent/main/install.sh | bash # 或手动安装 git clone https://github.com/nousresearch/hermes-agent.git cd hermes-agent npm install pip install -r requirements.txt 方式二：Docker 安装 # 拉取官方镜像 docker pull nousresearch/hermes-agent:latest # 快速启动 docker run -d \ --name hermes \ -p 3000:3000 \ -v hermes-memory:/app/memory \ -v hermes-skills:/app/skills \ -e PRIMARY_LLM_PROVIDER=openai \ -e OPENAI_API_KEY=$OPENAI_API_KEY \ nousresearch/hermes-agent:latest 方式三：Docker Compose # docker-compose.yml version: '3.8' services: hermes: image: nousresearch/hermes-agent:latest ports: - "3000:3000" volumes: - hermes-memory:/app/memory - hermes-skills:/app/skills - ./config.yaml:/app/config.yaml environment: - PRIMARY_LLM_PROVIDER=openai - OPENAI_API_KEY=${OPENAI_API_KEY} - REFLECTION_LLM_PROVIDER=ollama - OLLAMA_HOST=http://ollama:11434 depends_on: - ollama restart: unless-stopped ollama: image: ollama/ollama:latest volumes: - ollama-models:/root/.ollama ports: - "11434:11434" restart: unless-stopped volumes: hermes-memory: hermes-skills: ollama-models: docker-compose up -d 模型配置 Hermes 兼容 200+ 模型，通过统一配置接口管理。 ...