OpenClaw 企业级部署指南：多用户管理、权限控制与生产环境最佳实践

// ~/.openclaw/openclaw.json
{
  "channels": {
    "telegram": {
      "allowFrom": [
        "123456789",    // 用户 ID（数字）
        "987654321",
        "555000111"
      ],
      // 或按用户名
      "allowFromUsernames": ["alice", "bob", "charlie"]
    }
  }
}

{
  "channels": {
    "discord": {
      "allowedGuilds": ["服务器ID"],
      "allowedRoles": ["工程师角色ID", "管理员角色ID"],
      "allowedChannels": ["#ai-assistant频道ID"],
      "mentionRequired": true,    // 必须 @Bot 才响应
      "threadMode": true          // 每次对话开独立 Thread
    }
  }
}

{
  "channels": {
    "slack": {
      "allowedWorkspaces": ["工作区ID"],
      "allowedUsers": ["U01234", "U05678"],  // Slack 用户 ID
      "mentionRequired": true,
      "allowedChannels": ["C#engineering", "C#product"]
    }
  }
}

# Ubuntu 22.04 VPS 上部署
curl -fsSL https://openclaw.ai/install.sh | bash

# 安装为 systemd 服务（开机自启）
openclaw gateway install
systemctl --user enable openclaw-gateway
systemctl --user start openclaw-gateway

# 验证
openclaw gateway status

# openclaw-deployment.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: openclaw-gateway
spec:
  replicas: 2
  selector:
    matchLabels:
      app: openclaw
  template:
    spec:
      containers:
      - name: openclaw
        image: ghcr.io/openclaw/openclaw:latest
        env:
        - name: ANTHROPIC_API_KEY
          valueFrom:
            secretKeyRef:
              name: ai-secrets
              key: anthropic-key
        - name: OPENCLAW_CONFIG_PATH
          value: /config/openclaw.json
        volumeMounts:
        - name: config
          mountPath: /config
        - name: workspace
          mountPath: /workspace
      volumes:
      - name: config
        configMap:
          name: openclaw-config
      - name: workspace
        persistentVolumeClaim:
          claimName: openclaw-workspace-pvc

# 安装 Fly CLI
brew install flyctl

# 部署（首次）
fly launch --image ghcr.io/openclaw/openclaw:latest

# 设置密钥
fly secrets set ANTHROPIC_API_KEY=sk-ant-xxx
fly secrets set TELEGRAM_BOT_TOKEN=xxx

# 挂载持久存储（工作区文件）
fly volumes create openclaw_data --size 10

# 部署
fly deploy

# 服务器上安装 Tailscale
curl -fsSL https://tailscale.com/install.sh | sh
tailscale up

# 获取 Tailscale IP（例如：100.x.x.x）
tailscale ip -4

# OpenClaw Dashboard 只监听 Tailscale 接口
openclaw configure --gateway-host 100.x.x.x

{
  "logging": {
    "level": "info",
    "auditLog": {
      "enabled": true,
      "path": "~/.openclaw/logs/audit.log",
      "includeContent": false,    // 不记录消息内容（隐私保护）
      "includeMetadata": true     // 记录：时间、用户、频道、Token 用量
    }
  }
}

{
  "timestamp": "2026-03-17T09:00:00Z",
  "user": "alice",
  "channel": "telegram",
  "sessionKey": "telegram:alice:xxx",
  "inputTokens": 245,
  "outputTokens": 512,
  "model": "claude-sonnet-4-5",
  "duration_ms": 3420
}

# SOUL.md（企业版示例）

## 角色
你是「TechBot」，我们工程团队的 AI 助手。

## 行为规范
- 使用专业但友好的语气
- 技术问题提供代码示例
- 不确定时说「我不确定，建议查看官方文档」
- 涉及安全敏感信息，提醒不要在聊天中分享密钥

## 知识库
公司技术文档在 docs/ 目录，查询问题时优先参考。
内部 API 规范：参见 INTERNAL-API.md

## 禁止行为
- 不得执行生产数据库的写入操作
- 不得分享任何 API Key 或密码信息
- 不得向外部发送内部文档内容