1
2
3
4
5
6
7
8
9

# 文件路径: 终端命令
# 来源: https://docs.clawd.bot/install/
# 版本: v1.0.0+

# macOS/Linux 安装
curl -fsSL https://clawd.bot/install.sh | bash

# Windows 安装 (PowerShell)
iwr -useb https://clawd.bot/install.ps1 | iex

1

clawdbot --version

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

# 文件路径: 终端命令
# 来源: https://docs.clawd.bot/install/
# 版本: v1.0.0+

# 全局安装
npm install -g clawdbot@latest

# 或者使用 pnpm
pnpm add -g clawdbot@latest

# 验证安装
which clawdbot

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

# 文件路径: 终端命令
# 来源: https://toclawdbot.com/macos
# 版本: v1.0.0+

# 使用 Homebrew 安装
brew install clawdbot/tap/clawdbot

# 或者下载 DMG 文件
# 从 https://clawd.bot 下载最新版 macOS DMG
# 拖拽 Clawdbot.app 到 Applications 文件夹

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

# 文件路径: docker-compose.yml
# 来源: https://docs.clawd.bot/install/docker
# 版本: v1.0.0+

version: '3.8'
services:
  clawdbot:
    image: clawdbot/clawdbot:latest
    container_name: clawdbot
    ports:
      - "3000:3000"
    environment:
      - NODE_ENV=production
      - CLAWD_CONFIG_PATH=/app/config
    volumes:
      - ./config:/app/config
      - ./data:/app/data
    restart: unless-stopped
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:3000/health"]
      interval: 30s
      timeout: 10s
      retries: 3

1

docker-compose up -d

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

# 文件路径: 终端命令
# 来源: https://docs.clawd.bot/wizard
# 版本: v1.0.0+

# 启动设置向导（初始化配置）
clawdbot setup

# 运行交互式设置向导
clawdbot onboard

# 配置凭据和设备
clawdbot configure

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

// 文件路径: ~/.config/clawdbot/config.json
// 来源: https://github.com/clawdbot/clawdbot/blob/main/docs/configuration.md
// 版本: v1.0.0+

{
  "server": {
    "port": 3000,
    "host": "localhost",
    "protocol": "http"
  },
  "ai": {
    "provider": "anthropic",
    "model": "claude-3-5-sonnet-20241022",
    "apiKey": "YOUR_ANTHROPIC_API_KEY",
    "maxTokens": 4096,
    "temperature": 0.7
  },
  "memory": {
    "enabled": true,
    "storage": "file",
    "path": "./data/memory.json",
    "maxEntries": 1000
  },
  "channels": {
    "whatsapp": {
      "enabled": true,
      "sessionPath": "./sessions/whatsapp"
    },
    "telegram": {
      "enabled": true,
      "botToken": "YOUR_TELEGRAM_BOT_TOKEN"
    },
    "discord": {
      "enabled": true,
      "botToken": "YOUR_DISCORD_BOT_TOKEN"
    }
  },
  "skills": {
    "enabled": true,
    "directory": "./skills",
    "autoLoad": true
  }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

# 文件路径: 终端命令
# 来源: clawdbot --help
# 版本: v2026.1.24-3

# 开发模式（隔离状态，使用端口 19001）
clawdbot --dev gateway

# 使用命名配置文件
clawdbot --profile testing setup

# 禁用颜色输出（用于脚本）
clawdbot --no-color status

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21

# 文件路径: ~/.config/clawdbot/.env
# 来源: https://github.com/clawdbot/clawdbot/blob/main/docs/configuration.md
# 版本: v1.0.0+

# AI 模型配置
ANTHROPIC_API_KEY=your_anthropic_key_here
OPENAI_API_KEY=your_openai_key_here
GOOGLE_API_KEY=your_google_key_here

# 数据库配置
DATABASE_URL=file:./data/clawdbot.db
REDIS_URL=redis://localhost:6379

# 安全配置
JWT_SECRET=your_jwt_secret_here
ENCRYPTION_KEY=your_encryption_key_here

# 消息平台配置
TELEGRAM_BOT_TOKEN=your_telegram_token
DISCORD_BOT_TOKEN=your_discord_token
WHATSAPP_SESSION_PATH=./sessions/whatsapp

1
2
3
4
5
6
7
8
9

# 文件路径: 终端命令
# 来源: https://docs.clawd.bot/start/pairing
# 版本: v1.0.0+

# 启动 WhatsApp 配对模式
clawdbot pair whatsapp

# 或者使用完整命令
clawdbot channels add whatsapp --method=qr

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22

// 文件路径: ~/.config/clawdbot/channels/whatsapp.json
// 来源: https://clawd.bot/integrations
// 版本: v1.0.0+

{
  "platform": "whatsapp",
  "enabled": true,
  "config": {
    "sessionId": "my-whatsapp-session",
    "qrMaxRetries": 3,
    "authTimeoutMs": 60000,
    "keepAliveIntervalMs": 30000,
    "markOnlineOnConnect": true,
    "fireInitQueries": true
  },
  "features": {
    "readReceipts": true,
    "typingIndicator": true,
    "autoReply": true,
    "groupMessages": true
  }
}

1
2
3
4
5
6
7
8
9

# 文件路径: 终端命令
# 来源: https://docs.clawd.bot/start/pairing
# 版本: v1.0.0+

# 1. 在 Telegram 中搜索 @BotFather
# 2. 发送 /newbot 命令
# 3. 获取 Bot Token
# 4. 配置 Clawdbot
clawdbot channels add telegram --token=YOUR_BOT_TOKEN

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

// 文件路径: ~/.config/clawdbot/channels/telegram.json
// 来源: https://clawd.bot/integrations
// 版本: v1.0.0+

{
  "platform": "telegram",
  "enabled": true,
  "token": "YOUR_TELEGRAM_BOT_TOKEN",
  "webhook": {
    "enabled": true,
    "port": 8443,
    "host": "your-domain.com"
  },
  "features": {
    "inlineQueries": true,
    "commands": true,
    "inlineKeyboard": true,
    "groupMessages": true
  },
  "commands": [
    {
      "command": "start",
      "description": "Start the bot"
    },
    {
      "command": "help",
      "description": "Show help information"
    },
    {
      "command": "status",
      "description": "Check bot status"
    }
  ]
}

1
2
3
4
5
6
7
8
9

# 文件路径: 终端命令
# 来源: https://docs.clawd.bot/start/pairing
# 版本: v1.0.0+

# 1. 访问 https://discord.com/developers/applications
# 2. 创建新应用
# 3. 获取 Bot Token
# 4. 配置权限
clawdbot channels add discord --token=YOUR_DISCORD_BOT_TOKEN

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

// 文件路径: ~/.config/clawdbot/channels/discord.json
// 来源: https://clawd.bot/integrations
// 版本: v1.0.0+

{
  "platform": "discord",
  "enabled": true,
  "token": "YOUR_DISCORD_BOT_TOKEN",
  "intents": [
    "GUILDS",
    "GUILD_MESSAGES",
    "DIRECT_MESSAGES",
    "MESSAGE_CONTENT"
  ],
  "prefix": "!",
  "features": {
    "slashCommands": true,
    "embeds": true,
    "reactions": true,
    "voiceChannels": false
  },
  "allowedChannels": ["general", "ai-chat"],
  "allowedRoles": ["@everyone", "AI Users"]
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

# 文件路径: 终端命令
# 来源: clawdbot --help (官方 CLI 输出)
# 版本: v2026.1.24-3

# 初始化配置
clawdbot setup

# 交互式设置向导
clawdbot onboard

# 配置凭据和设备
clawdbot configure

# 健康检查和修复
clawdbot doctor

# 打开控制面板
clawdbot dashboard

1

clawdbot --version

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

# 启动网关服务
clawdbot gateway

# 开发模式启动（隔离状态）
clawdbot --dev gateway

# 指定端口启动
clawdbot gateway --port 18789

# 强制启动（杀掉占用端口的进程）
clawdbot gateway --force

# 检查网关健康状态
clawdbot health

# 查看网关日志
clawdbot logs

1

clawdbot health

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

# 连接消息平台（交互式）
clawdbot channels login --verbose

# 添加 WhatsApp（二维码方式）
clawdbot channels add whatsapp --method=qr

# 添加 Telegram 机器人
clawdbot channels add telegram --token=YOUR_BOT_TOKEN

# 添加 Discord 机器人
clawdbot channels add discord --token=YOUR_DISCORD_BOT_TOKEN

# 查看通道状态
clawdbot status

1

clawdbot status

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

# 运行代理对话
clawdbot agent --to +1234567890 --message "Hello" --deliver

# 管理多个代理
clawdbot agents list
clawdbot agents create --name "assistant"
clawdbot agents switch --name "assistant"

# 技能管理
clawdbot skills list
clawdbot skills install <skill-name>
clawdbot skills remove <skill-name>

# 记忆搜索
clawdbot memory search "project discussion"
clawdbot memory cleanup

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

# 发送 WhatsApp 消息
clawdbot message send --target +1234567890 --message "Hi there!"

# 发送 Telegram 消息
clawdbot message send --channel telegram --target @username --message "Hello"

# 发送 Discord 消息
clawdbot message send --channel discord --target channel-id --message "Test message"

# JSON 格式输出
clawdbot message send --target +1234567890 --message "Hi" --json

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

# 浏览器管理
clawdbot browser start
clawdbot browser stop
clawdbot browser screenshot

# 定时任务
clawdbot cron list
clawdbot cron add --schedule "0 9 * * *" --command "morning-briefing"

# 模型配置
clawdbot models list
clawdbot models set --provider anthropic --model claude-3-5-sonnet

# 系统信息
clawdbot system info
clawdbot system events

1
2
3
4
5
6
7
8
9

# 开发模式（隔离状态，端口 19001）
clawdbot --dev gateway

# 使用命名配置文件
clawdbot --profile work setup
clawdbot --profile personal gateway

# 禁用颜色输出
clawdbot --no-color status

1
2

# 检查开发网关
clawdbot --dev health

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

# 文件路径: 终端命令
# 来源: https://docs.clawd.bot/cli/
# 版本: v1.0.0+

# 启动 Clawdbot 网关服务
clawdbot gateway

# 开发模式启动（推荐用于测试）
clawdbot --dev gateway

# 检查服务健康状态
clawdbot health

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

# 文件路径: 终端命令
# 来源: https://docs.clawd.bot/cli/message
# 版本: v1.0.0+

# 发送测试消息到 WhatsApp
clawdbot message whatsapp --to="+1234567890" --text="Hello from Clawdbot!"

# 发送消息到 Telegram
clawdbot message telegram --to="@username" --text="Hello from Clawdbot!"

# 发送消息到 Discord
clawdbot message discord --to="channel-id" --text="Hello from Clawdbot!"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42

// 文件路径: skills/browser-automation.js
// 来源: https://github.com/clawdbot/clawdbot/blob/main/AGENTS.md
// 版本: v1.0.0+

const { Skill } = require('clawdbot-sdk');

class BrowserAutomation extends Skill {
  constructor() {
    super({
      name: 'browser-automation',
      description: 'Automate browser tasks',
      version: '1.0.0'
    });
  }

  async execute(context, args) {
    const { action, url, selector, text } = args;
    
    switch (action) {
      case 'navigate':
        await this.browser.goto(url);
        return { success: true, message: `Navigated to ${url}` };
        
      case 'click':
        await this.browser.click(selector);
        return { success: true, message: `Clicked ${selector}` };
        
      case 'type':
        await this.browser.type(selector, text);
        return { success: true, message: `Typed into ${selector}` };
        
      case 'screenshot':
        const screenshot = await this.browser.screenshot();
        return { success: true, screenshot };
        
      default:
        return { success: false, error: 'Unknown action' };
    }
  }
}

module.exports = BrowserAutomation;

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

// 文件路径: ~/.config/clawdbot/models.json
// 来源: https://github.com/clawdbot/clawdbot/blob/main/docs/configuration.md
// 版本: v1.0.0+

{
  "models": {
    "primary": {
      "provider": "anthropic",
      "model": "claude-3-5-sonnet-20241022",
      "apiKey": "${ANTHROPIC_API_KEY}",
      "maxTokens": 4096,
      "temperature": 0.7
    },
    "fallback": {
      "provider": "openai",
      "model": "gpt-4",
      "apiKey": "${OPENAI_API_KEY}",
      "maxTokens": 4096,
      "temperature": 0.5
    },
    "fast": {
      "provider": "anthropic",
      "model": "claude-3-haiku-20240307",
      "apiKey": "${ANTHROPIC_API_KEY}",
      "maxTokens": 2048,
      "temperature": 0.3
    }
  },
  "routing": {
    "default": "primary",
    "fallback": "fallback",
    "quick": "fast"
  }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43

// 文件路径: ~/.config/clawdbot/skills.json
// 来源: https://github.com/clawdbot/clawdbot/blob/main/AGENTS.md
// 版本: v1.0.0+

{
  "skills": {
    "enabled": true,
    "autoLoad": true,
    "directory": "./skills",
    "permissions": {
      "fileSystem": "ask",
      "network": "allow",
      "browser": "allow",
      "system": "deny"
    },
    "installed": [
      {
        "name": "calendar",
        "enabled": true,
        "config": {
          "provider": "google",
          "syncInterval": 300
        }
      },
      {
        "name": "email",
        "enabled": true,
        "config": {
          "provider": "gmail",
          "checkInterval": 60
        }
      },
      {
        "name": "reminder",
        "enabled": true,
        "config": {
          "storage": "memory",
          "timezone": "UTC"
        }
      }
    ]
  }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26

// 文件路径: ~/.config/clawdbot/memory.json
// 来源: https://github.com/clawdbot/clawdbot/blob/main/docs/configuration.md
// 版本: v1.0.0+

{
  "memory": {
    "enabled": true,
    "provider": "sqlite",
    "config": {
      "database": "./data/memory.db",
      "table": "conversations",
      "maxEntries": 10000,
      "retentionDays": 30
    },
    "embedding": {
      "provider": "openai",
      "model": "text-embedding-3-small",
      "dimensions": 1536
    },
    "search": {
      "enabled": true,
      "threshold": 0.7,
      "maxResults": 5
    }
  }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

# 文件路径: 终端命令
# 来源: https://docs.clawd.bot/cli/doctor
# 版本: v1.0.0+

# 运行健康检查
clawdbot doctor

# 查看系统状态
clawdbot system

# 检查日志
clawdbot logs

# 重启服务
clawdbot restart

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44

# 文件路径: 故障排除脚本
# 来源: https://docs.clawd.bot/troubleshooting
# 版本: v1.0.0+

#!/bin/bash
# Clawdbot 故障排除脚本

echo "🔍 Clawdbot 诊断检查"
echo "========================"

# 检查 Node.js 版本
node_version=$(node --version)
echo "Node.js 版本: $node_version"

# 检查 Clawdbot 安装
if command -v clawdbot &> /dev/null; then
    echo "✅ Clawdbot 已安装"
    clawdbot --version
else
    echo "❌ Clawdbot 未安装"
fi

# 检查端口占用
if netstat -tuln | grep -q ":3000"; then
    echo "✅ 端口 3000 正在使用"
else
    echo "⚠️ 端口 3000 未使用"
fi

# 检查配置文件
if [ -f ~/.config/clawdbot/config.json ]; then
    echo "✅ 配置文件存在"
else
    echo "❌ 配置文件不存在"
fi

# 检查数据目录
if [ -d ~/.local/share/clawdbot ]; then
    echo "✅ 数据目录存在"
else
    echo "⚠️ 数据目录不存在"
fi

echo "诊断完成！"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28

// 文件路径: ~/.config/clawdbot/security.json
// 来源: 安全配置最佳实践
// 版本: v1.0.0+

{
  "security": {
    "encryption": {
      "enabled": true,
      "algorithm": "aes-256-gcm",
      "keyRotation": 86400
    },
    "authentication": {
      "jwt": {
        "secret": "${JWT_SECRET}",
        "expiresIn": "24h"
      },
      "apiKey": {
        "enabled": true,
        "rateLimit": 100
      }
    },
    "permissions": {
      "adminUsers": ["admin@example.com"],
      "allowedIPs": ["127.0.0.1", "::1"],
      "blockedCommands": ["rm -rf", "sudo", "su"]
    }
  }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

# 文件路径: 性能优化脚本
# 来源: 性能优化最佳实践
# 版本: v1.0.0+

#!/bin/bash
# Clawdbot 性能优化

echo "🚀 Clawdbot 性能优化"
echo "====================="

# 清理内存
clawdbot memory cleanup

# 优化数据库
clawdbot db optimize

# 清理日志
clawdbot logs clean --keep-days=7

# 重启服务以释放资源
clawdbot restart

echo "优化完成！"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65

// 文件路径: skills/monitoring.js
// 来源: 监控最佳实践
// 版本: v1.0.0+

const { Skill } = require('clawdbot-sdk');

class MonitoringSkill extends Skill {
  constructor() {
    super({
      name: 'monitoring',
      description: 'System monitoring and alerting',
      version: '1.0.0'
    });
  }

  async execute(context, args) {
    const { action } = args;
    
    switch (action) {
      case 'status':
        return await this.getSystemStatus();
      case 'health':
        return await this.checkHealth();
      case 'metrics':
        return await this.getMetrics();
      default:
        return { error: 'Unknown action' };
    }
  }

  async getSystemStatus() {
    const status = {
      uptime: process.uptime(),
      memory: process.memoryUsage(),
      cpu: process.cpuUsage(),
      timestamp: new Date().toISOString()
    };
    
    return { success: true, status };
  }

  async checkHealth() {
    const health = {
      gateway: await this.checkGateway(),
      database: await this.checkDatabase(),
      channels: await this.checkChannels(),
      ai: await this.checkAI()
    };
    
    return { success: true, health };
  }

  async getMetrics() {
    const metrics = {
      messages: await this.getMessageCount(),
      conversations: await this.getConversationCount(),
      skills: await this.getSkillCount(),
      uptime: process.uptime()
    };
    
    return { success: true, metrics };
  }
}

module.exports = MonitoringSkill;

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

---
<!-- 文件路径: use-cases/personal-assistant.md -->
<!-- 来源: 实际应用案例 -->
<!-- 版本: v1.0.0+ -->

# 个人助理配置示例

**日程管理**:
- 自动读取日历事件
- 发送提醒通知
- 安排会议时间

**邮件处理**:
- 自动分类邮件
- 生成回复草稿
- 标记重要邮件

**任务管理**:
- 创建待办事项
- 设置提醒
- 跟踪进度

**信息查询**:
- 天气信息
- 新闻摘要
- 股票行情

**自动化操作**:
- 文件整理
- 数据备份
- 系统维护

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37

// 文件路径: team-config.json
// 来源: 团队协作实践
// 版本: v1.0.0+

{
  "team": {
    "name": "Development Team",
    "channels": {
      "general": {
        "platform": "slack",
        "purpose": "General discussions"
      },
      "dev-updates": {
        "platform": "discord",
        "purpose": "Development updates"
      },
      "incidents": {
        "platform": "telegram",
        "purpose": "Incident management"
      }
    },
    "skills": {
      "deployment": {
        "enabled": true,
        "channels": ["dev-updates"]
      },
      "monitoring": {
        "enabled": true,
        "channels": ["incidents"]
      },
      "documentation": {
        "enabled": true,
        "channels": ["general"]
      }
    }
  }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

// 文件路径: .opencode.jsonc
// 来源: https://opencode.ai/docs/modes/
// 版本: v1.0.0+

{
  "$schema": "https://opencode.ai/config.json",
  "theme": "opencode",
  "agent": {
    "build": {
      "tools": ["*"],
      "model": "anthropic/claude-sonnet-4-5"
    },
    "plan": {
      "tools": ["read", "glob", "grep", "lsp_*"],
      "permissions": {
        "write": "deny",
        "edit": "deny",
        "bash": "deny"
      },
      "model": "anthropic/claude-haiku-4-5"
    }
  }
}

1
2
3
4
5
6

# 安装 oh-my-opencode
# 来源: https://www.npmjs.com/package/oh-my-opencode
npm install -g oh-my-opencode

# 验证安装
oh-my-opencode --version

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

// 文件路径: .opencode/agents.json
// 来源: https://github.com/code-yeongyu/oh-my-opencode
// 版本: v2.14.0+

{
  "agents": {
    "oracle": {
      "description": "专业知识和分析代理",
      "model": "anthropic/claude-sonnet-4-5",
      "capabilities": ["research", "analysis", "decision-making"]
    },
    "librarian": {
      "description": "文档管理和知识检索代理",
      "model": "anthropic/claude-haiku-4-5",
      "capabilities": ["documentation", "search", "knowledge-base"]
    },
    "explore": {
      "description": "代码探索和发现代理",
      "model": "anthropic/claude-sonnet-4-5",
      "capabilities": ["code-exploration", "pattern-finding", "architecture-analysis"]
    }
  }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

---
<!-- 文件路径: .opencode/commands/security-scan.md -->
<!-- 来源: https://opencode.ai/docs/commands/ -->
<!-- 版本: v1.0.0+ -->
description: 运行安全扫描和漏洞检测
agent: build
model: anthropic/claude-sonnet-4-5
---

执行全面的安全扫描，包括：
1. 依赖漏洞检查（npm audit）
2. 代码静态分析（eslint + 安全规则）
3. 敏感信息检测（git secrets）
4. 容器安全扫描（如果有 Dockerfile）

生成详细的报告并提供修复建议。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

---
<!-- 文件路径: .opencode/commands/deploy.md -->
<!-- 来源: https://opencode.ai/docs/commands/ -->
<!-- 版本: v1.0.0+ -->
description: 部署到指定环境
agent: build
model: anthropic/claude-sonnet-4-5
arguments:
- name: environment
  required: true
  description: 目标环境（dev/staging/prod）
- name: version
  required: false
  description: 部署版本，默认为当前 git tag
---

部署应用到 {{environment}} 环境

步骤：
1. 检查当前环境状态
2. 创建备份（如环境为 prod）
3. 读取配置文件 config/{{environment}}.yaml
4. 执行部署脚本
5. 验证部署结果
6. 如果失败，回滚到上一版本

{{#if version}}
指定版本：{{version}}
{{else}}
使用最新版本
{{/if}}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

---
<!-- 文件路径: .opencode/commands/release-workflow.md -->
<!-- 来源: https://opencode.ai/docs/commands/ -->
<!-- 版本: v1.0.0+ -->
description: 完整的发布工作流
agent: build
model: anthropic/claude-sonnet-4-5
---

执行完整的发布流程：

1. **代码质量检查**
   - 运行测试套件
   - 代码覆盖率检查
   - Linting 检查

2. **版本管理**
   - 更新版本号
   - 创建 git tag
   - 生成 changelog

3. **构建和打包**
   - 构建生产版本
   - 创建 Docker 镜像
   - 推送到镜像仓库

4. **部署**
   - 部署到 staging
   - 运行集成测试
   - 获取部署确认

5. **通知**
   - 发送部署通知
   - 更新项目文档
   - 发布 release notes

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47

# 文件路径: .github/workflows/opencode-ci.yml
# 来源: https://github.com/anomalyco/opencode/actions/workflows/deploy.yml
# 版本: v1.0.0+

name: OpenCode CI/CD Pipeline

on:
  push:
    branches: [main, develop]
  pull_request:
    branches: [main]

jobs:
  opencode-review:
    runs-on: ubuntu-latest
    steps:
    - uses: actions/checkout@v4
    
    - name: Setup Node.js
      uses: actions/setup-node@v4
      with:
        node-version: '20'
        
    - name: Install OpenCode
      run: |
        curl -fsSL https://opencode.ai/install | bash
                
    - name: Configure OpenCode
      run: |
        mkdir -p ~/.local/share/opencode
        echo '${{ secrets.OPENCODE_CONFIG }}' > ~/.local/share/opencode/config.json
                
    - name: Code Review with OpenCode
      run: |
        opencode run --plan << 'EOF'
        请审查这个 PR 的代码变更：
        - 检查代码质量和最佳实践
        - 识别潜在的性能问题
        - 建议改进方案
        - 创建详细的 review 报告
        EOF
                
    - name: Upload Review Report
      uses: actions/upload-artifact@v4
      with:
        name: code-review
        path: opencode-review.md

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31

# 文件路径: azure-pipelines.yml
# 来源: https://github.com/sst/opencode/issues/3885
# 版本: v1.0.0+

trigger:
- main

pool:
  vmImage: 'ubuntu-latest'

steps:
- task: NodeTool@0
  inputs:
    versionSpec: '20.x'
  displayName: 'Install Node.js'
  
- script: |
    curl -fsSL https://opencode.ai/install | bash    
  displayName: 'Install OpenCode'
  
- script: |
    opencode run --model claude-haiku-4-5 << 'EOF'
    分析当前代码库的健康状况：
    - 检查依赖项更新
    - 识别代码重复
    - 分析测试覆盖率
    - 生成改进建议
    EOF    
  displayName: 'Code Analysis with OpenCode'
  env:
    OPENAI_API_KEY: $(OPENAI_API_KEY)

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125

// 文件路径: mcp-tools/custom-tool.ts
// 来源: https://opencode.ai/docs/mcp-servers/
// 版本: v1.0.0+

import { Server } from '@modelcontextprotocol/sdk/server/index.js';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
import {
  CallToolRequestSchema,
  ErrorCode,
  ListToolsRequestSchema,
  McpError,
} from '@modelcontextprotocol/sdk/types.js';

const server = new Server(
  {
    name: 'custom-project-tools',
    version: '1.0.0',
  },
  {
    capabilities: {
      tools: {},
    },
  }
);

// 注册自定义工具
server.setRequestHandler(ListToolsRequestSchema, async () => {
  return {
    tools: [
      {
        name: 'analyze_dependencies',
        description: '分析项目依赖项并提供优化建议',
        inputSchema: {
          type: 'object',
          properties: {
            path: {
              type: 'string',
              description: '项目路径',
            },
          },
          required: ['path'],
        },
      },
      {
        name: 'generate_api_docs',
        description: '基于代码注释生成 API 文档',
        inputSchema: {
          type: 'object',
          properties: {
            sourcePath: {
              type: 'string',
              description: '源代码路径',
            },
            outputPath: {
              type: 'string',
              description: '文档输出路径',
            },
          },
          required: ['sourcePath'],
        },
      },
    ],
  };
});

server.setRequestHandler(CallToolRequestSchema, async (request) => {
  const { name, arguments: args } = request.params;

  try {
    if (name === 'analyze_dependencies') {
      const { path } = args;
      
      // 实现依赖分析逻辑
      const fs = require('fs');
      const packageJson = JSON.parse(fs.readFileSync(`${path}/package.json`, 'utf8'));
      
      const analysis = {
        dependencies: Object.keys(packageJson.dependencies || {}),
        devDependencies: Object.keys(packageJson.devDependencies || {}),
        outdated: [],
        vulnerabilities: [],
      };

      return {
        content: [
          {
            type: 'text',
            text: JSON.stringify(analysis, null, 2),
          },
        ],
      };
    }

    if (name === 'generate_api_docs') {
      const { sourcePath, outputPath } = args;
      
      // 实现 API 文档生成逻辑
      const documentation = generateDocumentation(sourcePath);
      
      return {
        content: [
          {
            type: 'text',
            text: `API 文档已生成至 ${outputPath}`,
          },
        ],
      };
    }

    throw new McpError(ErrorCode.MethodNotFound, `Unknown tool: ${name}`);
  } catch (error) {
    throw new McpError(ErrorCode.InternalError, `Tool execution failed: ${error.message}`);
  }
});

async function main() {
  const transport = new StdioServerTransport();
  await server.connect(transport);
  console.error('Custom MCP server running on stdio');
}

main().catch((error) => {
  console.error('Server error:', error);
  process.exit(1);
});

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

// 文件路径: .opencode.jsonc
// 来源: https://opencode.ai/docs/mcp-servers/
// 版本: v1.0.0+

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "custom-tools": {
      "command": "node",
      "args": ["mcp-tools/custom-tool.js"],
      "enabled": true
    },
    "filesystem": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-filesystem", "/tmp"],
      "enabled": true
    },
    "git": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-git", "--repository", "."],
      "enabled": true
    }
  }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19

// 文件路径: .opencode.jsonc
// 来源: https://www.truefoundry.com/blog/opencode-token-usage
// 版本: v1.0.0+

{
  "$schema": "https://opencode.ai/config.json",
  "contextManagement": {
    "maxTokens": 32000,
    "compressionThreshold": 20000,
    "pruneOldContext": true,
    "keepSystemMessages": true
  },
  "model": "anthropic/claude-haiku-4-5",
  "fallbackModel": "anthropic/claude-sonnet-4-5",
  "tools": {
    "maxConcurrent": 3,
    "timeout": 30000
  }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

---
<!-- 文件路径: .opencode/commands/context-cleanup.md -->
<!-- 来源: https://www.truefoundry.com/blog/opencode-token-usage -->
<!-- 版本: v1.0.0+ -->
description: 智能上下文清理和优化
agent: build
model: anthropic/claude-haiku-4-5
---

执行上下文优化：

1. **压缩对话历史**
   - 保留关键决策点
   - 删除重复的代码片段
   - 合并相关的工具调用

2. **识别重要上下文**
   - 当前文件和依赖
   - 活跃的任务状态
   - 错误和警告信息

3. **清理策略**
   - 移除超过 10 步的工具输出
   - 压缩长代码块为摘要
   - 保留最近的 5-7 次交互

4. **生成上下文摘要**
   - 当前任务进度
   - 已解决的问题
   - 下一步行动计划

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22

// 文件路径: .opencode.jsonc
// 来源: 优化经验总结
// 版本: v1.0.0+

{
  "$schema": "https://opencode.ai/config.json",
  "caching": {
    "enableCache": true,
    "cacheDirectory": ".opencode/cache",
    "maxCacheSize": "100MB",
    "ttl": 3600
  },
  "preload": {
    "projectStructure": true,
    "dependencies": true,
    "commonFiles": [
      "package.json",
      "README.md",
      ".gitignore"
    ]
  }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34

---
<!-- 文件路径: .opencode/commands/financial-code-review.md -->
<!-- 来源: 生产环境实践案例 -->
<!-- 版本: v1.0.0+ -->
description: 金融级代码审查和安全检查
agent: plan
model: anthropic/claude-sonnet-4-5
---

执行金融级代码审查：

**安全检查清单：**
1. 输入验证和过滤
2. SQL 注入防护
3. XSS 攻击防护
4. 敏感数据处理
5. 认证和授权机制

**性能优化检查：**
1. 数据库查询优化
2. 缓存策略
3. 并发处理
4. 内存泄漏检测

**合规性检查：**
1. 数据隐私保护
2. 审计日志
3. 错误处理
4. 文档完整性

生成详细的审查报告，包括：
- 发现的问题和风险等级
- 修复建议和最佳实践
- 代码质量评分

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

---
<!-- 文件路径: .opencode/commands/microservice-refactor.md -->
<!-- 来源: 生产环境实践案例 -->
<!-- 版本: v1.0.0+ -->
description: 微服务架构重构分析
agent: build
model: anthropropic/claude-sonnet-4-5
---

分析单体应用并规划微服务拆分：

**分析步骤：**
1. **依赖关系分析**
   - 模块间耦合度
   - 数据流分析
   - 接口依赖图

2. **服务边界识别**
   - 业务领域划分
   - 数据一致性边界
   - 团队组织结构

3. **拆分策略制定**
   - 渐进式拆分路径
   - 数据迁移计划
   - 服务间通信方案

4. **技术架构设计**
   - API 网关设计
   - 服务发现机制
   - 分布式配置管理

输出完整的重构方案和实施计划。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

---
<!-- 文件路径: .opencode/commands/performance-analysis.md -->
<!-- 来源: 生产环境实践案例 -->
<!-- 版本: v1.0.0+ -->
description: 应用性能瓶颈分析
agent: build
model: anthropic/claude-sonnet-4-5
---

执行全面的性能分析：

**前端性能：**
1. Bundle 大小分析
2. 加载时间优化
3. 渲染性能检测
4. 内存使用监控

**后端性能：**
1. API 响应时间
2. 数据库查询优化
3. 缓存命中率
4. 并发处理能力

**基础设施性能：**
1. 网络延迟分析
2. 服务器资源使用
3. 数据库连接池
4. 消息队列性能

生成性能报告和优化建议。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22

// 文件路径: .opencode/development.jsonc
// 来源: 配置最佳实践
// 版本: v1.0.0+

{
  "$schema": "https://opencode.ai/config.json",
  "model": "anthropic/claude-haiku-4-5",
  "theme": "github-dark",
  "permission": {
    "bash": "allow",
    "write": "allow",
    "edit": "allow"
  },
  "mcp": {
    "filesystem": {
      "enabled": true
    },
    "git": {
      "enabled": true
    }
  }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18

// 文件路径: .opencode/production.jsonc
// 来源: 配置最佳实践
// 版本: v1.0.0+

{
  "$schema": "https://opencode.ai/config.json",
  "model": "anthropic/claude-sonnet-4-5",
  "theme": "opencode",
  "permission": {
    "bash": "ask",
    "write": "ask",
    "edit": "ask"
  },
  "contextManagement": {
    "maxTokens": 16000,
    "compressionThreshold": 12000
  }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27

// 文件路径: .opencode/team.jsonc
// 来源: 团队协作实践
// 版本: v1.0.0+

{
  "$schema": "https://opencode.ai/config.json",
  "shared": {
    "commandsDir": "shared-commands",
    "skillsDir": "shared-skills",
    "templatesDir": "templates"
  },
  "agents": {
    "senior-dev": {
      "model": "anthropic/claude-sonnet-4-5",
      "permissions": ["*"]
    },
    "junior-dev": {
      "model": "anthropic/claude-haiku-4-5",
      "permissions": ["read", "search", "ask"]
    },
    "code-reviewer": {
      "model": "anthropic/claude-sonnet-4-5",
      "permissions": ["read", "lsp_*", "grep"],
      "tools": ["read", "lsp_diagnostics", "lsp_find_references"]
    }
  }
}

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33