OmicClaw Telegram 教程

OmicClaw Telegram 教程#

Telegram 现在作为 gateway 支持的通道进行文档说明，不再作为独立的旧版 Jarvis 入口。

1. 创建 Telegram Bot#

  1. 在 Telegram 中打开 @BotFather。

  2. 发送 /newbot。

  3. 提供显示名称和用户名。

  4. 将返回的 token 保存为 TELEGRAM_BOT_TOKEN。

2. 环境变量#

export TELEGRAM_BOT_TOKEN="123456:ABC-..."
export ANTHROPIC_API_KEY="your_api_key"

3. 推荐启动命令#

OmicClaw 品牌入口：

omicclaw --channel telegram --token "$TELEGRAM_BOT_TOKEN"

通用 gateway 入口：

omicverse gateway --channel telegram --token "$TELEGRAM_BOT_TOKEN"

4. 完整启动命令#

omicclaw \
  --channel telegram \
  --token "$TELEGRAM_BOT_TOKEN" \
  --model claude-sonnet-4-6 \
  --api-key "$ANTHROPIC_API_KEY" \
  --auth-mode environment \
  --session-dir ~/.ovjarvis \
  --max-prompts 0 \
  --allowed-user your_telegram_username \
  --allowed-user 123456789 \
  --web-port 5050 \
  --verbose

5. 当前行为说明#

  • 通过 omicclaw 或 omicverse gateway 启动时，同时会启动 web gateway。

  • 若仅需代码生成，请勿使用此路径；请使用 omicverse claw -q ...。

6. 常用命令#

  • /workspace

  • /load <filename>

  • /save

  • /status

  • /kernel

  • /kernel ls

  • /kernel new <name>

  • /kernel use <name>

  • /cancel

  • /reset

7. 故障排查#

  1. 缺少 Telegram 依赖 运行 pip install -e ".[jarvis]" 或 pip install "omicverse[jarvis]"。

  2. 缺少 token 错误 检查 TELEGRAM_BOT_TOKEN 或 --token。

  3. 409 Conflict 停止使用相同 bot token 的其他进程。

目录