Moltbot 配置参考

本指南涵盖 Moltbot 的所有配置选项，包括配置文件、凭证和环境变量。

配置文件

主配置：~/.clawdbot/moltbot.json

这是你的主要配置文件。使用 JSON5 格式（允许注释和尾随逗号）。

{
  // 技能、提示词、记忆的工作空间
  "workspace": "~/clawd",

  // 默认 AI 模型
  "defaultModel": "claude-sonnet-4-20250514",

  // Gateway 设置
  "gateway": {
    "port": 18789,
    "host": "127.0.0.1"
  },

  // 渠道配置
  "channels": {
    "telegram": {
      "enabled": true,
      "tokenFile": "~/.clawdbot/credentials/telegram-token"
    },
    "discord": {
      "enabled": true
    },
    "whatsapp": {
      "enabled": true
    },
    "slack": {
      "enabled": false
    }
  },

  // 代理设置
  "agent": {
    "name": "Moltbot",
    "systemPrompt": "You are a helpful assistant."
  }
}

创建配置

运行以下命令时会自动创建配置文件：

moltbot setup

或手动创建：

mkdir -p ~/.clawdbot
cat > ~/.clawdbot/moltbot.json << 'EOF'
{
  "workspace": "~/clawd",
  "defaultModel": "claude-sonnet-4-20250514"
}
EOF

工作空间：~/clawd

你的工作空间包含更新时保留的自定义内容：

~/clawd/
├── skills/           # 自定义技能
│   └── my-skill.js
├── prompts/          # 自定义提示词
│   └── system.md
├── memories/         # 对话记忆
│   └── <agentId>/
└── config/           # 额外配置
    └── models.json

建议：将你的工作空间设为私有 git 仓库以备份和版本控制：

cd ~/clawd
git init
git remote add origin git@github.com:yourname/clawd-private.git

凭证存储

凭证位置

凭证	位置
WhatsApp 会话	`~/.clawdbot/credentials/whatsapp/<accountId>/creds.json`
Telegram 机器人令牌	`~/.clawdbot/credentials/telegram-token`
Discord 机器人令牌	配置/环境变量 (`DISCORD_BOT_TOKEN`)
Slack 令牌	配置/环境变量 (`SLACK_BOT_TOKEN`, `SLACK_APP_TOKEN`)
渠道允许列表	`~/.clawdbot/credentials/<channel>-allowFrom.json`
模型认证配置	`~/.clawdbot/agents/<agentId>/agent/auth-profiles.json`

认证配置

AI 模型认证，创建 ~/.clawdbot/agents/{agentId}/agent/auth-profiles.json：

{
  "anthropic": {
    "apiKey": "sk-ant-..."
  },
  "openai": {
    "apiKey": "sk-..."
  }
}

或使用环境变量（更安全）。

环境变量

环境变量会覆盖配置文件设置。

核心设置

变量	环境变量会覆盖配置文件设置。	默认值
`NODE_ENV`	环境模式	`development`
`LOG_LEVEL`	日志详细级别	`info`
`GATEWAY_PORT`	Gateway WebSocket 端口	`18789`
`GATEWAY_HOST`	Gateway 绑定地址	`127.0.0.1`

AI 提供商密钥

变量	环境变量会覆盖配置文件设置。
`ANTHROPIC_API_KEY`	Anthropic (Claude) API 密钥
`OPENAI_API_KEY`	OpenAI API 密钥
`GOOGLE_API_KEY`	Google AI API 密钥

渠道令牌

变量	环境变量会覆盖配置文件设置。
`TELEGRAM_BOT_TOKEN`	Telegram 机器人令牌
`DISCORD_BOT_TOKEN`	Discord 机器人令牌
`DISCORD_APPLICATION_ID`	Discord 应用 ID
`SLACK_BOT_TOKEN`	Slack 机器人 OAuth 令牌
`SLACK_APP_TOKEN`	Slack 应用级令牌

示例 .env 文件

# Environment
NODE_ENV=production
LOG_LEVEL=info

# Gateway
GATEWAY_PORT=18789

# AI Providers
ANTHROPIC_API_KEY=sk-ant-api03-...
OPENAI_API_KEY=sk-...

# Channels
TELEGRAM_BOT_TOKEN=123456789:ABCdefGHI...
DISCORD_BOT_TOKEN=MTIzNDU2Nzg5...
DISCORD_APPLICATION_ID=123456789012345678

安全提示： 切勿将 .env 文件提交到版本控制。将 .env 添加到 .gitignore。

Gateway 配置

端口设置

默认 WebSocket: ws://127.0.0.1:18789

通过配置更改：

{
  "gateway": {
    "port": 18790,
    "host": "0.0.0.0"
  }
}

或环境变量：

GATEWAY_PORT=18790 moltbot gateway

重要提示：保持 macOS 应用、CLI 和 Gateway 都使用相同端口！

Gateway 参数

直接运行 Gateway 时：

# 指定端口
moltbot gateway --port 18790

# 指定配置文件
moltbot gateway --config /path/to/config.json

# 调试模式
DEBUG=moltbot:* moltbot gateway

渠道配置

{
  "channels": {
    "telegram": {
      "enabled": true,
      "tokenFile": "~/.clawdbot/credentials/telegram-token",
      "replyToMode": "thread",
      "allowedChats": [123456789, -987654321]
    }
  }
}

Discord

{
  "channels": {
    "discord": {
      "enabled": true,
      "replyToMode": "thread",
      "allowedGuilds": ["123456789"],
      "allowedChannels": ["987654321"]
    }
  }
}

{
  "channels": {
    "whatsapp": {
      "enabled": true,
      "allowFrom": "~/.clawdbot/credentials/whatsapp-allowFrom.json"
    }
  }
}

允许列表文件格式：

{
  "numbers": ["+1234567890"],
  "groups": ["Family Group"]
}

Slack

{
  "channels": {
    "slack": {
      "enabled": true,
      "botToken": "xoxb-...",
      "appToken": "xapp-...",
      "allowedChannels": ["C123456"]
    }
  }
}

代理配置

{
  "agent": {
    "name": "Moltbot",
    "systemPrompt": "You are a helpful AI assistant.",
    "defaultModel": "claude-sonnet-4-20250514",
    "maxTokens": 4096,
    "temperature": 0.7
  }
}

选项	说明	默认值
`name`	代理显示名称	`Moltbot`
`systemPrompt`	基础系统提示词	内置
`defaultModel`	使用的 AI 模型	`claude-sonnet-4-20250514`
`maxTokens`	最大响应令牌数	`4096`
`temperature`	响应随机性	`0.7`

状态和日志

会话存储

活动会话存储在：

~/.clawdbot/agents/<agentId>/sessions/

日志文件

日志写入：

/tmp/moltbot/
├── gateway.log
├── error.log
└── <channel>.log

或通过 journalctl 查看（Linux）：

journalctl --user -u moltbot -f

配置优先级

设置按以下顺序加载（后者覆盖前者）：

内置默认值
~/.clawdbot/moltbot.json
环境变量
命令行参数

验证配置

检查配置错误：

moltbot config validate

查看生效的配置：

moltbot config show

备份建议

需要备份的内容：

路径	内容	优先级
`~/.clawdbot/moltbot.json`	主配置	高
`~/.clawdbot/credentials/`	所有凭证	高
`~/clawd/`	工作空间	高
`~/.clawdbot/agents/`	会话、记忆	中

简单备份脚本：

#!/bin/bash
tar -czf moltbot-backup-$(date +%Y%m%d).tar.gz \
  ~/.clawdbot \
  ~/clawd

下一步

渠道接入

连接消息平台

查看指南

安全指南

保护你的凭证

查看指南

Gateway 运维手册

高级 Gateway 操作

查看指南

Moltbot 配置参考

配置文件

主配置：~/.clawdbot/moltbot.json

创建配置

工作空间：~/clawd

凭证存储

凭证位置

认证配置

环境变量

核心设置

AI 提供商密钥

渠道令牌

示例 .env 文件

Gateway 配置

端口设置

Gateway 参数

渠道配置

Telegram

Discord

WhatsApp

Slack

代理配置

状态和日志

会话存储

日志文件

配置优先级

验证配置

备份建议

下一步

渠道接入

安全指南

Gateway 运维手册

相关内容