从环境变量读取配置

openclaw 中文openclaw 2026-04-09 1

OpenClaw 是一个功能强大的自动化工具，与 Notion 集成后，可以实现数据的双向同步、自动化更新、内容生成等，大大提升效率。

从环境变量读取配置-第1张图片-OpenClaw下载中文-AI中文智能体

本教程将分为几个核心步骤：

准备工作与环境确认

确保 OpenClaw 已正确安装
- 打开终端或命令行。
- 运行 openclaw --version 或 python -c "import openclaw; print(openclaw.__version__)"，确认可以显示版本号。
- 如果出现“命令未找到”错误，请确保：
  - 激活了你安装 OpenClaw 的 Python 虚拟环境。
  - OpenClaw 的安装目录已添加到系统 PATH 中。
安装 Notion 官方 SDK
- OpenClaw 通常通过 notion-client（Notion 官方 Python SDK）与 Notion 交互。
- 在终端中运行：
```
pip install notion-client
```

获取 Notion 集成密钥和数据库 ID

这是最关键的一步。

创建 Notion 集成
- 访问 Notion Developers。
- 点击 “+ New integration”。
- 为你的集成命名,OpenClaw Bot。
- 选择关联的工作区。
- 根据你需要 OpenClaw 操作的权限，勾选相应的 Capabilities（如“Read content”，“Update content”，“Insert content”等），对于全功能，建议至少勾选“Read content”和“Update content”。
- 点击 Submit 创建。
- 创建成功后,页面会显示 “Internal Integration Token”，请立即复制并妥善保存这个令牌，它只会显示一次！这就是你的 NOTION_API_KEY。
获取目标数据库的 ID
- 打开你想让 OpenClaw 操作的 Notion 数据库页面。
- 数据库的 ID 隐藏在 URL 中：
  - https://www.notion.so/yourworkspace/xxxxxxxxxxxxxxxxxxxxxxxxxxxx?v=...
  - xxxxxxxxxxxxxxxxxxxxxxxxxxxx 这部分就是数据库 ID，注意，它是由 32 个字符组成的。
- 复制这个 ID。
将集成分享到数据库
- 在你的 Notion 数据库页面，点击右上角的菜单。
- 找到 “Connections” 选项。
- 在搜索框中,输入你刚刚创建的集成名称（如 OpenClaw Bot），然后添加它。
- 这一步至关重要！ 没有这一步，你的集成将无权访问该数据库。

配置 OpenClaw

OpenClaw 通常需要一个配置文件来存储密钥和设置，具体方式取决于 OpenClaw 的设计。

常见配置方式：

环境变量（推荐，更安全）

在终端中设置环境变量（Linux/macOS）：

export NOTION_API_KEY="你的secret_xxxx令牌"
export NOTION_DATABASE_ID="你的数据库ID"

在 Windows 命令提示符中：

set NOTION_API_KEY=你的secret_xxxx令牌
set NOTION_DATABASE_ID=你的数据库ID

或者在 Windows PowerShell 中：

$env:NOTION_API_KEY="你的secret_xxxx令牌"
$env:NOTION_DATABASE_ID="你的数据库ID"

注意： 这种方式是临时的，永久设置请添加到系统环境变量或使用 .env 文件。

配置文件（如 config.yaml 或 config.json）
- 在 OpenClaw 项目根目录或指定的配置目录下，创建一个配置文件。
- 示例 config.yaml：
```
notion:
  api_key: "secret_xxxx"
  database_id: "xxxxxxxxxxxxxxxxxxxxxxxxxxxx"
```
- 然后在你的 Python 代码中读取这个配置。

编写集成脚本或使用 OpenClaw 模块

现在你可以开始编写代码了,这里提供一个基础示例，展示如何使用 OpenClaw（假设它封装了相关功能）或直接使用 Notion SDK 进行基本操作。

示例 1：直接使用 Notion SDK 查询数据库

import os
from notion_client import Client
notion = Client(auth=os.environ["NOTION_API_KEY"])
database_id = os.environ["NOTION_DATABASE_ID"]
# 查询数据库
response = notion.databases.query(database_id=database_id)
for page in response["results"]:
    page_id = page["id"]
    # 获取页面属性，例如标题（假设属性名是‘Title’）
    properties = page["properties"]= properties.get("Title", {}).get("title", [{}])[0].get("text", {}).get("content", "无标题")
    print(f"页面ID: {page_id}, 标题: {title}")

示例 2：假设 OpenClaw 提供了 Notion 工具模块

from openclaw.tools.notion import NotionAgent
import os
# 初始化 Notion 代理
agent = NotionAgent(
    api_key=os.environ["NOTION_API_KEY"],
    database_id=os.environ["NOTION_DATABASE_ID"]
)
# 使用代理的方法（具体方法名需查看 OpenClaw 文档）
# 添加一个新条目
new_page = agent.create_page({
    "Name": {"title": [{"text": {"content": "从OpenClaw创建的新任务"}}]},
    "Status": {"select": {"name": "进行中"}},
    "Priority": {"select": {"name": "高"}}
})
print(f"已创建页面: {new_page['id']}")
# 根据条件查询
tasks = agent.query_database({
    "filter": {
        "property": "Status",
        "select": {
            "equals": "进行中"
        }
    }
})

实现自动化与高级功能

集成成功后,你可以将 OpenClaw 的 AI 能力与 Notion 结合，实现强大自动化：

内容自动摘要与归档：让 OpenClaw 定期读取特定数据库的新条目，生成摘要，并更新到另一个摘要数据库中。
智能分类与打标：根据页面内容，让 OpenClaw 的 AI 模型自动为其添加标签、分类或优先级。
从其他来源同步数据：结合 OpenClaw 的爬虫或 API 工具，从网页、RSS、第三方软件（如 GitHub Issues, Trello）获取信息，自动写入 Notion 数据库。
生成报告：定期查询数据库，用 OpenClaw 分析数据并生成结构化报告，创建为新的 Notion 页面。

常见问题与排查

错误：API token is invalid
- 检查 NOTION_API_KEY 是否复制完整，前后没有多余空格。
错误：object not found 或 unauthorized
- 确保你已经将创建的集成（OpenClaw Bot）分享（Share） 到了目标数据库页面。
- 检查数据库 ID 是否正确。
权限不足错误
回到集成设置页面,检查并赋予集成足够的 Capabilities 权限。
OpenClaw 模块不存在
- 请查阅 OpenClaw 的官方文档，确认其与 Notion 集成的具体模块名称和使用方式，本教程的 NotionAgent 仅为示例。