OpenClaw 安装部署全流程：搭建自托管 AI 助手

🔧 详细配置

配置文件通常位于 ~/.openclaw/openclaw.json。基础配置示例如下：

{
  "gateway": {
    "port": 18789,
    "verbose": true
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "YOUR_BOT_TOKEN_HERE"
    },
    "discord": {
      "enabled": true,
      "botToken": "YOUR_DISCORD_BOT_TOKEN"
    }
  },
  "model": {
    "provider": "anthropic",
    "model": "claude-sonnet-4-20250514",
    "apiKey": "sk-ant-xxx..."
  }
}

🔐 安全提醒：建议优先使用环境变量存储敏感信息，避免直接将 Token 明文写入配置文件。

🔗 渠道配置详解

Telegram 配置

1. 创建 Bot：在 Telegram 搜索 @BotFather，发送 /newbot 命令，按提示命名并获取 Token。
2. 配置 OpenClaw：

openclaw config set channels.telegram.botToken "你的 Token"

3. 启动测试：

openclaw gateway

随后在 Telegram 中搜索 Bot 用户名，发送 /start 完成配对。

Discord 配置

1. 创建应用：访问 Discord 开发者中心，点击 New Application。
2. 创建 Bot：进入 Bot 页面添加机器人，复制 Token（需开启 Message Content Intent）。
3. 邀请 Bot：在 OAuth2 -> URL Generator 中勾选 bot 权限，生成链接并在浏览器打开选择目标服务器。

🚀 启动与验证

启动 Gateway 服务：

# 前台运行（查看日志）
openclaw gateway --verbose

# 后台运行
openclaw gateway &

验证状态：

openclaw health

同时可访问控制台界面：http://127.0.0.1:18789

架构流程

用户消息 → 聊天渠道 → Gateway → AI Model → 返回消息

🔍 常见问题汇总

Q1：启动报错 'Port 18789 already in use'

lsof -i :18789
# 或者更换端口
openclaw gateway --port 18790

Q2：Telegram Bot 发消息没反应

1. 检查 Bot Token 是否正确。
2. 确保已与 Bot 私聊过 /start。
3. 查看详细日志：openclaw gateway --verbose。

Q3：Discord 提示 'Missing Access'

1. 确认 Bot 权限是否足够。
2. 确保 Bot 已在服务器内。
3. 在 Developer Portal 检查 Intents 设置。

⚠️ 注意事项

1. 网络安全：公网部署时务必配置访问密码。
2. Token 消耗：AI 对话涉及 API Token 费用，请留意用量。
3. 隐私安全：避免在对话中输入敏感个人信息。
4. 及时更新：关注官方 Release 以获取安全补丁。

📚 参考资料

• 官方文档：https://docs.openclaw.ai
• GitHub 仓库：https://github.com/openclaw/openclaw
• 问题交流：https://discord.com/invite/clawd