OpenCrow部署指南

OpenCrow推荐使用2核4G的配置，可以购买BandwagonHost 的 VPS - Self-managed - 80G KVM - PROMO 型号的主机，配置如下：

VPS - Self-managed - 80G KVM - PROMO
SSD: 80 GB RAID-10
RAM: 4 GB
CPU: 4x Intel Xeon
Transfer: 3 TB/mo
Link speed: 1 Gigabit

月费是19.99$

先购买好主机，系统选择Debian ，开机后， SSH登录上去。

1. 部署准备首先需要确定使用方式，这决定了你用什么方式部署。

项目概览：README.md

运行载体：支持本地宿主机、虚拟机、云服务器等。

最佳配置方案：海外云 VPS + Telegram + 顶级模型（如 Claude 或 GPT）。

在动手前，请先阅读官方部署文档：Docker 部署文档

1.1 手动部署与项目下载在云服务器上执行以下命令下载项目并进行初始化：

git clone https://github.com/openclaw/openclaw.git
cd openclaw
./docker-setup.sh

运行脚本后，系统会在宿主机创建两个核心文件夹并挂载到 Docker 容器：

~/.openclaw — 配置目录：存储记忆、配置文件及第三方 API 密钥。 ~/openclaw/workspace — 工作空间目录：Agent 可直接访问及保存文件的目录。 1.2 配置引导 Docker 启动后会自动打开配置引导界面。

在初始界面选择 Skip for now 跳过。 Telegram 渠道准备：

- 在 Telegram 搜索 @userinfobot 获取自己的 用户 ID。
- 搜索 @BotFather 创建机器人，获取 Bot API Token。

在配置引导的 Telegram (Bot API) 处填入上述 Token。 Hooks 建议选择：session-memory。出现 Token 提示（如 24b38f4...）即表示配置完成。访问地址：http://公网IP:18789（建议后续使用域名访问，详见 5.2 节）。

2. 消息通知渠道配对在服务器上执行配对命令以激活渠道：

宿主机直接执行

openclaw pairing approve telegram YKEY9974

Docker 版执行

docker compose run --rm openclaw-cli pairing approve telegram YKEY9974

注意：配对码有效期为 1 小时。若过期，请在 Telegram 发送 /start 获取新码。

3. 模型选择建议

维度	任务类型	推荐模型
按任务复杂度	编程、金融、数据分析等复杂任务	Claude Opus 4.6, GPT 5.2 Pro
按任务复杂度	资料整理、P 图、日常写作	Kimi 2.5, GLM 5.0, MiniMax-M2.5
按使用频次	高频使用	推荐包月/包年套餐（如 GLM5）
按使用频次	低频使用	推荐企业级 API 按量付费（如 Atlas Cloud）

4. Skills & MCP Skills：推荐从 ClawHub 社区下载。

- 常用推荐：find-skills, Agent Browser, DevTools MCP, auto-updater, self-improving-agent。

MCP：若使用智谱模型，建议优先使用其专属 MCP 插件以获得最佳效果。

5. 常见问题排查 (FAQ)

5.1 权限问题 (EACCES permission denied) 现象：报错 Error: EACCES: permission denied。

原因：容器用户（uid=1000）无权写入 root 拥有的目录。

方案：执行 chown -R 1000:1000 "$HOME/.openclaw"，随后运行 docker compose run --rm openclaw-cli onboard 重新初始化。

5.2 安全环境要求 (HTTPS) 现象：报错 control ui requires HTTPS or localhost。

方案：配置反向代理（推荐使用 Caddy）开启 HTTPS，通过域名访问。

5.3 Docker 专用排查步骤

如果遇到设备配对失败（pairing required），请按以下步骤操作：

修复网络：在 docker-compose.yml 中为 openclaw-cli 设置 OPENCLAW_GATEWAY_URL: ws://openclaw-gateway:18789。绑定局域网：在 openclaw.json 中设置 "gateway": { "bind": "lan" }。同步 Token：确保 .env 中的 OPENCLAW_GATEWAY_TOKEN 与 openclaw.json 一致。手动批准设备：

docker compose exec openclaw-gateway node dist/index.js devices list
docker compose exec openclaw-gateway node dist/index.js devices approve <request-id>

6. 进阶技巧核心文件清单

位于 ~/.openclaw/workspace：

AGENTS.md：行为准则。

SOUL.md：性格与逻辑（可修改此文件去除“班味”）。

MEMORY.md：长期记忆。

常用命令行速查

功能	命令 (Docker 环境下)
重启网关	docker compose restart openclaw-gateway
进入配置界面	docker compose run --rm openclaw-cli onboard
启用 Slack 流	docker compose run --rm openclaw-cli config set "channels.slack.autoSlackBot.streamMode" "enabled"
查看设备	docker compose run --rm openclaw-cli devices list

1. 部署准备 首先需要确定使用方式，这决定了你用什么方式部署。

2. 消息通知渠道配对 在服务器上执行配对命令以激活渠道：