ClawdBot：构建你的个人 AI 助手 (2026)

ClawdBot：构建您的个人 AI 助手 (2026)

ClawdBot 是一个开源的个人 AI 助手框架，旨在为您日常工作流构建一个可定制、全天候在线的 AI 伙伴。无论您是需要管理任务、总结文档、编写代码，还是自动化重复性工作，ClawdBot 都能为您提供构建模块，打造量身定制的助手。

本指南将带您从零开始设置 ClawdBot，自定义其行为，并将其连接到您常用的工具和服务。

什么是 ClawdBot？

ClawdBot 是一个基于大语言模型构建的模块化 AI 助手框架。不同于通用的聊天机器人，ClawdBot 专为私有化部署、隐私保护和深度自定义而设计。您可以定义它的性格、能力和集成插件。

核心功能

功能	描述
多模型支持	通过 Ollama 连接到 Claude、GPT、Gemini 或本地模型
插件系统	使用官方和社区插件扩展功能
记忆管理	具有可配置保留期的持久对话记忆
工具调用 (Tool calling)	执行 Shell 命令、API 调用和文件操作
多渠道支持	部署到 Discord、Slack、Telegram 或通过 CLI 使用
隐私优先	私有化部署，完全掌控您的数据

前提条件

在开始之前，请确保您已准备好：

已安装 Node.js 20+
npm 或 pnpm 包管理器
至少一个 LLM 提供商的 API 密钥（Anthropic、OpenAI 或通过 Ollama 运行的本地模型）
您熟悉的终端操作环境

第 1 步：安装 ClawdBot

克隆仓库并安装依赖：

git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot
pnpm install

复制示例环境变量文件：

cp .env.example .env

第 2 步：配置您的 LLM 提供商

打开 .env 文件并添加您的 API 凭证。ClawdBot 支持同时配置多个提供商，您可以根据需要进行配置。

# 主要提供商
ANTHROPIC_API_KEY=sk-ant-your-key-here
DEFAULT_MODEL=claude-sonnet-4-20250514

# 可选：次要提供商
OPENAI_API_KEY=sk-your-openai-key
OLLAMA_BASE_URL=http://localhost:11434

提供商对比

提供商	最适合	成本	延迟
Anthropic Claude	复杂推理、编程	$3-15/M tokens	低
OpenAI GPT-5	通用任务、视觉	$2-30/M tokens	低
Google Gemini	长上下文、多模态	$1-7/M tokens	中
Ollama (本地)	隐私、离线使用	免费 (硬件成本)	视情况而定

第 3 步：定义助手的性格

ClawdBot 使用配置文件来定义助手的行为。创建或编辑 config/persona.yaml：

name: "Atlas"
personality:
  tone: professional
  verbosity: concise
  humor: subtle
instructions: |
  你是 Atlas，一个个人生产力助手。
  始终优先提供可操作的建议，而非理论。
  当被问及任务时，请先检查任务列表。
  在有帮助的情况下，使用 Markdown 格式化回复。
capabilities:
  - task_management
  - code_review
  - document_summary
  - web_search
  - calendar_integration

您可以创建多个性格文件并在它们之间切换：

clawdbot --persona config/persona-coding.yaml
clawdbot --persona config/persona-writing.yaml

第 4 步：添加插件

插件可以扩展 ClawdBot 的能力。通过插件注册表安装它们：

# 任务管理插件
clawdbot plugin add @clawdbot/tasks

# 网页搜索插件
clawdbot plugin add @clawdbot/web-search

# 日历集成
clawdbot plugin add @clawdbot/google-calendar

# 代码执行沙盒
clawdbot plugin add @clawdbot/code-runner

每个插件都在 config/plugins.yaml 中进行配置：

plugins:
  tasks:
    storage: sqlite
    db_path: ./data/tasks.db
  web-search:
    provider: tavily
    api_key: ${TAVILY_API_KEY}
  google-calendar:
    credentials_path: ./config/google-credentials.json
  code-runner:
    languages: [python, javascript, bash]
    timeout: 30s
    sandbox: docker

第 5 步：设置记忆与上下文

ClawdBot 可以记住之前的对话并在未来的交互中引用它们。在 config/memory.yaml 中配置记忆：

memory:
  enabled: true
  backend: sqlite
  db_path: ./data/memory.db
  retention:
    conversations: 90d
    facts: permanent
    preferences: permanent
  context_window:
    max_messages: 50
    summary_threshold: 30

当对话超过摘要阈值时，ClawdBot 会自动总结旧消息，以便在保持在 Token 限制内的同时保留上下文。

第 6 步：部署到渠道

CLI 模式 (默认)

在终端中启动 ClawdBot：

clawdbot start

现在您可以直接在终端中聊天：

You: 总结我今天的任务
Atlas: 以下是您今天待办的 3 项任务：
  1. 审查 PR #142 - 前端重构 (下午 2 点截止)
  2. 为 /users 接口编写 API 文档
  3. 为周四的站会准备幻灯片

Discord 机器人

将 Discord 凭证添加到您的 .env：

DISCORD_BOT_TOKEN=your-discord-bot-token
DISCORD_CHANNEL_ID=123456789

以 Discord 模式启动：

clawdbot start --channel discord

Slack 机器人

SLACK_BOT_TOKEN=xoxb-your-slack-bot-token
SLACK_SIGNING_SECRET=your-signing-secret

clawdbot start --channel slack

第 7 步：创建自定义工具

您可以定义自定义工具，供 ClawdBot 在对话中调用。在 tools/ 中创建一个工具文件：

// tools/check-website-status.ts
import { defineTool } from '@clawdbot/sdk';

export default defineTool({
  name: 'check_website_status',
  description: '检查网站是否在线并返回其 HTTP 状态码',
  parameters: {
    url: {
      type: 'string',
      description: '要检查的 URL',
      required: true,
    },
  },
  async execute({ url }) {
    const response = await fetch(url, { method: 'HEAD' });
    return {
      url,
      status: response.status,
      ok: response.ok,
      latency: response.headers.get('x-response-time'),
    };
  },
});

在配置中注册该工具：

tools:
  custom:
    - ./tools/check-website-status.ts
    - ./tools/deploy-preview.ts

实用自动化示例

每日简报

设置 Cron 任务以获取每日简报：

# crontab 条目 - 每天早上 8 点运行
0 8 * * * clawdbot run "给我一份晨间简报：今天的日历、待办任务和天气总结" --output ./briefing.md

PR 审查自动化

# 在您的 CI 流水线中
gh pr diff $PR_NUMBER | clawdbot run "审查此 Pull Request 的差异。标出潜在的 Bug、安全问题和代码风格问题。请简明扼要。"

文档总结流

# 总结文件夹中的所有 PDF
for file in ./documents/*.pdf; do
  clawdbot run "用 3 条要点总结此文档" --attach "$file" >> summaries.md
done

故障排除

问题	解决方案
"API key not found"	验证您的 `.env` 文件密钥是否正确且变量名匹配
记忆数据库被锁定	停止所有 ClawdBot 实例，然后重新启动
插件加载失败	运行 `clawdbot plugin update` 并检查版本兼容性
响应缓慢	切换到更快的模型，或针对简单任务使用本地 Ollama 模型
上下文过长	减小记忆配置中的 `max_messages` 或启用自动总结

充分利用 ClawdBot 的建议

性格指令要具体。 您对助理行为方式提供的上下文越多，效果就越好。
使用多个性格文件。 为编程、写作和个人事务分别建立配置。
利用工具链。 ClawdBot 可以按顺序调用多个工具来完成复杂任务。
定期回顾记忆。 检查 ClawdBot 存储了哪些事实，并纠正任何过时的信息。
从 CLI 模式开始。 在部署到 Discord 或 Slack 之前，先熟悉基本操作。

结论

ClawdBot 让您可以灵活地构建符合您精确工作流的 AI 助手。从简单的任务管理到复杂的跨工具自动化，其模块化架构意味着您可以从简入繁，随着需求的增长不断扩展。

如果您正在开发 AI 驱动的项目，并需要可靠的基础设施来进行图像生成、视频创建或其他媒体任务，Hypereal AI 提供了可与 ClawdBot 等工具无缝集成的生产级 API。欢迎尝试，为您自己的个人助手增添强大的媒体生成能力。

ClawdBot：构建您的个人 AI 助手 (2026)

本指南将带您从零开始设置 ClawdBot，自定义其行为，并将其连接到您常用的工具和服务。

什么是 ClawdBot？

核心功能

功能	描述
多模型支持	通过 Ollama 连接到 Claude、GPT、Gemini 或本地模型
插件系统	使用官方和社区插件扩展功能
记忆管理	具有可配置保留期的持久对话记忆
工具调用 (Tool calling)	执行 Shell 命令、API 调用和文件操作
多渠道支持	部署到 Discord、Slack、Telegram 或通过 CLI 使用
隐私优先	私有化部署，完全掌控您的数据

前提条件

在开始之前，请确保您已准备好：

已安装 Node.js 20+
npm 或 pnpm 包管理器
至少一个 LLM 提供商的 API 密钥（Anthropic、OpenAI 或通过 Ollama 运行的本地模型）
您熟悉的终端操作环境

第 1 步：安装 ClawdBot

克隆仓库并安装依赖：

git clone https://github.com/clawdbot/clawdbot.git
cd clawdbot
pnpm install

复制示例环境变量文件：

cp .env.example .env

第 2 步：配置您的 LLM 提供商

打开 .env 文件并添加您的 API 凭证。ClawdBot 支持同时配置多个提供商，您可以根据需要进行配置。

# 主要提供商
ANTHROPIC_API_KEY=sk-ant-your-key-here
DEFAULT_MODEL=claude-sonnet-4-20250514

# 可选：次要提供商
OPENAI_API_KEY=sk-your-openai-key
OLLAMA_BASE_URL=http://localhost:11434

提供商对比

提供商	最适合	成本	延迟
Anthropic Claude	复杂推理、编程	$3-15/M tokens	低
OpenAI GPT-5	通用任务、视觉	$2-30/M tokens	低
Google Gemini	长上下文、多模态	$1-7/M tokens	中
Ollama (本地)	隐私、离线使用	免费 (硬件成本)	视情况而定

第 3 步：定义助手的性格

ClawdBot 使用配置文件来定义助手的行为。创建或编辑 config/persona.yaml：

name: "Atlas"
personality:
  tone: professional
  verbosity: concise
  humor: subtle
instructions: |
  你是 Atlas，一个个人生产力助手。
  始终优先提供可操作的建议，而非理论。
  当被问及任务时，请先检查任务列表。
  在有帮助的情况下，使用 Markdown 格式化回复。
capabilities:
  - task_management
  - code_review
  - document_summary
  - web_search
  - calendar_integration

您可以创建多个性格文件并在它们之间切换：

clawdbot --persona config/persona-coding.yaml
clawdbot --persona config/persona-writing.yaml

第 4 步：添加插件

插件可以扩展 ClawdBot 的能力。通过插件注册表安装它们：

# 任务管理插件
clawdbot plugin add @clawdbot/tasks

# 网页搜索插件
clawdbot plugin add @clawdbot/web-search

# 日历集成
clawdbot plugin add @clawdbot/google-calendar

# 代码执行沙盒
clawdbot plugin add @clawdbot/code-runner

每个插件都在 config/plugins.yaml 中进行配置：

plugins:
  tasks:
    storage: sqlite
    db_path: ./data/tasks.db
  web-search:
    provider: tavily
    api_key: ${TAVILY_API_KEY}
  google-calendar:
    credentials_path: ./config/google-credentials.json
  code-runner:
    languages: [python, javascript, bash]
    timeout: 30s
    sandbox: docker

第 5 步：设置记忆与上下文

ClawdBot 可以记住之前的对话并在未来的交互中引用它们。在 config/memory.yaml 中配置记忆：

memory:
  enabled: true
  backend: sqlite
  db_path: ./data/memory.db
  retention:
    conversations: 90d
    facts: permanent
    preferences: permanent
  context_window:
    max_messages: 50
    summary_threshold: 30

当对话超过摘要阈值时，ClawdBot 会自动总结旧消息，以便在保持在 Token 限制内的同时保留上下文。

第 6 步：部署到渠道

CLI 模式 (默认)

在终端中启动 ClawdBot：

clawdbot start

现在您可以直接在终端中聊天：

You: 总结我今天的任务
Atlas: 以下是您今天待办的 3 项任务：
  1. 审查 PR #142 - 前端重构 (下午 2 点截止)
  2. 为 /users 接口编写 API 文档
  3. 为周四的站会准备幻灯片

Discord 机器人

将 Discord 凭证添加到您的 .env：

DISCORD_BOT_TOKEN=your-discord-bot-token
DISCORD_CHANNEL_ID=123456789

以 Discord 模式启动：

clawdbot start --channel discord

Slack 机器人

SLACK_BOT_TOKEN=xoxb-your-slack-bot-token
SLACK_SIGNING_SECRET=your-signing-secret

clawdbot start --channel slack

第 7 步：创建自定义工具

您可以定义自定义工具，供 ClawdBot 在对话中调用。在 tools/ 中创建一个工具文件：

// tools/check-website-status.ts
import { defineTool } from '@clawdbot/sdk';

export default defineTool({
  name: 'check_website_status',
  description: '检查网站是否在线并返回其 HTTP 状态码',
  parameters: {
    url: {
      type: 'string',
      description: '要检查的 URL',
      required: true,
    },
  },
  async execute({ url }) {
    const response = await fetch(url, { method: 'HEAD' });
    return {
      url,
      status: response.status,
      ok: response.ok,
      latency: response.headers.get('x-response-time'),
    };
  },
});

在配置中注册该工具：

tools:
  custom:
    - ./tools/check-website-status.ts
    - ./tools/deploy-preview.ts

实用自动化示例

每日简报

设置 Cron 任务以获取每日简报：

# crontab 条目 - 每天早上 8 点运行
0 8 * * * clawdbot run "给我一份晨间简报：今天的日历、待办任务和天气总结" --output ./briefing.md

PR 审查自动化

# 在您的 CI 流水线中
gh pr diff $PR_NUMBER | clawdbot run "审查此 Pull Request 的差异。标出潜在的 Bug、安全问题和代码风格问题。请简明扼要。"

文档总结流

# 总结文件夹中的所有 PDF
for file in ./documents/*.pdf; do
  clawdbot run "用 3 条要点总结此文档" --attach "$file" >> summaries.md
done

故障排除

问题	解决方案
"API key not found"	验证您的 `.env` 文件密钥是否正确且变量名匹配
记忆数据库被锁定	停止所有 ClawdBot 实例，然后重新启动
插件加载失败	运行 `clawdbot plugin update` 并检查版本兼容性
响应缓慢	切换到更快的模型，或针对简单任务使用本地 Ollama 模型
上下文过长	减小记忆配置中的 `max_messages` 或启用自动总结

充分利用 ClawdBot 的建议

性格指令要具体。 您对助理行为方式提供的上下文越多，效果就越好。
使用多个性格文件。 为编程、写作和个人事务分别建立配置。
利用工具链。 ClawdBot 可以按顺序调用多个工具来完成复杂任务。
定期回顾记忆。 检查 ClawdBot 存储了哪些事实，并纠正任何过时的信息。
从 CLI 模式开始。 在部署到 Discord 或 Slack 之前，先熟悉基本操作。

开始使用 Hypereal 构建

ClawdBot：构建您的个人 AI 助手 (2026)

什么是 ClawdBot？

核心功能

前提条件

第 1 步：安装 ClawdBot

第 2 步：配置您的 LLM 提供商

提供商对比

第 3 步：定义助手的性格

第 4 步：添加插件

第 5 步：设置记忆与上下文

第 6 步：部署到渠道

CLI 模式 (默认)

Discord 机器人

Slack 机器人

第 7 步：创建自定义工具

实用自动化示例

每日简报

PR 审查自动化

文档总结流

故障排除

充分利用 ClawdBot 的建议

结论

相关文章

Telegram Bot API 初学者指南 (2026)

2026 年最佳开源 RAG 框架

如何从零开始构建 MCP Server (2026)

立即开始构建

开始使用 Hypereal 构建

ClawdBot：构建您的个人 AI 助手 (2026)

什么是 ClawdBot？

核心功能

前提条件

第 1 步：安装 ClawdBot

第 2 步：配置您的 LLM 提供商

提供商对比

第 3 步：定义助手的性格

第 4 步：添加插件

第 5 步：设置记忆与上下文

第 6 步：部署到渠道

CLI 模式 (默认)

Discord 机器人

Slack 机器人

第 7 步：创建自定义工具

实用自动化示例

每日简报

PR 审查自动化

文档总结流

故障排除

充分利用 ClawdBot 的建议

结论

相关文章

Telegram Bot API 初学者指南 (2026)

2026 年最佳开源 RAG 框架

如何从零开始构建 MCP Server (2026)

立即开始构建