
整体思路
这套方案不限于 Oracle ,腾讯云、阿里云,只要是 Ubuntu 系统,步骤都一样。
动手之前,先把这三样东西准备好:
| 需要准备 | 去哪里拿 | 干什么用 |
|---|---|---|
| Telegram Bot Token | 在 Telegram 里找@BotFather,发送/newbot ,得到一串代码,如 123456:ABC-DEF... | 让你的机器人能收发消息 |
| Telegram User ID | 找@userinfobot,发任意消息,记下那串数字(如 553061740) | 只有这个 ID 能控制你的机器人,防止别人蹭用 |
| Moonshot API Key | 登录platform.moonshot.cn创建 | OpenClaw 的大脑,用来调用 Kimi 模型 |
2026 版的 OpenClaw 在容器内使用了一个普通用户(不是 root )来运行,这导致很多人遇到"Permission denied"错误。解决办法很简单:提前把文件夹权限给它。
创建目录并设置权限
# 创建数据目录 mkdir -p /opt/openclaw/data # 关键一步:把目录所有权给容器内的用户( ID 是 1000 ) chown -R 1000:1000 /opt/openclaw/data # 进入工作目录 cd /opt/openclaw 写配置文件
创建.env文件:
nano .env 填入:
TELEGRAM_BOT_TOKEN=你的 Telegram Bot Token ALLOWED_USER_IDS=你的 Telegram ID TELEGRAM_ENABLED=true OPENCLAW_GATEWAY_TOKEN=设置一个管理密码 写 Docker 启动文件
创建docker-compose.yml:
nano docker-compose.yml 填入:
services: openclaw: image: ghcr.io/openclaw/openclaw:latest container_name: openclaw restart: always env_file: .env volumes: # 注意:2026 版路径变了,从/app/data 改成/home/node/.openclaw - ./data:/home/node/.openclaw 特别提醒:很多旧教程写的路径是/app/data,这是老版本的。2026 版改成了/home/node/.openclaw,如果用错路径,配置会保存不上。
启动容器:
docker compose up -d 进入配置界面
2026 版参数比较多,手动改配置文件容易出错,建议用自带的交互式菜单:
docker exec -it openclaw node dist/index.js configure 按照菜单一步步来:
local模式。这样不需要开放公网端口,安全。Moonshot AI (Kimi 2.5)。Kimi API key (.cn)配对
打开你的 Telegram 机器人,给它任意消息,它会发来一个 8 位数字的配对码。在 VPS 里执行:
docker exec -it openclaw node dist/index.js pairing approve telegram 你的配对码 重启服务让配置生效:
docker compose restart 查看运行日志:
docker logs -f openclaw 当看到[telegram] ... starting provider这条日志时,说明 Telegram 连接成功了,你的 AI 助理已经上线。
完整版在公众号 Hacker Digest