查看“︁OpenCrow部署指南”︁的源代码


OpenCrow推荐使用2核4G的配置，可以购买'''BandwagonHost''' 的 '''VPS - Self-managed - 80G KVM - PROMO''' 型号的主机，配置如下：<syntaxhighlight lang="abap">
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
</syntaxhighlight>月费是19.99$

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

=== 1. 部署准备 首先需要确定使用方式，这决定了你用什么方式部署。 ===
项目概览：[https://github.com/openclaw/openclaw/blob/main/README.md README.md]

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

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

在动手前，请先阅读官方部署文档：[https://github.com/openclaw/openclaw/blob/main/docs/install/docker.md Docker 部署文档]

1.1 手动部署与项目下载
在云服务器上执行以下命令下载项目并进行初始化：
<syntaxhighlight lang="bash">
git clone https://github.com/openclaw/openclaw.git
cd openclaw
./docker-setup.sh
</syntaxhighlight>

运行脚本后，系统会在宿主机创建两个核心文件夹并挂载到 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. 消息通知渠道配对 在服务器上执行配对命令以激活渠道： ===
; 宿主机直接执行
: <syntaxhighlight lang="bash">openclaw pairing approve telegram YKEY9974</syntaxhighlight>
; Docker 版执行
: <syntaxhighlight lang="bash">docker compose run --rm openclaw-cli pairing approve telegram YKEY9974</syntaxhighlight>

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

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

=== 4. Skills & MCP Skills：推荐从 [https://clawhub.com 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 一致。
手动批准设备：
<syntaxhighlight lang="bash">
docker compose exec openclaw-gateway node dist/index.js devices list
docker compose exec openclaw-gateway node dist/index.js devices approve <request-id>
</syntaxhighlight>

=== 6. 进阶技巧 核心文件清单 ===
位于 ~/.openclaw/workspace：

'''AGENTS.md'''：行为准则。

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

'''MEMORY.md'''：长期记忆。

常用命令行速查
{| class="wikitable"
! 功能 !! 命令 (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
|}
[[Category:500 常见应用指南 — Application Guides]]