OpenClaw 国内网络使用 本地部署

#
OpenClaw
本地化
部署完整指南
OpenClaw（又称
Clawdbot、LobsterAI）是一款开源的跨平台 AI 助手前端，支持多种 AI 模型接入和
本地化
部署。本文将详细介绍在不同操作系统上的
部署流程、配置方法和常见问题解决方案。 一、环境准备 基础依赖安装 所有平台
部署都需要先安装以下基础环境： “`bash # 安装 Node.js（版本要求 v24.13.0+） # 可以从官网 https://nodejs.org/ 下载安装包 # 安装 Git # Windows：https://git-scm.com/ # macOS：brew install git # Linux：sudo apt install git “` 验证安装： “`bash node –version npm –version git –version “`
OpenClaw 核心安装 “`bash #
使用 npm 全局安装
OpenClaw npm install -g @
openclaw/cli # 或者
使用 yarn yarn global add @
openclaw/cli “` 二、Windows 平台
部署 1. 快速安装配置 “`powershell # 初始化
OpenClaw 配置
openclaw init # 启动网关服务
openclaw start “` 2. 网关模式配置 在配置文件 `~/.
openclaw/config.json` 中设置网关模式： “`json { “gateway”: { “mode”: “standalone”, “port”: 18789, “host”: “localhost” }, “models”: { “default”: “deepseek”, “providers”: { “deepseek”: { “apiKey”: “your-deepseek-api-key”, “baseURL”: “https://api.deepseek.com” } } } } “` 3. Token 认证配置 [ref_1] “`json { “security”: { “tokens”: [“your-secure-token-here”], “enableAuth”: true } } “` 三、macOS 平台
部署 1.
使用 Homebrew 环境 “`bash # 安装 Homebrew（如未安装） /bin/bash -c “$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)” # 安装 Node.js brew install node # 安装
OpenClaw npm install -g @
openclaw/cli “` 2. DeepSeek 模型配置 [ref_4] “`json { “version”: “2026.2.6-3”, “gateway”: { “port”: 18789, “host”: “0.0.0.0” }, “models”: { “default”: “deepseek-chat”, “providers”: { “deepseek”: { “apiKey”: “sk-your-deepseek-api-key”, “models”: { “deepseek-chat”: “deepseek-chat”, “deepseek-coder”: “deepseek-coder” } } } } } “` 3. 启动与验证 “`bash # 启动网关服务
openclaw start # 验证服务状态 curl http://localhost:18789/health # 访问 Web UI
open http://localhost:18789 “` 四、多模型接入配置 1. Ollama
本地模型接入 [ref_6] “`json { “models”: { “providers”: { “ollama”: { “baseURL”: “http://localhost:11434”, “models”: [“llama3”, “mistral”, “codellama”] } } } } “` 2. Claude API 配置 [ref_5] “`json { “models”: { “providers”: { “claude”: { “apiKey”: “your-anthropic-key”, “models”: [“claude-3-sonnet”, “claude-3-haiku”] } } } } “` 3. Failover 故障转移配置 [ref_6] “`json { “models”: { “fallback”: { “enabled”: true, “primary”: [”
openai”, “claude”], “secondary”: [“ollama”], “healthCheck”: { “interval”: 30000, “timeout”: 5000 } } } } “` 五、跨平台多设备
部署 主节点配置 [ref_2] “`bash # 在主设备上初始化
openclaw init –master # 生成设备配对码
openclaw pair –generate-code “` 客户端接入配置 “`json { “sync”: { “masterUrl”: “http://your-master-ip:18789”, “deviceToken”: openclaw 部署 “your-pairing-token”, “autoSync”: true } } “` 六、小红书 MCP 集成
部署 [ref_3] 1. MCP 服务配置 “`bash # 下载 xiaohongshu-mcp 二进制 wget https://github.com/
openclaw/xiaohongshu-mcp/releases/latest/download/xiaohongshu-mcp-linux-amd64 # 赋予执行权限 chmod +x xiaohongshu-mcp-linux-amd64 # 启动 MCP 服务 ./xiaohongshu-mcp-linux-amd64 –port 8080 “` 2.
OpenClaw 对接配置 “`json { “mcp”: { “servers”: { “xiaohongshu”: { “command”: “node”, “args”: [“./xiaohongshu-mcp.js”], “env”: { “REDBOOK_USERNAME”: “your-username”, “REDBOOK_PASSWORD”: “your-password” } } } } } “` 3. 功能调用示例 “`javascript // 发布图文内容 const result = await
openclaw.mcp.xiaohongshu.publish({ content: “测试内容”, images: [“image1.jpg”, “image2.jpg”], tags: [“测试”, ”
OpenClaw“] }); // 搜索内容 const searchResults = await
openclaw.mcp.xiaohongshu.search({ keyword: “AI助手”, page: 1 }); “` 七、Antigravity Manager 集成 [ref_5] 1. Antigravity 安装配置 “`bash # 安装 Antigravity Manager npm install -g antigravity-manager # 启动管理服务 antigravity start “` 2. 多模型统一管理 “`yaml # antigravity-config.yaml models: – name: “claude-3-sonnet” provider: “anthropic” apiKey: “${ANTHROPIC_API_KEY}” enabled: true – name: “gemini-pro” provider: “google” apiKey: “${GOOGLE_API_KEY}” enabled: true – name: “gpt-4″ provider: ”
openai” apiKey: “${
OPENAI_API_KEY}” enabled: true “` 八、常见问题与解决方案 1. 网关启动失败 问题：`gateway.mode` 未设置或配置错误 解决方案： “`json { “gateway”: { “mode”: “standalone”, “port”: 18789, “host”: “0.0.0.0” } } “` 2. Token 认证失败 [ref_1] 问题：访问被拒绝，提示 Token 缺失 解决方案： “`bash # 生成安全 Token
openssl rand -base64 32 # 在配置文件中添加 echo ‘{“security”:{“tokens”:[“生成的token”],”enableAuth”:true}}’ >> ~/.
openclaw/config.json “` 3. 端口冲突 解决方案： “`bash # 检查端口占用 netstat -tulpn | grep 18789 # 更改端口配置
openclaw config set gateway.port 18888 “` 4. 模型 API 连接失败 [ref_6] 解决方案： “`json { “models”: { “fallback”: { “enabled”: true, “primary”: [”
openai”], “secondary”: [“ollama”], “healthCheck”: { “interval”: 30000 } } } } “` 九、高级功能配置 1. 定时任务配置 [ref_3] “`javascript // 自动化运营任务 const schedule = { “dailyReport”: { “cron”: “0 9 * * *”, “action”: “mcp.xiaohongshu.generateDailyReport”, “enabled”: true }, “competitorMonitor”: { “cron”: “*/30 * * * *”, “action”: “mcp.xiaohongshu.monitorCompetitors”, “enabled”: true } }; “` 2. 飞书集成配置 “`json } } “` 十、
部署验证与监控 服务健康检查 “`bash # 检查网关状态 curl http://localhost:18789/health # 检查模型连接 curl http://localhost:18789/models/health # 查看运行日志
openclaw logs –follow “` 性能监控配置 “`json { “monitoring”: { “enabled”: true, “metrics”: { “responseTime”: true, “errorRate”: true, “throughput”: true }, “alerting”: { “slackWebhook”: “your-slack-webhook-url”, “email”: “” } } } “` 通过以上完整的
部署指南，您可以在不同平台上成功
部署
OpenClaw，并根据需求配置多种 AI 模型和第三方服务集成。
本地化
部署确保了数据隐私和安全，同时提供了灵活的扩展能力。