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. 消息通知渠道配對 在服務器上執行配對命令以激活渠道：