OpenClaw + Ollama + 火山引擎：本地化 AI Agent 完整部署指南

前言OpenClaw 是一个功能强大的 AI Agent 框架支持本地模型Ollama和云端 API火山引擎、DeepSeek 等。本文将手把手教你从零开始在 Windows 上使用 Docker 部署 OpenClaw并配置本地模型和火山引擎豆包 API。环境要求Windows 10/11已安装 Docker Desktop启用 WSL 2至少 8GB 内存推荐 16GBNVIDIA GPU可选用于加速本地模型一、创建 Docker 网络powershelldocker network create my-network二、部署依赖服务1. PostgreSQL用于存储会话数据powershelldocker run -d --name my-postgres --network my-network -e POSTGRES_PASSWORD你的密码 -e POSTGRES_USERpostgres -e POSTGRES_DBmydb -p 5432:5432 -v postgres_data:/var/lib/postgresql/data postgres:latest2. Redis用于缓存powershelldocker run -d --name my-redis --network my-network -p 6379:6379 -v redis_data:/data redis:latest3. Ollama本地大模型服务powershelldocker run -d --name ollama --network my-network --gpus all -p 11434:11434 -v ollama_data:/root/.ollama ollama/ollama:latest4. 拉取本地模型可选powershelldocker exec ollama ollama pull deepseek-r1:1.5b docker exec ollama ollama pull deepseek-r1:7b三、配置 OpenClaw1. 创建配置目录powershellNew-Item -ItemType Directory -Force -Path E:\Docker\openclaw-data | Out-Null2. 编写配置文件保存为E:\Docker\openclaw-data\openclaw.jsonjson{ gateway: { mode: local, port: 18789, bind: lan, auth: { mode: token, token: 定义的token用于后续webui访问 }, controlUi: { allowedOrigins: [http://localhost:18789, http://127.0.0.1:18789] } }, models: { providers: { ollama: { baseUrl: http://ollama:11434, apiKey: ollama, api: ollama, models: [ { id: deepseek-r1:1.5b, name: DeepSeek R1 1.5B, contextWindow: 4096, maxTokens: 4096, reasoning: false }, { id: deepseek-r1:7b, name: DeepSeek R1 7B, contextWindow: 131072, maxTokens: 8192, reasoning: false } ] }, volcano: { baseUrl: https://ark.cn-beijing.volces.com/api/v3, apiKey: 你的火山引擎API Key, api: openai-completions, models: [ { id: ep-你的接入点ID, name: 豆包 Mini, contextWindow: 128000, maxTokens: 8192, reasoning: false } ] } } }, agents: { defaults: { model: ollama/deepseek-r1:1.5b } } }注意火山引擎部分需要替换为真实 API Key 和接入点 ID不需要可删除。四、启动 OpenClawpowershelldocker run -d --name openclaw --network my-network -v E:\Docker\openclaw-data:/home/node/.openclaw -v /var/run/docker.sock:/var/run/docker.sock -p 18789:18789 ghcr.io/openclaw/openclaw:latest五、验证部署powershell# 查看容器状态 docker ps # 查看 OpenClaw 日志 docker logs openclaw --tail 30 # 健康检查 curl http://localhost:18789/health六、访问 Web UI浏览器打开http://127.0.0.1:18789/?token定义的token七、常用管理命令powershell# 启动所有服务 docker start my-postgres my-redis ollama openclaw # 停止所有服务 docker stop my-postgres my-redis ollama openclaw # 重启 OpenClaw docker restart openclaw # 查看实时日志 docker logs openclaw -f # 进入 TUI 终端界面 docker exec -it openclaw openclaw tui # 清理未使用的 Docker 资源 docker system prune -a八、故障排查1. 查看容器日志powershelldocker logs 容器名 --tail 502. 进入容器内部调试powershelldocker exec -it openclaw bash3. 检查端口占用powershellnetstat -ano | findstr :187894. 测试本地模型powershelldocker exec ollama ollama run deepseek-r1:1.5b 你好5. 测试火山引擎 APIpowershell$headers { Content-Type application/json Authorization Bearer 你的API Key } $body {model:你的模型ID,messages:[{role:user,content:你好}]} Invoke-RestMethod -Uri https://ark.cn-beijing.volces.com/api/v3/chat/completions -Method Post -Headers $headers -Body $body九、完整清理重装用powershell# 停止并删除所有容器 docker stop my-postgres my-redis ollama openclaw docker rm my-postgres my-redis ollama openclaw # 删除数据卷 docker volume rm postgres_data redis_data ollama_data # 删除配置目录 Remove-Item -Path E:\Docker\openclaw-data -Recurse -Force # 删除网络 docker network rm my-network十、目录结构textE:\Docker\ ├── openclaw-data\ │ ├── openclaw.json # 配置文件 │ └── workspace\ # Agent 工作区 ├── postgres_data\ # PostgreSQL 数据 ├── redis_data\ # Redis 数据 └── ollama_data\ # Ollama 模型数据十一、版本信息组件镜像PostgreSQLpostgres:latestRedisredis:latestOllamaollama/ollama:latestOpenClawghcr.io/openclaw/openclaw:latest 结语至此你已经成功部署了一套完整的本地 AI Agent 环境。你可以在 Web UI 中切换本地模型和云端 API通过 TUI 进行终端交互后续可以配置沙箱、工具调用等高级功能如果遇到问题欢迎在评论区留言交流相关资源OpenClaw GitHubhttps://github.com/openclaw/openclawOllama 官网https://ollama.com火山引擎账号登录-火山引擎